Azure Monitor에서 DCR(데이터 수집 규칙) 만들기 및 편집

아티클
04/10/2024

Azure Monitor에서 DCR(데이터 수집 규칙)을 만드는 방법에는 여러 가지가 있습니다. 경우에 따라 Azure Monitor는 Azure Portal에서 구성하는 설정에 따라 DCR을 만들고 관리합니다. 다른 경우에는 특정 시나리오를 사용자 지정하기 위해 사용자 고유의 DCR을 만들어야 할 수도 있습니다.

이 문서에서는 DCR을 만들고 편집하는 다양한 방법을 설명합니다. DCR 자체의 내용은 Azure Monitor의 데이터 수집 규칙 구조를 참조하세요.

사용 권한

DCR 및 연결을 만들려면 다음 권한이 필요합니다.

기본 제공 역할	범위	원인
Monitoring Contributor	구독 및/또는 리소스 그룹 및/또는 기존 DCR	DCR을 만들기 또는 편집하고, 컴퓨터에 규칙을 할당하고, 연결을 배포합니다.
가상 머신 참가자 Azure Connected Machine 리소스 관리자	가상 머신, 가상 머신 확장 집합 Azure Arc 지원 서버	VM에 에이전트 확장을 배포합니다.
Microsoft.Resources/deployments/* 작업을 포함하는 모든 역할	구독 및/또는 리소스 그룹 및/또는 기존 DCR	Azure Resource Manager 템플릿을 배포합니다.

DCR을 만드는 자동화된 메서드

다음 표에서는 DCR이 만들어지는 Azure Portal을 사용하여 데이터 수집 시나리오를 만드는 방법을 나열합니다. 이러한 경우에는 DCR 자체와 직접 상호 작용할 필요가 없습니다.

시나리오	리소스	설명
Azure Monitor 에이전트	Azure Monitor 에이전트를 위한 데이터 수집 구성	Azure Portal을 사용하여 Azure Monitor 에이전트를 사용해서 컴퓨터에서 수집할 이벤트 및 성능 카운터를 지정하는 DCR을 만듭니다. 그런 다음, 해당 규칙을 하나 이상의 가상 머신과 연결합니다. Azure Monitor 에이전트가 현재 설치되어 있지 않은 컴퓨터에 설치됩니다.
	VM 인사이트 사용 개요	VM에서 VM 인사이트를 사용하도록 설정하면 Azure Monitor 에이전트가 설치되고 미리 정의된 성능 카운터 세트를 수집하는 DCR이 만들어집니다. 이 DCR은 수정하면 안 됩니다.
컨테이너 인사이트	컨테이너 인사이트를 사용하도록 설정	Kubernetes 클러스터에서 컨테이너 인사이트를 사용하도록 설정하면 컨테이너화된 버전의 Azure Monitor 에이전트가 설치되고 선택한 구성에 따라 데이터를 수집하는 DCR이 만들어집니다. 변환을 추가하려면 이 DCR을 수정해야 할 수도 있습니다.
텍스트 또는 JSON 로그	Azure Monitor 에이전트를 사용하여 텍스트 또는 JSON 파일에서 로그 수집	Azure Portal을 사용하여 Azure Monitor 에이전트가 있는 컴퓨터의 텍스트 로그에서 항목을 수집하는 DCR을 만듭니다.

수동으로 DCR 만들기

DCR을 수동으로 만들려면 구성하려는 데이터 컬렉션에 적절한 구성을 사용하여 JSON 파일을 만듭니다. 샘플 DCR 중 하나로 시작하고 Azure Monitor의 데이터 수집 규칙 구조에 있는 정보를 사용하여 특정 환경 및 요구 사항에 맞게 JSON 파일을 수정합니다.

JSON 파일을 만든 후에는 다음 방법 중 하나를 사용하여 DCR을 만들 수 있습니다.

다음 예제와 같이 az monitor data-collection rule create 명령을 사용하여 Azure CLI를 통해 JSON 파일에서 DCR을 만듭니다.

az monitor data-collection rule create --location 'eastus' --resource-group 'my-resource-group' --name 'myDCRName' --rule-file 'C:\MyNewDCR.json' --description 'This is my new DCR'

다음 예제와 같이 New-AzDataCollectionRule cmdlet을 사용하여 PowerShell을 통해 JSON 파일에서 DCR을 만듭니다.

New-AzDataCollectionRule -Location 'east-us' -ResourceGroupName 'my-resource-group' -RuleName 'myDCRName' -RuleFile 'C:\MyNewDCR.json' -Description 'This is my new DCR'

DCR 만들기 API를 사용하여 JSON 파일에서 DCR을 만듭니다. 다음 예제와 같이 임의의 메서드를 사용하여 REST API를 호출할 수 있습니다.

$ResourceId = "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/my-resource-group/providers/Microsoft.Insights/dataCollectionRules/my-dcr"
$FilePath = ".\my-dcr.json"
$DCRContent = Get-Content $FilePath -Raw 
Invoke-AzRestMethod -Path ("$ResourceId"+"?api-version=2022-06-01") -Method PUT -Payload $DCRContent

ResourceId="/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/my-resource-group/providers/Microsoft.Insights/dataCollectionRules/my-dcr"
FilePath="my-dcr.json"
az rest --method put --url $ResourceId"?api-version=2022-06-01" --body @$FilePath

템플릿에서 DCR 및 연결을 정의하려면 다음 참조를 참조하세요.

다음 템플릿을 사용하여 Azure Monitor의 데이터 수집 규칙 구조 및 Azure Monitor의 샘플 DCR(데이터 수집 규칙)의 정보를 사용하여 DCR을 만들어 dcr-properties을(를) 정의합니다.

{
    "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "dataCollectionRuleName": {
            "type": "string",
            "metadata": {
                "description": "Specifies the name of the Data Collection Rule to create."
            }
        },
        "location": {
            "type": "string",
            "metadata": {
                "description": "Specifies the location in which to create the Data Collection Rule."
            }
        }
    },
    "resources": [
        {
            "type": "Microsoft.Insights/dataCollectionRules",
            "name": "[parameters('dataCollectionRuleName')]",
            "location": "[parameters('location')]",
            "apiVersion": "2021-09-01-preview",
            "properties": {
                "<dcr-properties>"
            }
        }
    ]
}

DCR 연결 -Azure VM

다음 샘플에서는 Azure 가상 머신과 데이터 수집 규칙 간에 연결을 만듭니다.

Bicep 템플릿 파일

@description('The name of the virtual machine.')
param vmName string

@description('The name of the association.')
param associationName string

@description('The resource ID of the data collection rule.')
param dataCollectionRuleId string

resource vm 'Microsoft.Compute/virtualMachines@2021-11-01' existing = {
  name: vmName
}

resource association 'Microsoft.Insights/dataCollectionRuleAssociations@2021-09-01-preview' = {
  name: associationName
  scope: vm
  properties: {
    description: 'Association of data collection rule. Deleting this association will break the data collection for this virtual machine.'
    dataCollectionRuleId: dataCollectionRuleId
  }
}

ARM 템플릿 파일

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "vmName": {
      "type": "string",
      "metadata": {
        "description": "The name of the virtual machine."
      }
    },
    "associationName": {
      "type": "string",
      "metadata": {
        "description": "The name of the association."
      }
    },
    "dataCollectionRuleId": {
      "type": "string",
      "metadata": {
        "description": "The resource ID of the data collection rule."
      }
    }
  },
  "resources": [
    {
      "type": "Microsoft.Insights/dataCollectionRuleAssociations",
      "apiVersion": "2021-09-01-preview",
      "scope": "[format('Microsoft.Compute/virtualMachines/{0}', parameters('vmName'))]",
      "name": "[parameters('associationName')]",
      "properties": {
        "description": "Association of data collection rule. Deleting this association will break the data collection for this virtual machine.",
        "dataCollectionRuleId": "[parameters('dataCollectionRuleId')]"
      }
    }
  ]
}

매개 변수 파일

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentParameters.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "vmName": {
      "value": "my-azure-vm"
    },
    "associationName": {
      "value": "my-windows-vm-my-dcr"
    },
    "dataCollectionRuleId": {
      "value": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/my-resource-group/providers/microsoft.insights/datacollectionrules/my-dcr"
    }
   }
}

DCR 연결 -Arc 지원 서버

다음 샘플에서는 Azure Arc 사용 서버와 데이터 수집 규칙 간에 연결을 만듭니다.

Bicep 템플릿 파일

@description('The name of the virtual machine.')
param vmName string

@description('The name of the association.')
param associationName string

@description('The resource ID of the data collection rule.')
param dataCollectionRuleId string

resource vm 'Microsoft.HybridCompute/machines@2021-11-01' existing = {
  name: vmName
}

resource association 'Microsoft.Insights/dataCollectionRuleAssociations@2021-09-01-preview' = {
  name: associationName
  scope: vm
  properties: {
    description: 'Association of data collection rule. Deleting this association will break the data collection for this Arc server.'
    dataCollectionRuleId: dataCollectionRuleId
  }
}

ARM 템플릿 파일

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "vmName": {
      "type": "string",
      "metadata": {
        "description": "The name of the virtual machine."
      }
    },
    "associationName": {
      "type": "string",
      "metadata": {
        "description": "The name of the association."
      }
    },
    "dataCollectionRuleId": {
      "type": "string",
      "metadata": {
        "description": "The resource ID of the data collection rule."
      }
    }
  },
  "resources": [
    {
      "type": "Microsoft.Insights/dataCollectionRuleAssociations",
      "apiVersion": "2021-09-01-preview",
      "scope": "[format('Microsoft.HybridCompute/machines/{0}', parameters('vmName'))]",
      "name": "[parameters('associationName')]",
      "properties": {
        "description": "Association of data collection rule. Deleting this association will break the data collection for this Arc server.",
        "dataCollectionRuleId": "[parameters('dataCollectionRuleId')]"
      }
    }
  ]
}

매개 변수 파일

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentParameters.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "vmName": {
      "value": "my-hybrid-vm"
    },
    "associationName": {
      "value": "my-windows-vm-my-dcr"
    },
    "dataCollectionRuleId": {
      "value": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/my-resource-group/providers/microsoft.insights/datacollectionrules/my-dcr"
    }
   }
}

DCR 편집

DCR을 편집하려면 이전 섹션에서 설명한 메서드 중 하나를 사용하여 수정된 버전의 JSON을 통해 DCR을 만들 수 있습니다.

기존 DCR에 대한 JSON을 검색해야 하는 경우 Azure Portal의 DCR에 대한 JSON 뷰에서 복사할 수 있습니다. 다음 PowerShell 예제와 같이 API 호출을 사용하여 검색할 수도 있습니다.

$ResourceId = "<ResourceId>" # Resource ID of the DCR to edit
$FilePath = "<FilePath>" # Store DCR content in this file
$DCR = Invoke-AzRestMethod -Path ("$ResourceId"+"?api-version=2022-06-01") -Method GET
$DCR.Content | ConvertFrom-Json | ConvertTo-Json -Depth 20 | Out-File -FilePath $FilePath

기존 DCR을 검색한 다음, 편집하는 과정을 안내하는 자습서는 자습서: DCR(데이터 수집 규칙) 편집을 참조하세요.