Microsoft.Insights dataCollectionRules 2023-03-11
Bicep 리소스 정의
dataCollectionRules 리소스 형식은 다음을 대상으로 하는 작업으로 배포할 수 있습니다.
- 리소스 그룹 - 리소스 그룹 배포 명령 참조
각 API 버전에서 변경된 속성 목록은 변경 로그참조하세요.
리소스 형식
Microsoft.Insights/dataCollectionRules 리소스를 만들려면 템플릿에 다음 Bicep을 추가합니다.
resource symbolicname 'Microsoft.Insights/dataCollectionRules@2023-03-11' = {
name: 'string'
location: 'string'
tags: {
tagName1: 'tagValue1'
tagName2: 'tagValue2'
}
kind: 'string'
identity: {
type: 'string'
userAssignedIdentities: {
{customized property}: {}
}
}
properties: {
agentSettings: {
logs: [
{
name: 'string'
value: 'string'
}
]
}
dataCollectionEndpointId: 'string'
dataFlows: [
{
builtInTransform: 'string'
captureOverflow: bool
destinations: [
'string'
]
outputStream: 'string'
streams: [
'string'
]
transformKql: 'string'
}
]
dataSources: {
dataImports: {
eventHub: {
consumerGroup: 'string'
name: 'string'
stream: 'string'
}
}
extensions: [
{
extensionName: 'string'
extensionSettings: any()
inputDataSources: [
'string'
]
name: 'string'
streams: [
'string'
]
}
]
iisLogs: [
{
logDirectories: [
'string'
]
name: 'string'
streams: [
'string'
]
transformKql: 'string'
}
]
logFiles: [
{
filePatterns: [
'string'
]
format: 'string'
name: 'string'
settings: {
text: {
recordStartTimestampFormat: 'string'
}
}
streams: [
'string'
]
transformKql: 'string'
}
]
performanceCounters: [
{
counterSpecifiers: [
'string'
]
name: 'string'
samplingFrequencyInSeconds: int
streams: [
'string'
]
transformKql: 'string'
}
]
platformTelemetry: [
{
name: 'string'
streams: [
'string'
]
}
]
prometheusForwarder: [
{
labelIncludeFilter: {
{customized property}: 'string'
}
name: 'string'
streams: 'Microsoft-PrometheusMetrics'
}
]
syslog: [
{
facilityNames: [
'string'
]
logLevels: [
'string'
]
name: 'string'
streams: 'Microsoft-Syslog'
transformKql: 'string'
}
]
windowsEventLogs: [
{
name: 'string'
streams: [
'string'
]
transformKql: 'string'
xPathQueries: [
'string'
]
}
]
windowsFirewallLogs: [
{
name: 'string'
profileFilter: [
'string'
]
streams: [
'string'
]
}
]
}
description: 'string'
destinations: {
azureDataExplorer: [
{
databaseName: 'string'
name: 'string'
resourceId: 'string'
}
]
azureMonitorMetrics: {
name: 'string'
}
eventHubs: [
{
eventHubResourceId: 'string'
name: 'string'
}
]
eventHubsDirect: [
{
eventHubResourceId: 'string'
name: 'string'
}
]
logAnalytics: [
{
name: 'string'
workspaceResourceId: 'string'
}
]
microsoftFabric: [
{
artifactId: 'string'
databaseName: 'string'
ingestionUri: 'string'
name: 'string'
tenantId: 'string'
}
]
monitoringAccounts: [
{
accountResourceId: 'string'
name: 'string'
}
]
storageAccounts: [
{
containerName: 'string'
name: 'string'
storageAccountResourceId: 'string'
}
]
storageBlobsDirect: [
{
containerName: 'string'
name: 'string'
storageAccountResourceId: 'string'
}
]
storageTablesDirect: [
{
name: 'string'
storageAccountResourceId: 'string'
tableName: 'string'
}
]
}
references: {
enrichmentData: {
storageBlobs: [
{
blobUrl: 'string'
lookupType: 'string'
name: 'string'
resourceId: 'string'
}
]
}
}
streamDeclarations: {
{customized property}: {
columns: [
{
name: 'string'
type: 'string'
}
]
}
}
}
}
속성 값
dataCollectionRules
이름 | 묘사 | 값 |
---|---|---|
이름 | 리소스 이름 | string(필수) |
위치 | 리소스가 있는 지리적 위치입니다. | string(필수) |
태그 | 리소스 태그. | 태그 이름 및 값의 사전입니다. 템플릿 |
종류 | 리소스의 종류입니다. | 'Linux' 'Windows' |
신원 | 리소스의 관리 서비스 ID입니다. | DataCollectionRuleResourceIdentity |
속성 | 리소스 속성입니다. | DataCollectionRuleResourceProperties |
DataCollectionRuleResourceIdentity
이름 | 묘사 | 값 |
---|---|---|
형 | 관리 서비스 ID의 유형입니다(SystemAssigned 및 UserAssigned 형식이 모두 허용되는 경우). | 'None' 'SystemAssigned' 'SystemAssigned,UserAssigned' 'UserAssigned'(필수) |
userAssignedIdentities | 리소스와 연결된 사용자 할당 ID 집합입니다. userAssignedIdentities 사전 키는 '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} 형식의 ARM 리소스 ID입니다. 사전 값은 요청에서 빈 개체({})일 수 있습니다. | UserAssignedIdentities |
UserAssignedIdentities
이름 | 묘사 | 값 |
---|---|---|
{customized property} | UserAssignedIdentity |
UserAssignedIdentity
이 개체에는 배포 중에 설정할 속성이 없습니다. 모든 속성은 ReadOnly입니다.
DataCollectionRuleResourceProperties
이름 | 묘사 | 값 |
---|---|---|
agentSettings | 지정된 호스트에서 에이전트 동작을 수정하는 데 사용되는 에이전트 설정 | DataCollectionRuleAgentSettings |
dataCollectionEndpointId | 이 규칙을 사용할 수 있는 데이터 컬렉션 엔드포인트의 리소스 ID입니다. | 문자열 |
dataFlows | 데이터 흐름의 사양입니다. | DataFlow[] |
dataSources | 데이터 원본의 사양입니다. 이 속성은 선택 사항이며 프로비전된 엔드포인트에 대한 직접 호출을 통해 규칙을 사용하는 경우 생략할 수 있습니다. |
dataCollectionRuleDataSources |
묘사 | 데이터 수집 규칙에 대한 설명입니다. | 문자열 |
목적지 | 대상의 사양입니다. | DataCollectionRuleDestinations |
참조 | DCR의 다른 섹션에서 사용할 수 있는 모든 참조를 정의합니다. | DataCollectionRuleReferences |
streamDeclarations | 이 규칙에 사용되는 사용자 지정 스트림의 선언입니다. | DataCollectionRuleStreamDeclarations |
DataCollectionRuleAgentSettings
이름 | 묘사 | 값 |
---|---|---|
로그 | 로그 에이전트에 적용할 수 있는 모든 설정(AMA) | AgentSetting[] |
AgentSetting
이름 | 묘사 | 값 |
---|---|---|
이름 | 설정의 이름입니다. 지원되는 설정 목록의 일부여야 합니다. |
'MaxDiskQuotaInMB' 'UseTimeReceivedForForwardedEvents' |
값 | 설정의 값입니다. | 문자열 |
DataFlow
이름 | 묘사 | 값 |
---|---|---|
builtInTransform | 스트림 데이터를 변환하는 builtIn 변환 | 문자열 |
captureOverflow | LA 대상에서 오버플로 열을 사용하도록 설정하는 플래그 | bool |
목적지 | 이 데이터 흐름의 대상 목록입니다. | string[] |
outputStream | 변환의 출력 스트림입니다. 변환이 데이터를 다른 스트림으로 변경하는 경우에만 필요합니다. | 문자열 |
스트림 | 이 데이터 흐름에 대한 스트림 목록입니다. | 다음 중 어느 것을 포함하는 문자열 배열: 'Microsoft-Event' 'Microsoft-InsightsMetrics' 'Microsoft-Perf' 'Microsoft-Syslog' 'Microsoft-WindowsEvent' |
transformKql | 스트림 데이터를 변환하는 KQL 쿼리입니다. | 문자열 |
DataCollectionRuleDataSources
이름 | 묘사 | 값 |
---|---|---|
dataImports | 끌어오기 기반 데이터 원본 사양 | DataSourcesSpecDataImports |
확장 | Azure VM 확장 데이터 원본 구성 목록입니다. | ExtensionDataSource[] |
iisLogs | IIS 로그 원본 구성의 목록입니다. | IisLogsDataSource[] |
logFiles | 로그 파일 원본 구성 목록입니다. | LogFilesDataSource |
performanceCounters | 성능 카운터 데이터 원본 구성 목록입니다. | PerfCounterDataSource[] |
platformTelemetry | 플랫폼 원격 분석 구성 목록 | platformTelemetryDataSource |
prometheusForwarder | Prometheus 전달자 데이터 원본 구성 목록입니다. | PrometheusForwarderDataSource[] |
syslog | Syslog 데이터 원본 구성 목록입니다. | SyslogDataSource[] |
windowsEventLogs | Windows 이벤트 로그 데이터 원본 구성 목록입니다. | WindowsEventLogDataSource |
windowsFirewallLogs | Windows 방화벽 로그 원본 구성의 목록입니다. | windowsFirewallLogsDataSource |
DataSourcesSpecDataImports
이름 | 묘사 | 값 |
---|---|---|
eventHub | Event Hub 구성의 정의입니다. | DataImportSourcesEventHub |
DataImportSourcesEventHub
이름 | 묘사 | 값 |
---|---|---|
consumerGroup | Event Hub 소비자 그룹 이름 | 문자열 |
이름 | 데이터 원본의 이름입니다. 이 이름은 데이터 수집 규칙 내의 모든 데이터 원본(형식에 관계없이)에서 고유해야 합니다. |
문자열 |
시내 | EventHub에서 수집할 스트림 | 문자열 |
ExtensionDataSource
이름 | 묘사 | 값 |
---|---|---|
extensionName | VM 확장의 이름입니다. | string(필수) |
extensionSettings | 확장 설정입니다. 형식은 특정 확장에 특정합니다. | Bicep의 경우 any() 함수를 사용할 수 있습니다. |
inputDataSources | 이 확장에 데이터가 필요한 데이터 원본 목록입니다. | string[] |
이름 | 데이터 원본의 이름입니다. 이 이름은 데이터 수집 규칙 내의 모든 데이터 원본(형식에 관계없이)에서 고유해야 합니다. |
문자열 |
스트림 | 이 데이터 원본을 보낼 스트림 목록입니다. 스트림은 이 데이터에 사용할 스키마와 일반적으로 데이터가 전송될 Log Analytics의 테이블을 나타냅니다. |
다음 중 어느 것을 포함하는 문자열 배열: 'Microsoft-Event' 'Microsoft-InsightsMetrics' 'Microsoft-Perf' 'Microsoft-Syslog' 'Microsoft-WindowsEvent' |
IisLogsDataSource
이름 | 묘사 | 값 |
---|---|---|
logDirectories | 절대 경로 파일 위치 | string[] |
이름 | 데이터 원본의 이름입니다. 이 이름은 데이터 수집 규칙 내의 모든 데이터 원본(형식에 관계없이)에서 고유해야 합니다. |
문자열 |
스트림 | IIS 스트림 | string[] (필수) |
transformKql | 데이터 원본을 변환하는 KQL 쿼리입니다. | 문자열 |
LogFilesDataSource
이름 | 묘사 | 값 |
---|---|---|
filePatterns | 로그 파일이 있는 파일 패턴 | string[] (필수) |
판 | 로그 파일의 데이터 형식 | 'json' 'text'(필수) |
이름 | 데이터 원본의 이름입니다. 이 이름은 데이터 수집 규칙 내의 모든 데이터 원본(형식에 관계없이)에서 고유해야 합니다. |
문자열 |
설정 | 로그 파일 관련 설정입니다. | logFilesDataSourceSettings |
스트림 | 이 데이터 원본을 보낼 스트림 목록입니다. 스트림은 이 데이터 원본에 사용할 스키마를 나타냅니다. |
string[] (필수) |
transformKql | 데이터 원본을 변환하는 KQL 쿼리입니다. | 문자열 |
LogFilesDataSourceSettings
이름 | 묘사 | 값 |
---|---|---|
문자 메시지 | 텍스트 설정 | LogFileSettingsText |
LogFileSettingsText
이름 | 묘사 | 값 |
---|---|---|
recordStartTimestampFormat | 지원되는 타임스탬프 형식 중 하나 | 'ISO 8601' 'M/D/YYYY HH:MM:SS AM/PM' 'MMM d hh:mm:ss' 'Mon DD, YYYY HH:MM:SS' 'YYYY-MM-DD HH:MM:SS' 'dd/MMM/yyyy:HH:mm:ss zzz' 'ddMMyy HH:mm:ss' 'yyMMdd HH:mm:ss' 'yyyy-MM-ddTHH:mm:ssK'(필수) |
PerfCounterDataSource
이름 | 묘사 | 값 |
---|---|---|
counterSpecifiers | 수집하려는 성능 카운터의 지정자 이름 목록입니다. 와일드카드(*)를 사용하여 모든 인스턴스에 대한 카운터를 수집합니다. Windows에서 성능 카운터 목록을 얻으려면 'typeperf' 명령을 실행합니다. |
string[] |
이름 | 데이터 원본의 이름입니다. 이 이름은 데이터 수집 규칙 내의 모든 데이터 원본(형식에 관계없이)에서 고유해야 합니다. |
문자열 |
samplingFrequencyInSeconds | 연속 카운터 측정(샘플) 사이의 시간(초)입니다. | int |
스트림 | 이 데이터 원본을 보낼 스트림 목록입니다. 스트림은 이 데이터에 사용할 스키마와 일반적으로 데이터가 전송될 Log Analytics의 테이블을 나타냅니다. |
다음 중 어느 것을 포함하는 문자열 배열: 'Microsoft-InsightsMetrics' 'Microsoft-Perf' |
transformKql | 데이터 원본을 변환하는 KQL 쿼리입니다. | 문자열 |
PlatformTelemetryDataSource
이름 | 묘사 | 값 |
---|---|---|
이름 | 데이터 원본의 이름입니다. 이 이름은 데이터 수집 규칙 내의 모든 데이터 원본(형식에 관계없이)에서 고유해야 합니다. |
문자열 |
스트림 | 수집할 플랫폼 원격 분석 스트림 목록 | string[] (필수) |
PrometheusForwarderDataSource
이름 | 묘사 | 값 |
---|---|---|
labelIncludeFilter | 레이블 "name-value" 쌍 형식의 레이블 포함 필터 목록입니다. 현재 'microsoft_metrics_include_label' 레이블이 하나만 지원됩니다. 레이블 값은 대/소문자를 구분하지 않습니다. |
PrometheusForwarderDataSourceLabelIncludeFilter |
이름 | 데이터 원본의 이름입니다. 이 이름은 데이터 수집 규칙 내의 모든 데이터 원본(형식에 관계없이)에서 고유해야 합니다. |
문자열 |
스트림 | 이 데이터 원본을 보낼 스트림 목록입니다. | 다음 중 어느 것을 포함하는 문자열 배열: 'Microsoft-PrometheusMetrics' |
PrometheusForwarderDataSourceLabelIncludeFilter
이름 | 묘사 | 값 |
---|---|---|
{customized property} | 문자열 |
SyslogDataSource
이름 | 묘사 | 값 |
---|---|---|
facilityNames | 시설 이름 목록입니다. | 다음 중 어느 것을 포함하는 문자열 배열: '*' 'alert' 'audit' '인증' 'authpriv' 'clock' 'cron' '디먼' 'ftp' 'kern' 'local0' 'local1' 'local2' 'local3' 'local4' 'local5' 'local6' 'local7' 'lpr' 'mail' 'mark' 'news' 'nopri' 'ntp' 'syslog' 'user' 'uucp' |
logLevels | 수집할 로그 수준입니다. | 다음 중 어느 것을 포함하는 문자열 배열: '*' '경고' 'Critical' '디버그' '긴급' 'Error' '정보' '알림' '경고' |
이름 | 데이터 원본의 이름입니다. 이 이름은 데이터 수집 규칙 내의 모든 데이터 원본(형식에 관계없이)에서 고유해야 합니다. |
문자열 |
스트림 | 이 데이터 원본을 보낼 스트림 목록입니다. 스트림은 이 데이터에 사용할 스키마와 일반적으로 데이터가 전송될 Log Analytics의 테이블을 나타냅니다. |
다음 중 어느 것을 포함하는 문자열 배열: 'Microsoft-Syslog' |
transformKql | 데이터 원본을 변환하는 KQL 쿼리입니다. | 문자열 |
WindowsEventLogDataSource
이름 | 묘사 | 값 |
---|---|---|
이름 | 데이터 원본의 이름입니다. 이 이름은 데이터 수집 규칙 내의 모든 데이터 원본(형식에 관계없이)에서 고유해야 합니다. |
문자열 |
스트림 | 이 데이터 원본을 보낼 스트림 목록입니다. 스트림은 이 데이터에 사용할 스키마와 일반적으로 데이터가 전송될 Log Analytics의 테이블을 나타냅니다. |
다음 중 어느 것을 포함하는 문자열 배열: 'Microsoft-Event' 'Microsoft-WindowsEvent' |
transformKql | 데이터 원본을 변환하는 KQL 쿼리입니다. | 문자열 |
xPathQueries | XPATH 형식의 Windows 이벤트 로그 쿼리 목록입니다. | string[] |
WindowsFirewallLogsDataSource
이름 | 묘사 | 값 |
---|---|---|
이름 | 데이터 원본의 이름입니다. 이 이름은 데이터 수집 규칙 내의 모든 데이터 원본(형식에 관계없이)에서 고유해야 합니다. |
문자열 |
profileFilter | 방화벽 로그 프로필 필터 | 다음 중 어느 것을 포함하는 문자열 배열: '도메인' 'Private' 'Public' |
스트림 | 방화벽 로그 스트림 | string[] (필수) |
DataCollectionRuleDestinations
이름 | 묘사 | 값 |
---|---|---|
azureDataExplorer | Azure Data Explorer 대상 목록입니다. | AdxDestination |
azureMonitorMetrics | Azure Monitor 메트릭 대상입니다. | DestinationsSpecAzureMonitorMetrics |
eventHubs | Event Hubs 대상 목록입니다. | eventHubDestination |
eventHubsDirect | Event Hubs Direct 대상 목록입니다. | eventHubDirectDestination |
logAnalytics | Log Analytics 대상 목록입니다. | logAnalyticsDestination |
microsoftFabric | Microsoft Fabric 대상 목록입니다. | microsoftFabricDestination |
monitoringAccounts | 모니터링 계정 대상 목록입니다. | MonitoringAccountDestination[] |
storageAccounts | 스토리지 계정 대상 목록입니다. | StorageBlobDestination[] |
storageBlobsDirect | Storage Blob Direct 대상 목록입니다. 에이전트에서 저장하기 위해 직접 데이터를 보내는 데만 사용됩니다. | StorageBlobDestination[] |
storageTablesDirect | 스토리지 테이블 다이렉트 대상 목록입니다. | storageTableDestination |
AdxDestination
이름 | 묘사 | 값 |
---|---|---|
databaseName | 데이터를 수집할 데이터베이스의 이름입니다. | 문자열 |
이름 | 대상의 이름입니다. 이 이름은 데이터 수집 규칙 내의 모든 대상(형식에 관계없이)에서 고유해야 합니다. |
문자열 |
resourceId | Adx 리소스의 ARM 리소스 ID입니다. | 문자열 |
DestinationsSpecAzureMonitorMetrics
이름 | 묘사 | 값 |
---|---|---|
이름 | 대상의 이름입니다. 이 이름은 데이터 수집 규칙 내의 모든 대상(형식에 관계없이)에서 고유해야 합니다. |
문자열 |
EventHubDestination
이름 | 묘사 | 값 |
---|---|---|
eventHubResourceId | 이벤트 허브의 리소스 ID입니다. | 문자열 |
이름 | 대상의 이름입니다. 이 이름은 데이터 수집 규칙 내의 모든 대상(형식에 관계없이)에서 고유해야 합니다. |
문자열 |
EventHubDirectDestination
이름 | 묘사 | 값 |
---|---|---|
eventHubResourceId | 이벤트 허브의 리소스 ID입니다. | 문자열 |
이름 | 대상의 이름입니다. 이 이름은 데이터 수집 규칙 내의 모든 대상(형식에 관계없이)에서 고유해야 합니다. |
문자열 |
LogAnalyticsDestination
이름 | 묘사 | 값 |
---|---|---|
이름 | 대상의 이름입니다. 이 이름은 데이터 수집 규칙 내의 모든 대상(형식에 관계없이)에서 고유해야 합니다. |
문자열 |
workspaceResourceId | Log Analytics 작업 영역의 리소스 ID입니다. | 문자열 |
MicrosoftFabricDestination
이름 | 묘사 | 값 |
---|---|---|
artifactId | Microsoft Fabric 리소스의 아티팩트 ID입니다. | 문자열 |
databaseName | 데이터를 수집할 데이터베이스의 이름입니다. | 문자열 |
ingestionUri | Microsoft Fabric 리소스의 수집 URI입니다. | 문자열 |
이름 | 대상의 이름입니다. 이 이름은 데이터 수집 규칙 내의 모든 대상(형식에 관계없이)에서 고유해야 합니다. |
문자열 |
tenantId | Microsoft Fabric 리소스의 테넌트 ID입니다. | 문자열 |
MonitoringAccountDestination
이름 | 묘사 | 값 |
---|---|---|
accountResourceId | 모니터링 계정의 리소스 ID입니다. | 문자열 |
이름 | 대상의 이름입니다. 이 이름은 데이터 수집 규칙 내의 모든 대상(형식에 관계없이)에서 고유해야 합니다. |
문자열 |
StorageBlobDestination
이름 | 묘사 | 값 |
---|---|---|
containerName | Storage Blob의 컨테이너 이름입니다. | 문자열 |
이름 | 대상의 이름입니다. 이 이름은 데이터 수집 규칙 내의 모든 대상(형식에 관계없이)에서 고유해야 합니다. |
문자열 |
storageAccountResourceId | 스토리지 계정의 리소스 ID입니다. | 문자열 |
StorageTableDestination
이름 | 묘사 | 값 |
---|---|---|
이름 | 대상의 이름입니다. 이 이름은 데이터 수집 규칙 내의 모든 대상(형식에 관계없이)에서 고유해야 합니다. |
문자열 |
storageAccountResourceId | 스토리지 계정의 리소스 ID입니다. | 문자열 |
tableName | 스토리지 테이블의 이름입니다. | 문자열 |
DataCollectionRuleReferences
이름 | 묘사 | 값 |
---|---|---|
enrichmentData | 데이터 흐름에서 참조되는 모든 보강 데이터 원본 | ReferencesSpecEnrichmentData |
ReferencesSpecEnrichmentData
이름 | 묘사 | 값 |
---|---|---|
storageBlobs | 보강 데이터 원본으로 사용되는 모든 스토리지 Blob | StorageBlob |
StorageBlob
이름 | 묘사 | 값 |
---|---|---|
blobUrl | 스토리지 Blob의 URL | 문자열 |
lookupType | Blob에서 수행할 조회 유형 | 'Cidr' 'String' |
이름 | 데이터 흐름에서 이 데이터 원본을 참조할 때 별칭으로 사용되는 보강 데이터 원본의 이름입니다. | 문자열 |
resourceId | Blob을 호스트하는 스토리지 계정의 리소스 ID | 문자열 |
DataCollectionRuleStreamDeclarations
이름 | 묘사 | 값 |
---|---|---|
{customized property} | StreamDeclaration |
StreamDeclaration
이름 | 묘사 | 값 |
---|---|---|
열 | 이 스트림의 데이터에서 사용하는 열 목록입니다. | ColumnDefinition[] |
ColumnDefinition
이름 | 묘사 | 값 |
---|---|---|
이름 | 열의 이름입니다. | 문자열 |
형 | 열 데이터의 형식입니다. | 'boolean' 'datetime' 'dynamic' 'int' 'long' 'real' 'string' |
빠른 시작 템플릿
다음 빠른 시작 템플릿은 이 리소스 유형을 배포합니다.
템플렛 | 묘사 |
---|---|
Darktrace 자동 크기 조정 vSensors 배포 Azure 배포 |
이 템플릿을 사용하면 Darktrace vSensors의 자동 크기 조정 배포를 배포할 수 있습니다. |
Syslog 대한 데이터 수집 규칙 Azure |
이 템플릿은 데이터 원본(Syslog) 및 대상 작업 영역을 정의하는 데이터 컬렉션 규칙을 만듭니다. |
ARM 템플릿 리소스 정의
dataCollectionRules 리소스 형식은 다음을 대상으로 하는 작업으로 배포할 수 있습니다.
- 리소스 그룹 - 리소스 그룹 배포 명령 참조
각 API 버전에서 변경된 속성 목록은 변경 로그참조하세요.
리소스 형식
Microsoft.Insights/dataCollectionRules 리소스를 만들려면 템플릿에 다음 JSON을 추가합니다.
{
"type": "Microsoft.Insights/dataCollectionRules",
"apiVersion": "2023-03-11",
"name": "string",
"location": "string",
"tags": {
"tagName1": "tagValue1",
"tagName2": "tagValue2"
},
"kind": "string",
"identity": {
"type": "string",
"userAssignedIdentities": {
"{customized property}": {}
}
},
"properties": {
"agentSettings": {
"logs": [
{
"name": "string",
"value": "string"
}
]
},
"dataCollectionEndpointId": "string",
"dataFlows": [
{
"builtInTransform": "string",
"captureOverflow": "bool",
"destinations": [ "string" ],
"outputStream": "string",
"streams": [ "string" ],
"transformKql": "string"
}
],
"dataSources": {
"dataImports": {
"eventHub": {
"consumerGroup": "string",
"name": "string",
"stream": "string"
}
},
"extensions": [
{
"extensionName": "string",
"extensionSettings": {},
"inputDataSources": [ "string" ],
"name": "string",
"streams": [ "string" ]
}
],
"iisLogs": [
{
"logDirectories": [ "string" ],
"name": "string",
"streams": [ "string" ],
"transformKql": "string"
}
],
"logFiles": [
{
"filePatterns": [ "string" ],
"format": "string",
"name": "string",
"settings": {
"text": {
"recordStartTimestampFormat": "string"
}
},
"streams": [ "string" ],
"transformKql": "string"
}
],
"performanceCounters": [
{
"counterSpecifiers": [ "string" ],
"name": "string",
"samplingFrequencyInSeconds": "int",
"streams": [ "string" ],
"transformKql": "string"
}
],
"platformTelemetry": [
{
"name": "string",
"streams": [ "string" ]
}
],
"prometheusForwarder": [
{
"labelIncludeFilter": {
"{customized property}": "string"
},
"name": "string",
"streams": "Microsoft-PrometheusMetrics"
}
],
"syslog": [
{
"facilityNames": [ "string" ],
"logLevels": [ "string" ],
"name": "string",
"streams": "Microsoft-Syslog",
"transformKql": "string"
}
],
"windowsEventLogs": [
{
"name": "string",
"streams": [ "string" ],
"transformKql": "string",
"xPathQueries": [ "string" ]
}
],
"windowsFirewallLogs": [
{
"name": "string",
"profileFilter": [ "string" ],
"streams": [ "string" ]
}
]
},
"description": "string",
"destinations": {
"azureDataExplorer": [
{
"databaseName": "string",
"name": "string",
"resourceId": "string"
}
],
"azureMonitorMetrics": {
"name": "string"
},
"eventHubs": [
{
"eventHubResourceId": "string",
"name": "string"
}
],
"eventHubsDirect": [
{
"eventHubResourceId": "string",
"name": "string"
}
],
"logAnalytics": [
{
"name": "string",
"workspaceResourceId": "string"
}
],
"microsoftFabric": [
{
"artifactId": "string",
"databaseName": "string",
"ingestionUri": "string",
"name": "string",
"tenantId": "string"
}
],
"monitoringAccounts": [
{
"accountResourceId": "string",
"name": "string"
}
],
"storageAccounts": [
{
"containerName": "string",
"name": "string",
"storageAccountResourceId": "string"
}
],
"storageBlobsDirect": [
{
"containerName": "string",
"name": "string",
"storageAccountResourceId": "string"
}
],
"storageTablesDirect": [
{
"name": "string",
"storageAccountResourceId": "string",
"tableName": "string"
}
]
},
"references": {
"enrichmentData": {
"storageBlobs": [
{
"blobUrl": "string",
"lookupType": "string",
"name": "string",
"resourceId": "string"
}
]
}
},
"streamDeclarations": {
"{customized property}": {
"columns": [
{
"name": "string",
"type": "string"
}
]
}
}
}
}
속성 값
dataCollectionRules
이름 | 묘사 | 값 |
---|---|---|
형 | 리소스 종류 | 'Microsoft.Insights/dataCollectionRules' |
apiVersion | 리소스 api 버전 | '2023-03-11' |
이름 | 리소스 이름 | string(필수) |
위치 | 리소스가 있는 지리적 위치입니다. | string(필수) |
태그 | 리소스 태그. | 태그 이름 및 값의 사전입니다. 템플릿 |
종류 | 리소스의 종류입니다. | 'Linux' 'Windows' |
신원 | 리소스의 관리 서비스 ID입니다. | DataCollectionRuleResourceIdentity |
속성 | 리소스 속성입니다. | DataCollectionRuleResourceProperties |
DataCollectionRuleResourceIdentity
이름 | 묘사 | 값 |
---|---|---|
형 | 관리 서비스 ID의 유형입니다(SystemAssigned 및 UserAssigned 형식이 모두 허용되는 경우). | 'None' 'SystemAssigned' 'SystemAssigned,UserAssigned' 'UserAssigned'(필수) |
userAssignedIdentities | 리소스와 연결된 사용자 할당 ID 집합입니다. userAssignedIdentities 사전 키는 '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} 형식의 ARM 리소스 ID입니다. 사전 값은 요청에서 빈 개체({})일 수 있습니다. | UserAssignedIdentities |
UserAssignedIdentities
이름 | 묘사 | 값 |
---|---|---|
{customized property} | UserAssignedIdentity |
UserAssignedIdentity
이 개체에는 배포 중에 설정할 속성이 없습니다. 모든 속성은 ReadOnly입니다.
DataCollectionRuleResourceProperties
이름 | 묘사 | 값 |
---|---|---|
agentSettings | 지정된 호스트에서 에이전트 동작을 수정하는 데 사용되는 에이전트 설정 | DataCollectionRuleAgentSettings |
dataCollectionEndpointId | 이 규칙을 사용할 수 있는 데이터 컬렉션 엔드포인트의 리소스 ID입니다. | 문자열 |
dataFlows | 데이터 흐름의 사양입니다. | DataFlow[] |
dataSources | 데이터 원본의 사양입니다. 이 속성은 선택 사항이며 프로비전된 엔드포인트에 대한 직접 호출을 통해 규칙을 사용하는 경우 생략할 수 있습니다. |
dataCollectionRuleDataSources |
묘사 | 데이터 수집 규칙에 대한 설명입니다. | 문자열 |
목적지 | 대상의 사양입니다. | DataCollectionRuleDestinations |
참조 | DCR의 다른 섹션에서 사용할 수 있는 모든 참조를 정의합니다. | DataCollectionRuleReferences |
streamDeclarations | 이 규칙에 사용되는 사용자 지정 스트림의 선언입니다. | DataCollectionRuleStreamDeclarations |
DataCollectionRuleAgentSettings
이름 | 묘사 | 값 |
---|---|---|
로그 | 로그 에이전트에 적용할 수 있는 모든 설정(AMA) | AgentSetting[] |
AgentSetting
이름 | 묘사 | 값 |
---|---|---|
이름 | 설정의 이름입니다. 지원되는 설정 목록의 일부여야 합니다. |
'MaxDiskQuotaInMB' 'UseTimeReceivedForForwardedEvents' |
값 | 설정의 값입니다. | 문자열 |
DataFlow
이름 | 묘사 | 값 |
---|---|---|
builtInTransform | 스트림 데이터를 변환하는 builtIn 변환 | 문자열 |
captureOverflow | LA 대상에서 오버플로 열을 사용하도록 설정하는 플래그 | bool |
목적지 | 이 데이터 흐름의 대상 목록입니다. | string[] |
outputStream | 변환의 출력 스트림입니다. 변환이 데이터를 다른 스트림으로 변경하는 경우에만 필요합니다. | 문자열 |
스트림 | 이 데이터 흐름에 대한 스트림 목록입니다. | 다음 중 어느 것을 포함하는 문자열 배열: 'Microsoft-Event' 'Microsoft-InsightsMetrics' 'Microsoft-Perf' 'Microsoft-Syslog' 'Microsoft-WindowsEvent' |
transformKql | 스트림 데이터를 변환하는 KQL 쿼리입니다. | 문자열 |
DataCollectionRuleDataSources
이름 | 묘사 | 값 |
---|---|---|
dataImports | 끌어오기 기반 데이터 원본 사양 | DataSourcesSpecDataImports |
확장 | Azure VM 확장 데이터 원본 구성 목록입니다. | ExtensionDataSource[] |
iisLogs | IIS 로그 원본 구성의 목록입니다. | IisLogsDataSource[] |
logFiles | 로그 파일 원본 구성 목록입니다. | LogFilesDataSource |
performanceCounters | 성능 카운터 데이터 원본 구성 목록입니다. | PerfCounterDataSource[] |
platformTelemetry | 플랫폼 원격 분석 구성 목록 | platformTelemetryDataSource |
prometheusForwarder | Prometheus 전달자 데이터 원본 구성 목록입니다. | PrometheusForwarderDataSource[] |
syslog | Syslog 데이터 원본 구성 목록입니다. | SyslogDataSource[] |
windowsEventLogs | Windows 이벤트 로그 데이터 원본 구성 목록입니다. | WindowsEventLogDataSource |
windowsFirewallLogs | Windows 방화벽 로그 원본 구성의 목록입니다. | windowsFirewallLogsDataSource |
DataSourcesSpecDataImports
이름 | 묘사 | 값 |
---|---|---|
eventHub | Event Hub 구성의 정의입니다. | DataImportSourcesEventHub |
DataImportSourcesEventHub
이름 | 묘사 | 값 |
---|---|---|
consumerGroup | Event Hub 소비자 그룹 이름 | 문자열 |
이름 | 데이터 원본의 이름입니다. 이 이름은 데이터 수집 규칙 내의 모든 데이터 원본(형식에 관계없이)에서 고유해야 합니다. |
문자열 |
시내 | EventHub에서 수집할 스트림 | 문자열 |
ExtensionDataSource
이름 | 묘사 | 값 |
---|---|---|
extensionName | VM 확장의 이름입니다. | string(필수) |
extensionSettings | 확장 설정입니다. 형식은 특정 확장에 특정합니다. | |
inputDataSources | 이 확장에 데이터가 필요한 데이터 원본 목록입니다. | string[] |
이름 | 데이터 원본의 이름입니다. 이 이름은 데이터 수집 규칙 내의 모든 데이터 원본(형식에 관계없이)에서 고유해야 합니다. |
문자열 |
스트림 | 이 데이터 원본을 보낼 스트림 목록입니다. 스트림은 이 데이터에 사용할 스키마와 일반적으로 데이터가 전송될 Log Analytics의 테이블을 나타냅니다. |
다음 중 어느 것을 포함하는 문자열 배열: 'Microsoft-Event' 'Microsoft-InsightsMetrics' 'Microsoft-Perf' 'Microsoft-Syslog' 'Microsoft-WindowsEvent' |
IisLogsDataSource
이름 | 묘사 | 값 |
---|---|---|
logDirectories | 절대 경로 파일 위치 | string[] |
이름 | 데이터 원본의 이름입니다. 이 이름은 데이터 수집 규칙 내의 모든 데이터 원본(형식에 관계없이)에서 고유해야 합니다. |
문자열 |
스트림 | IIS 스트림 | string[] (필수) |
transformKql | 데이터 원본을 변환하는 KQL 쿼리입니다. | 문자열 |
LogFilesDataSource
이름 | 묘사 | 값 |
---|---|---|
filePatterns | 로그 파일이 있는 파일 패턴 | string[] (필수) |
판 | 로그 파일의 데이터 형식 | 'json' 'text'(필수) |
이름 | 데이터 원본의 이름입니다. 이 이름은 데이터 수집 규칙 내의 모든 데이터 원본(형식에 관계없이)에서 고유해야 합니다. |
문자열 |
설정 | 로그 파일 관련 설정입니다. | logFilesDataSourceSettings |
스트림 | 이 데이터 원본을 보낼 스트림 목록입니다. 스트림은 이 데이터 원본에 사용할 스키마를 나타냅니다. |
string[] (필수) |
transformKql | 데이터 원본을 변환하는 KQL 쿼리입니다. | 문자열 |
LogFilesDataSourceSettings
이름 | 묘사 | 값 |
---|---|---|
문자 메시지 | 텍스트 설정 | LogFileSettingsText |
LogFileSettingsText
이름 | 묘사 | 값 |
---|---|---|
recordStartTimestampFormat | 지원되는 타임스탬프 형식 중 하나 | 'ISO 8601' 'M/D/YYYY HH:MM:SS AM/PM' 'MMM d hh:mm:ss' 'Mon DD, YYYY HH:MM:SS' 'YYYY-MM-DD HH:MM:SS' 'dd/MMM/yyyy:HH:mm:ss zzz' 'ddMMyy HH:mm:ss' 'yyMMdd HH:mm:ss' 'yyyy-MM-ddTHH:mm:ssK'(필수) |
PerfCounterDataSource
이름 | 묘사 | 값 |
---|---|---|
counterSpecifiers | 수집하려는 성능 카운터의 지정자 이름 목록입니다. 와일드카드(*)를 사용하여 모든 인스턴스에 대한 카운터를 수집합니다. Windows에서 성능 카운터 목록을 얻으려면 'typeperf' 명령을 실행합니다. |
string[] |
이름 | 데이터 원본의 이름입니다. 이 이름은 데이터 수집 규칙 내의 모든 데이터 원본(형식에 관계없이)에서 고유해야 합니다. |
문자열 |
samplingFrequencyInSeconds | 연속 카운터 측정(샘플) 사이의 시간(초)입니다. | int |
스트림 | 이 데이터 원본을 보낼 스트림 목록입니다. 스트림은 이 데이터에 사용할 스키마와 일반적으로 데이터가 전송될 Log Analytics의 테이블을 나타냅니다. |
다음 중 어느 것을 포함하는 문자열 배열: 'Microsoft-InsightsMetrics' 'Microsoft-Perf' |
transformKql | 데이터 원본을 변환하는 KQL 쿼리입니다. | 문자열 |
PlatformTelemetryDataSource
이름 | 묘사 | 값 |
---|---|---|
이름 | 데이터 원본의 이름입니다. 이 이름은 데이터 수집 규칙 내의 모든 데이터 원본(형식에 관계없이)에서 고유해야 합니다. |
문자열 |
스트림 | 수집할 플랫폼 원격 분석 스트림 목록 | string[] (필수) |
PrometheusForwarderDataSource
이름 | 묘사 | 값 |
---|---|---|
labelIncludeFilter | 레이블 "name-value" 쌍 형식의 레이블 포함 필터 목록입니다. 현재 'microsoft_metrics_include_label' 레이블이 하나만 지원됩니다. 레이블 값은 대/소문자를 구분하지 않습니다. |
PrometheusForwarderDataSourceLabelIncludeFilter |
이름 | 데이터 원본의 이름입니다. 이 이름은 데이터 수집 규칙 내의 모든 데이터 원본(형식에 관계없이)에서 고유해야 합니다. |
문자열 |
스트림 | 이 데이터 원본을 보낼 스트림 목록입니다. | 다음 중 어느 것을 포함하는 문자열 배열: 'Microsoft-PrometheusMetrics' |
PrometheusForwarderDataSourceLabelIncludeFilter
이름 | 묘사 | 값 |
---|---|---|
{customized property} | 문자열 |
SyslogDataSource
이름 | 묘사 | 값 |
---|---|---|
facilityNames | 시설 이름 목록입니다. | 다음 중 어느 것을 포함하는 문자열 배열: '*' 'alert' 'audit' '인증' 'authpriv' 'clock' 'cron' '디먼' 'ftp' 'kern' 'local0' 'local1' 'local2' 'local3' 'local4' 'local5' 'local6' 'local7' 'lpr' 'mail' 'mark' 'news' 'nopri' 'ntp' 'syslog' 'user' 'uucp' |
logLevels | 수집할 로그 수준입니다. | 다음 중 어느 것을 포함하는 문자열 배열: '*' '경고' 'Critical' '디버그' '긴급' 'Error' '정보' '알림' '경고' |
이름 | 데이터 원본의 이름입니다. 이 이름은 데이터 수집 규칙 내의 모든 데이터 원본(형식에 관계없이)에서 고유해야 합니다. |
문자열 |
스트림 | 이 데이터 원본을 보낼 스트림 목록입니다. 스트림은 이 데이터에 사용할 스키마와 일반적으로 데이터가 전송될 Log Analytics의 테이블을 나타냅니다. |
다음 중 어느 것을 포함하는 문자열 배열: 'Microsoft-Syslog' |
transformKql | 데이터 원본을 변환하는 KQL 쿼리입니다. | 문자열 |
WindowsEventLogDataSource
이름 | 묘사 | 값 |
---|---|---|
이름 | 데이터 원본의 이름입니다. 이 이름은 데이터 수집 규칙 내의 모든 데이터 원본(형식에 관계없이)에서 고유해야 합니다. |
문자열 |
스트림 | 이 데이터 원본을 보낼 스트림 목록입니다. 스트림은 이 데이터에 사용할 스키마와 일반적으로 데이터가 전송될 Log Analytics의 테이블을 나타냅니다. |
다음 중 어느 것을 포함하는 문자열 배열: 'Microsoft-Event' 'Microsoft-WindowsEvent' |
transformKql | 데이터 원본을 변환하는 KQL 쿼리입니다. | 문자열 |
xPathQueries | XPATH 형식의 Windows 이벤트 로그 쿼리 목록입니다. | string[] |
WindowsFirewallLogsDataSource
이름 | 묘사 | 값 |
---|---|---|
이름 | 데이터 원본의 이름입니다. 이 이름은 데이터 수집 규칙 내의 모든 데이터 원본(형식에 관계없이)에서 고유해야 합니다. |
문자열 |
profileFilter | 방화벽 로그 프로필 필터 | 다음 중 어느 것을 포함하는 문자열 배열: '도메인' 'Private' 'Public' |
스트림 | 방화벽 로그 스트림 | string[] (필수) |
DataCollectionRuleDestinations
이름 | 묘사 | 값 |
---|---|---|
azureDataExplorer | Azure Data Explorer 대상 목록입니다. | AdxDestination |
azureMonitorMetrics | Azure Monitor 메트릭 대상입니다. | DestinationsSpecAzureMonitorMetrics |
eventHubs | Event Hubs 대상 목록입니다. | eventHubDestination |
eventHubsDirect | Event Hubs Direct 대상 목록입니다. | eventHubDirectDestination |
logAnalytics | Log Analytics 대상 목록입니다. | logAnalyticsDestination |
microsoftFabric | Microsoft Fabric 대상 목록입니다. | microsoftFabricDestination |
monitoringAccounts | 모니터링 계정 대상 목록입니다. | MonitoringAccountDestination[] |
storageAccounts | 스토리지 계정 대상 목록입니다. | StorageBlobDestination[] |
storageBlobsDirect | Storage Blob Direct 대상 목록입니다. 에이전트에서 저장하기 위해 직접 데이터를 보내는 데만 사용됩니다. | StorageBlobDestination[] |
storageTablesDirect | 스토리지 테이블 다이렉트 대상 목록입니다. | storageTableDestination |
AdxDestination
이름 | 묘사 | 값 |
---|---|---|
databaseName | 데이터를 수집할 데이터베이스의 이름입니다. | 문자열 |
이름 | 대상의 이름입니다. 이 이름은 데이터 수집 규칙 내의 모든 대상(형식에 관계없이)에서 고유해야 합니다. |
문자열 |
resourceId | Adx 리소스의 ARM 리소스 ID입니다. | 문자열 |
DestinationsSpecAzureMonitorMetrics
이름 | 묘사 | 값 |
---|---|---|
이름 | 대상의 이름입니다. 이 이름은 데이터 수집 규칙 내의 모든 대상(형식에 관계없이)에서 고유해야 합니다. |
문자열 |
EventHubDestination
이름 | 묘사 | 값 |
---|---|---|
eventHubResourceId | 이벤트 허브의 리소스 ID입니다. | 문자열 |
이름 | 대상의 이름입니다. 이 이름은 데이터 수집 규칙 내의 모든 대상(형식에 관계없이)에서 고유해야 합니다. |
문자열 |
EventHubDirectDestination
이름 | 묘사 | 값 |
---|---|---|
eventHubResourceId | 이벤트 허브의 리소스 ID입니다. | 문자열 |
이름 | 대상의 이름입니다. 이 이름은 데이터 수집 규칙 내의 모든 대상(형식에 관계없이)에서 고유해야 합니다. |
문자열 |
LogAnalyticsDestination
이름 | 묘사 | 값 |
---|---|---|
이름 | 대상의 이름입니다. 이 이름은 데이터 수집 규칙 내의 모든 대상(형식에 관계없이)에서 고유해야 합니다. |
문자열 |
workspaceResourceId | Log Analytics 작업 영역의 리소스 ID입니다. | 문자열 |
MicrosoftFabricDestination
이름 | 묘사 | 값 |
---|---|---|
artifactId | Microsoft Fabric 리소스의 아티팩트 ID입니다. | 문자열 |
databaseName | 데이터를 수집할 데이터베이스의 이름입니다. | 문자열 |
ingestionUri | Microsoft Fabric 리소스의 수집 URI입니다. | 문자열 |
이름 | 대상의 이름입니다. 이 이름은 데이터 수집 규칙 내의 모든 대상(형식에 관계없이)에서 고유해야 합니다. |
문자열 |
tenantId | Microsoft Fabric 리소스의 테넌트 ID입니다. | 문자열 |
MonitoringAccountDestination
이름 | 묘사 | 값 |
---|---|---|
accountResourceId | 모니터링 계정의 리소스 ID입니다. | 문자열 |
이름 | 대상의 이름입니다. 이 이름은 데이터 수집 규칙 내의 모든 대상(형식에 관계없이)에서 고유해야 합니다. |
문자열 |
StorageBlobDestination
이름 | 묘사 | 값 |
---|---|---|
containerName | Storage Blob의 컨테이너 이름입니다. | 문자열 |
이름 | 대상의 이름입니다. 이 이름은 데이터 수집 규칙 내의 모든 대상(형식에 관계없이)에서 고유해야 합니다. |
문자열 |
storageAccountResourceId | 스토리지 계정의 리소스 ID입니다. | 문자열 |
StorageTableDestination
이름 | 묘사 | 값 |
---|---|---|
이름 | 대상의 이름입니다. 이 이름은 데이터 수집 규칙 내의 모든 대상(형식에 관계없이)에서 고유해야 합니다. |
문자열 |
storageAccountResourceId | 스토리지 계정의 리소스 ID입니다. | 문자열 |
tableName | 스토리지 테이블의 이름입니다. | 문자열 |
DataCollectionRuleReferences
이름 | 묘사 | 값 |
---|---|---|
enrichmentData | 데이터 흐름에서 참조되는 모든 보강 데이터 원본 | ReferencesSpecEnrichmentData |
ReferencesSpecEnrichmentData
이름 | 묘사 | 값 |
---|---|---|
storageBlobs | 보강 데이터 원본으로 사용되는 모든 스토리지 Blob | StorageBlob |
StorageBlob
이름 | 묘사 | 값 |
---|---|---|
blobUrl | 스토리지 Blob의 URL | 문자열 |
lookupType | Blob에서 수행할 조회 유형 | 'Cidr' 'String' |
이름 | 데이터 흐름에서 이 데이터 원본을 참조할 때 별칭으로 사용되는 보강 데이터 원본의 이름입니다. | 문자열 |
resourceId | Blob을 호스트하는 스토리지 계정의 리소스 ID | 문자열 |
DataCollectionRuleStreamDeclarations
이름 | 묘사 | 값 |
---|---|---|
{customized property} | StreamDeclaration |
StreamDeclaration
이름 | 묘사 | 값 |
---|---|---|
열 | 이 스트림의 데이터에서 사용하는 열 목록입니다. | ColumnDefinition[] |
ColumnDefinition
이름 | 묘사 | 값 |
---|---|---|
이름 | 열의 이름입니다. | 문자열 |
형 | 열 데이터의 형식입니다. | 'boolean' 'datetime' 'dynamic' 'int' 'long' 'real' 'string' |
빠른 시작 템플릿
다음 빠른 시작 템플릿은 이 리소스 유형을 배포합니다.
템플렛 | 묘사 |
---|---|
Darktrace 자동 크기 조정 vSensors 배포 Azure 배포 |
이 템플릿을 사용하면 Darktrace vSensors의 자동 크기 조정 배포를 배포할 수 있습니다. |
Syslog 대한 데이터 수집 규칙 Azure |
이 템플릿은 데이터 원본(Syslog) 및 대상 작업 영역을 정의하는 데이터 컬렉션 규칙을 만듭니다. |
Terraform(AzAPI 공급자) 리소스 정의
dataCollectionRules 리소스 형식은 다음을 대상으로 하는 작업으로 배포할 수 있습니다.
- 리소스 그룹
각 API 버전에서 변경된 속성 목록은 변경 로그참조하세요.
리소스 형식
Microsoft.Insights/dataCollectionRules 리소스를 만들려면 템플릿에 다음 Terraform을 추가합니다.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.Insights/dataCollectionRules@2023-03-11"
name = "string"
location = "string"
parent_id = "string"
tags = {
tagName1 = "tagValue1"
tagName2 = "tagValue2"
}
identity {
type = "string"
identity_ids = []
}
body = jsonencode({
properties = {
agentSettings = {
logs = [
{
name = "string"
value = "string"
}
]
}
dataCollectionEndpointId = "string"
dataFlows = [
{
builtInTransform = "string"
captureOverflow = bool
destinations = [
"string"
]
outputStream = "string"
streams = [
"string"
]
transformKql = "string"
}
]
dataSources = {
dataImports = {
eventHub = {
consumerGroup = "string"
name = "string"
stream = "string"
}
}
extensions = [
{
extensionName = "string"
inputDataSources = [
"string"
]
name = "string"
streams = [
"string"
]
}
]
iisLogs = [
{
logDirectories = [
"string"
]
name = "string"
streams = [
"string"
]
transformKql = "string"
}
]
logFiles = [
{
filePatterns = [
"string"
]
format = "string"
name = "string"
settings = {
text = {
recordStartTimestampFormat = "string"
}
}
streams = [
"string"
]
transformKql = "string"
}
]
performanceCounters = [
{
counterSpecifiers = [
"string"
]
name = "string"
samplingFrequencyInSeconds = int
streams = [
"string"
]
transformKql = "string"
}
]
platformTelemetry = [
{
name = "string"
streams = [
"string"
]
}
]
prometheusForwarder = [
{
labelIncludeFilter = {
{customized property} = "string"
}
name = "string"
streams = "Microsoft-PrometheusMetrics"
}
]
syslog = [
{
facilityNames = [
"string"
]
logLevels = [
"string"
]
name = "string"
streams = "Microsoft-Syslog"
transformKql = "string"
}
]
windowsEventLogs = [
{
name = "string"
streams = [
"string"
]
transformKql = "string"
xPathQueries = [
"string"
]
}
]
windowsFirewallLogs = [
{
name = "string"
profileFilter = [
"string"
]
streams = [
"string"
]
}
]
}
description = "string"
destinations = {
azureDataExplorer = [
{
databaseName = "string"
name = "string"
resourceId = "string"
}
]
azureMonitorMetrics = {
name = "string"
}
eventHubs = [
{
eventHubResourceId = "string"
name = "string"
}
]
eventHubsDirect = [
{
eventHubResourceId = "string"
name = "string"
}
]
logAnalytics = [
{
name = "string"
workspaceResourceId = "string"
}
]
microsoftFabric = [
{
artifactId = "string"
databaseName = "string"
ingestionUri = "string"
name = "string"
tenantId = "string"
}
]
monitoringAccounts = [
{
accountResourceId = "string"
name = "string"
}
]
storageAccounts = [
{
containerName = "string"
name = "string"
storageAccountResourceId = "string"
}
]
storageBlobsDirect = [
{
containerName = "string"
name = "string"
storageAccountResourceId = "string"
}
]
storageTablesDirect = [
{
name = "string"
storageAccountResourceId = "string"
tableName = "string"
}
]
}
references = {
enrichmentData = {
storageBlobs = [
{
blobUrl = "string"
lookupType = "string"
name = "string"
resourceId = "string"
}
]
}
}
streamDeclarations = {
{customized property} = {
columns = [
{
name = "string"
type = "string"
}
]
}
}
}
kind = "string"
})
}
속성 값
dataCollectionRules
이름 | 묘사 | 값 |
---|---|---|
형 | 리소스 종류 | "Microsoft.Insights/dataCollectionRules@2023-03-11" |
이름 | 리소스 이름 | string(필수) |
위치 | 리소스가 있는 지리적 위치입니다. | string(필수) |
parent_id | 리소스 그룹에 배포하려면 해당 리소스 그룹의 ID를 사용합니다. | string(필수) |
태그 | 리소스 태그. | 태그 이름 및 값의 사전입니다. |
종류 | 리소스의 종류입니다. | "Linux" "Windows" |
신원 | 리소스의 관리 서비스 ID입니다. | DataCollectionRuleResourceIdentity |
속성 | 리소스 속성입니다. | DataCollectionRuleResourceProperties |
DataCollectionRuleResourceIdentity
이름 | 묘사 | 값 |
---|---|---|
형 | 관리 서비스 ID의 유형입니다(SystemAssigned 및 UserAssigned 형식이 모두 허용되는 경우). | "SystemAssigned" "SystemAssigned,UserAssigned" "UserAssigned"(필수) |
identity_ids | 리소스와 연결된 사용자 할당 ID 집합입니다. userAssignedIdentities 사전 키는 '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} 형식의 ARM 리소스 ID입니다. 사전 값은 요청에서 빈 개체({})일 수 있습니다. | 사용자 ID ID의 배열입니다. |
UserAssignedIdentities
이름 | 묘사 | 값 |
---|---|---|
{customized property} | UserAssignedIdentity |
UserAssignedIdentity
이 개체에는 배포 중에 설정할 속성이 없습니다. 모든 속성은 ReadOnly입니다.
DataCollectionRuleResourceProperties
이름 | 묘사 | 값 |
---|---|---|
agentSettings | 지정된 호스트에서 에이전트 동작을 수정하는 데 사용되는 에이전트 설정 | DataCollectionRuleAgentSettings |
dataCollectionEndpointId | 이 규칙을 사용할 수 있는 데이터 컬렉션 엔드포인트의 리소스 ID입니다. | 문자열 |
dataFlows | 데이터 흐름의 사양입니다. | DataFlow[] |
dataSources | 데이터 원본의 사양입니다. 이 속성은 선택 사항이며 프로비전된 엔드포인트에 대한 직접 호출을 통해 규칙을 사용하는 경우 생략할 수 있습니다. |
dataCollectionRuleDataSources |
묘사 | 데이터 수집 규칙에 대한 설명입니다. | 문자열 |
목적지 | 대상의 사양입니다. | DataCollectionRuleDestinations |
참조 | DCR의 다른 섹션에서 사용할 수 있는 모든 참조를 정의합니다. | DataCollectionRuleReferences |
streamDeclarations | 이 규칙에 사용되는 사용자 지정 스트림의 선언입니다. | DataCollectionRuleStreamDeclarations |
DataCollectionRuleAgentSettings
이름 | 묘사 | 값 |
---|---|---|
로그 | 로그 에이전트에 적용할 수 있는 모든 설정(AMA) | AgentSetting[] |
AgentSetting
이름 | 묘사 | 값 |
---|---|---|
이름 | 설정의 이름입니다. 지원되는 설정 목록의 일부여야 합니다. |
"MaxDiskQuotaInMB" "UseTimeReceivedForForwardedEvents" |
값 | 설정의 값입니다. | 문자열 |
DataFlow
이름 | 묘사 | 값 |
---|---|---|
builtInTransform | 스트림 데이터를 변환하는 builtIn 변환 | 문자열 |
captureOverflow | LA 대상에서 오버플로 열을 사용하도록 설정하는 플래그 | bool |
목적지 | 이 데이터 흐름의 대상 목록입니다. | string[] |
outputStream | 변환의 출력 스트림입니다. 변환이 데이터를 다른 스트림으로 변경하는 경우에만 필요합니다. | 문자열 |
스트림 | 이 데이터 흐름에 대한 스트림 목록입니다. | 다음 중 어느 것을 포함하는 문자열 배열: "Microsoft-Event" "Microsoft-InsightsMetrics" "Microsoft-Perf" "Microsoft-Syslog" "Microsoft-WindowsEvent" |
transformKql | 스트림 데이터를 변환하는 KQL 쿼리입니다. | 문자열 |
DataCollectionRuleDataSources
이름 | 묘사 | 값 |
---|---|---|
dataImports | 끌어오기 기반 데이터 원본 사양 | DataSourcesSpecDataImports |
확장 | Azure VM 확장 데이터 원본 구성 목록입니다. | ExtensionDataSource[] |
iisLogs | IIS 로그 원본 구성의 목록입니다. | IisLogsDataSource[] |
logFiles | 로그 파일 원본 구성 목록입니다. | LogFilesDataSource |
performanceCounters | 성능 카운터 데이터 원본 구성 목록입니다. | PerfCounterDataSource[] |
platformTelemetry | 플랫폼 원격 분석 구성 목록 | platformTelemetryDataSource |
prometheusForwarder | Prometheus 전달자 데이터 원본 구성 목록입니다. | PrometheusForwarderDataSource[] |
syslog | Syslog 데이터 원본 구성 목록입니다. | SyslogDataSource[] |
windowsEventLogs | Windows 이벤트 로그 데이터 원본 구성 목록입니다. | WindowsEventLogDataSource |
windowsFirewallLogs | Windows 방화벽 로그 원본 구성의 목록입니다. | windowsFirewallLogsDataSource |
DataSourcesSpecDataImports
이름 | 묘사 | 값 |
---|---|---|
eventHub | Event Hub 구성의 정의입니다. | DataImportSourcesEventHub |
DataImportSourcesEventHub
이름 | 묘사 | 값 |
---|---|---|
consumerGroup | Event Hub 소비자 그룹 이름 | 문자열 |
이름 | 데이터 원본의 이름입니다. 이 이름은 데이터 수집 규칙 내의 모든 데이터 원본(형식에 관계없이)에서 고유해야 합니다. |
문자열 |
시내 | EventHub에서 수집할 스트림 | 문자열 |
ExtensionDataSource
이름 | 묘사 | 값 |
---|---|---|
extensionName | VM 확장의 이름입니다. | string(필수) |
extensionSettings | 확장 설정입니다. 형식은 특정 확장에 특정합니다. | |
inputDataSources | 이 확장에 데이터가 필요한 데이터 원본 목록입니다. | string[] |
이름 | 데이터 원본의 이름입니다. 이 이름은 데이터 수집 규칙 내의 모든 데이터 원본(형식에 관계없이)에서 고유해야 합니다. |
문자열 |
스트림 | 이 데이터 원본을 보낼 스트림 목록입니다. 스트림은 이 데이터에 사용할 스키마와 일반적으로 데이터가 전송될 Log Analytics의 테이블을 나타냅니다. |
다음 중 어느 것을 포함하는 문자열 배열: "Microsoft-Event" "Microsoft-InsightsMetrics" "Microsoft-Perf" "Microsoft-Syslog" "Microsoft-WindowsEvent" |
IisLogsDataSource
이름 | 묘사 | 값 |
---|---|---|
logDirectories | 절대 경로 파일 위치 | string[] |
이름 | 데이터 원본의 이름입니다. 이 이름은 데이터 수집 규칙 내의 모든 데이터 원본(형식에 관계없이)에서 고유해야 합니다. |
문자열 |
스트림 | IIS 스트림 | string[] (필수) |
transformKql | 데이터 원본을 변환하는 KQL 쿼리입니다. | 문자열 |
LogFilesDataSource
이름 | 묘사 | 값 |
---|---|---|
filePatterns | 로그 파일이 있는 파일 패턴 | string[] (필수) |
판 | 로그 파일의 데이터 형식 | "json" "text"(필수) |
이름 | 데이터 원본의 이름입니다. 이 이름은 데이터 수집 규칙 내의 모든 데이터 원본(형식에 관계없이)에서 고유해야 합니다. |
문자열 |
설정 | 로그 파일 관련 설정입니다. | logFilesDataSourceSettings |
스트림 | 이 데이터 원본을 보낼 스트림 목록입니다. 스트림은 이 데이터 원본에 사용할 스키마를 나타냅니다. |
string[] (필수) |
transformKql | 데이터 원본을 변환하는 KQL 쿼리입니다. | 문자열 |
LogFilesDataSourceSettings
이름 | 묘사 | 값 |
---|---|---|
문자 메시지 | 텍스트 설정 | LogFileSettingsText |
LogFileSettingsText
이름 | 묘사 | 값 |
---|---|---|
recordStartTimestampFormat | 지원되는 타임스탬프 형식 중 하나 | "ISO 8601" "M/D/YYYY HH:MM:SS AM/PM" "MMM d hh:mm:ss" "Mon DD, YYYY HH:MM:SS" "YYYY-MM-DD HH:MM:SS" "dd/MMM/yyyy:HH:mm:ss zzz" "ddMMyy HH:mm:ss" "yyMMdd HH:mm:ss" "yyyy-MM-ddTHH:mm:ssK"(필수) |
PerfCounterDataSource
이름 | 묘사 | 값 |
---|---|---|
counterSpecifiers | 수집하려는 성능 카운터의 지정자 이름 목록입니다. 와일드카드(*)를 사용하여 모든 인스턴스에 대한 카운터를 수집합니다. Windows에서 성능 카운터 목록을 얻으려면 'typeperf' 명령을 실행합니다. |
string[] |
이름 | 데이터 원본의 이름입니다. 이 이름은 데이터 수집 규칙 내의 모든 데이터 원본(형식에 관계없이)에서 고유해야 합니다. |
문자열 |
samplingFrequencyInSeconds | 연속 카운터 측정(샘플) 사이의 시간(초)입니다. | int |
스트림 | 이 데이터 원본을 보낼 스트림 목록입니다. 스트림은 이 데이터에 사용할 스키마와 일반적으로 데이터가 전송될 Log Analytics의 테이블을 나타냅니다. |
다음 중 어느 것을 포함하는 문자열 배열: "Microsoft-InsightsMetrics" "Microsoft-Perf" |
transformKql | 데이터 원본을 변환하는 KQL 쿼리입니다. | 문자열 |
PlatformTelemetryDataSource
이름 | 묘사 | 값 |
---|---|---|
이름 | 데이터 원본의 이름입니다. 이 이름은 데이터 수집 규칙 내의 모든 데이터 원본(형식에 관계없이)에서 고유해야 합니다. |
문자열 |
스트림 | 수집할 플랫폼 원격 분석 스트림 목록 | string[] (필수) |
PrometheusForwarderDataSource
이름 | 묘사 | 값 |
---|---|---|
labelIncludeFilter | 레이블 "name-value" 쌍 형식의 레이블 포함 필터 목록입니다. 현재 'microsoft_metrics_include_label' 레이블이 하나만 지원됩니다. 레이블 값은 대/소문자를 구분하지 않습니다. |
PrometheusForwarderDataSourceLabelIncludeFilter |
이름 | 데이터 원본의 이름입니다. 이 이름은 데이터 수집 규칙 내의 모든 데이터 원본(형식에 관계없이)에서 고유해야 합니다. |
문자열 |
스트림 | 이 데이터 원본을 보낼 스트림 목록입니다. | 다음 중 어느 것을 포함하는 문자열 배열: "Microsoft-PrometheusMetrics" |
PrometheusForwarderDataSourceLabelIncludeFilter
이름 | 묘사 | 값 |
---|---|---|
{customized property} | 문자열 |
SyslogDataSource
이름 | 묘사 | 값 |
---|---|---|
facilityNames | 시설 이름 목록입니다. | 다음 중 어느 것을 포함하는 문자열 배열: "*" "경고" "audit" "인증" "authpriv" "clock" "cron" "디먼" "ftp" "kern" "local0" "local1" "local2" "local3" "local4" "local5" "local6" "local7" "lpr" "mail" "mark" "news" "nopri" "ntp" "syslog" "user" "uucp" |
logLevels | 수집할 로그 수준입니다. | 다음 중 어느 것을 포함하는 문자열 배열: "*" "경고" "위험" "디버그" "긴급" "오류" "정보" "알림" "경고" |
이름 | 데이터 원본의 이름입니다. 이 이름은 데이터 수집 규칙 내의 모든 데이터 원본(형식에 관계없이)에서 고유해야 합니다. |
문자열 |
스트림 | 이 데이터 원본을 보낼 스트림 목록입니다. 스트림은 이 데이터에 사용할 스키마와 일반적으로 데이터가 전송될 Log Analytics의 테이블을 나타냅니다. |
다음 중 어느 것을 포함하는 문자열 배열: "Microsoft-Syslog" |
transformKql | 데이터 원본을 변환하는 KQL 쿼리입니다. | 문자열 |
WindowsEventLogDataSource
이름 | 묘사 | 값 |
---|---|---|
이름 | 데이터 원본의 이름입니다. 이 이름은 데이터 수집 규칙 내의 모든 데이터 원본(형식에 관계없이)에서 고유해야 합니다. |
문자열 |
스트림 | 이 데이터 원본을 보낼 스트림 목록입니다. 스트림은 이 데이터에 사용할 스키마와 일반적으로 데이터가 전송될 Log Analytics의 테이블을 나타냅니다. |
다음 중 어느 것을 포함하는 문자열 배열: "Microsoft-Event" "Microsoft-WindowsEvent" |
transformKql | 데이터 원본을 변환하는 KQL 쿼리입니다. | 문자열 |
xPathQueries | XPATH 형식의 Windows 이벤트 로그 쿼리 목록입니다. | string[] |
WindowsFirewallLogsDataSource
이름 | 묘사 | 값 |
---|---|---|
이름 | 데이터 원본의 이름입니다. 이 이름은 데이터 수집 규칙 내의 모든 데이터 원본(형식에 관계없이)에서 고유해야 합니다. |
문자열 |
profileFilter | 방화벽 로그 프로필 필터 | 다음 중 어느 것을 포함하는 문자열 배열: "도메인" "Private" "Public" |
스트림 | 방화벽 로그 스트림 | string[] (필수) |
DataCollectionRuleDestinations
이름 | 묘사 | 값 |
---|---|---|
azureDataExplorer | Azure Data Explorer 대상 목록입니다. | AdxDestination |
azureMonitorMetrics | Azure Monitor 메트릭 대상입니다. | DestinationsSpecAzureMonitorMetrics |
eventHubs | Event Hubs 대상 목록입니다. | eventHubDestination |
eventHubsDirect | Event Hubs Direct 대상 목록입니다. | eventHubDirectDestination |
logAnalytics | Log Analytics 대상 목록입니다. | logAnalyticsDestination |
microsoftFabric | Microsoft Fabric 대상 목록입니다. | microsoftFabricDestination |
monitoringAccounts | 모니터링 계정 대상 목록입니다. | MonitoringAccountDestination[] |
storageAccounts | 스토리지 계정 대상 목록입니다. | StorageBlobDestination[] |
storageBlobsDirect | Storage Blob Direct 대상 목록입니다. 에이전트에서 저장하기 위해 직접 데이터를 보내는 데만 사용됩니다. | StorageBlobDestination[] |
storageTablesDirect | 스토리지 테이블 다이렉트 대상 목록입니다. | storageTableDestination |
AdxDestination
이름 | 묘사 | 값 |
---|---|---|
databaseName | 데이터를 수집할 데이터베이스의 이름입니다. | 문자열 |
이름 | 대상의 이름입니다. 이 이름은 데이터 수집 규칙 내의 모든 대상(형식에 관계없이)에서 고유해야 합니다. |
문자열 |
resourceId | Adx 리소스의 ARM 리소스 ID입니다. | 문자열 |
DestinationsSpecAzureMonitorMetrics
이름 | 묘사 | 값 |
---|---|---|
이름 | 대상의 이름입니다. 이 이름은 데이터 수집 규칙 내의 모든 대상(형식에 관계없이)에서 고유해야 합니다. |
문자열 |
EventHubDestination
이름 | 묘사 | 값 |
---|---|---|
eventHubResourceId | 이벤트 허브의 리소스 ID입니다. | 문자열 |
이름 | 대상의 이름입니다. 이 이름은 데이터 수집 규칙 내의 모든 대상(형식에 관계없이)에서 고유해야 합니다. |
문자열 |
EventHubDirectDestination
이름 | 묘사 | 값 |
---|---|---|
eventHubResourceId | 이벤트 허브의 리소스 ID입니다. | 문자열 |
이름 | 대상의 이름입니다. 이 이름은 데이터 수집 규칙 내의 모든 대상(형식에 관계없이)에서 고유해야 합니다. |
문자열 |
LogAnalyticsDestination
이름 | 묘사 | 값 |
---|---|---|
이름 | 대상의 이름입니다. 이 이름은 데이터 수집 규칙 내의 모든 대상(형식에 관계없이)에서 고유해야 합니다. |
문자열 |
workspaceResourceId | Log Analytics 작업 영역의 리소스 ID입니다. | 문자열 |
MicrosoftFabricDestination
이름 | 묘사 | 값 |
---|---|---|
artifactId | Microsoft Fabric 리소스의 아티팩트 ID입니다. | 문자열 |
databaseName | 데이터를 수집할 데이터베이스의 이름입니다. | 문자열 |
ingestionUri | Microsoft Fabric 리소스의 수집 URI입니다. | 문자열 |
이름 | 대상의 이름입니다. 이 이름은 데이터 수집 규칙 내의 모든 대상(형식에 관계없이)에서 고유해야 합니다. |
문자열 |
tenantId | Microsoft Fabric 리소스의 테넌트 ID입니다. | 문자열 |
MonitoringAccountDestination
이름 | 묘사 | 값 |
---|---|---|
accountResourceId | 모니터링 계정의 리소스 ID입니다. | 문자열 |
이름 | 대상의 이름입니다. 이 이름은 데이터 수집 규칙 내의 모든 대상(형식에 관계없이)에서 고유해야 합니다. |
문자열 |
StorageBlobDestination
이름 | 묘사 | 값 |
---|---|---|
containerName | Storage Blob의 컨테이너 이름입니다. | 문자열 |
이름 | 대상의 이름입니다. 이 이름은 데이터 수집 규칙 내의 모든 대상(형식에 관계없이)에서 고유해야 합니다. |
문자열 |
storageAccountResourceId | 스토리지 계정의 리소스 ID입니다. | 문자열 |
StorageTableDestination
이름 | 묘사 | 값 |
---|---|---|
이름 | 대상의 이름입니다. 이 이름은 데이터 수집 규칙 내의 모든 대상(형식에 관계없이)에서 고유해야 합니다. |
문자열 |
storageAccountResourceId | 스토리지 계정의 리소스 ID입니다. | 문자열 |
tableName | 스토리지 테이블의 이름입니다. | 문자열 |
DataCollectionRuleReferences
이름 | 묘사 | 값 |
---|---|---|
enrichmentData | 데이터 흐름에서 참조되는 모든 보강 데이터 원본 | ReferencesSpecEnrichmentData |
ReferencesSpecEnrichmentData
이름 | 묘사 | 값 |
---|---|---|
storageBlobs | 보강 데이터 원본으로 사용되는 모든 스토리지 Blob | StorageBlob |
StorageBlob
이름 | 묘사 | 값 |
---|---|---|
blobUrl | 스토리지 Blob의 URL | 문자열 |
lookupType | Blob에서 수행할 조회 유형 | "Cidr" "String" |
이름 | 데이터 흐름에서 이 데이터 원본을 참조할 때 별칭으로 사용되는 보강 데이터 원본의 이름입니다. | 문자열 |
resourceId | Blob을 호스트하는 스토리지 계정의 리소스 ID | 문자열 |
DataCollectionRuleStreamDeclarations
이름 | 묘사 | 값 |
---|---|---|
{customized property} | StreamDeclaration |
StreamDeclaration
이름 | 묘사 | 값 |
---|---|---|
열 | 이 스트림의 데이터에서 사용하는 열 목록입니다. | ColumnDefinition[] |
ColumnDefinition
이름 | 묘사 | 값 |
---|---|---|
이름 | 열의 이름입니다. | 문자열 |
형 | 열 데이터의 형식입니다. | "boolean" "datetime" "동적" "int" "long" "real" "string" |