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

Azure Monitor에서 DCR(데이터 수집 규칙)을 만드는 방법에는 여러 가지가 있습니다. 경우에 따라 Azure Monitor는 Azure Portal에서 구성하는 설정에 따라 DCR을 만들고 관리합니다. 이러한 경우 중 일부에서 DCR로 작업하고 있다는 사실을 깨닫지 못할 수도 있습니다. 하지만 다른 시나리오의 경우 JSON에서 정의로 직접 작업하여 사용자 고유의 DCR을 만들거나 기존 DCR을 편집해야 할 수 있습니다. 이 문서에서는 DCR을 만들기 위한 다양한 방법 및 편집 및 문제 해결에 대한 권장 사항을 설명합니다.

사용 권한

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

Azure Portal을 사용하여 DCR 만들기 또는 편집

Azure Portal은 특정 시나리오에 대한 DCR을 만들기 위한 간소화된 환경을 제공합니다. 이 메서드를 사용하면 수행할 수 있는 구성이 제한될 수 있지만 DCR의 구조를 이해할 필요가 없으며 나중에 DCR 정의를 편집하여 변환과 같은 고급 기능을 구현해야 할 수도 있습니다. 환경은 각 시나리오에 따라 달라지므로 다음 표에 설명된 대로 작업 중인 특정 시나리오에 대한 설명서를 참조하세요.

DCR 정의

생성 방법에 관계없이 각 DCR에는 표준 JSON 스키마를 따르는 정의가 있습니다. Azure Portal 이외의 메서드를 사용하여 DCR을 만들거나 편집하려면 해당 JSON 정의를 사용하여 직접 작업해야 합니다. 일부 시나리오에서는 Azure Portal에서 필요에 따라 DCR을 구성하는 방법을 제공하지 않으므로 JSON 정의를 사용해야 합니다.

개요 메뉴에서 JSON 보기를 클릭하여 Azure Portal에서 DCR에 대한 JSON을 볼 수 있습니다.

API 버전 드롭다운에서 최신 버전의 API가 선택되어 있는지 확인합니다. 그렇지 않은 경우 일부 JSON이 표시되지 않을 수 있습니다.

DCR REST API를 호출하여 DCR에 대한 JSON을 검색할 수도 있습니다. 예를 들어 다음 PowerShell 스크립트는 DCR에 대한 JSON을 검색하여 파일에 저장합니다.

$ResourceId = "<ResourceId>" # Resource ID of the DCR to edit
$FilePath = "<FilePath>" # File to store DCR content
$DCR = Invoke-AzRestMethod -Path ("$ResourceId"+"?api-version=2023-03-11") -Method GET
$DCR.Content | ConvertFrom-Json | ConvertTo-Json -Depth 20 | Out-File -FilePath $FilePath

JSON을 사용하여 DCR 만들기 또는 편집

기존 DCR을 편집하는 것 외에도 몇 가지 일반적인 시나리오에 JSON을 제공하는 샘플 DCR 중 하나를 사용하여 새 DCR 을 만들 수 있습니다. 특정 환경 및 요구 사항에 맞게 JSON 파일을 수정하려면 Azure Monitor의 데이터 수집 규칙 구조의 정보를 사용합니다.

DCR의 정의가 있으면 Azure Portal, CLI, PowerShell, API 또는 ARM 템플릿을 사용하여 Azure Monitor에 배포할 수 있습니다.

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

New-AzDataCollectionRule -Name 'my-dcr' -ResourceGroupName 'my-resource-group' -JsonFilePath 'C:\MyNewDCR.json'

$ResourceId = "/subscriptions/ffffffff-eeee-dddd-cccc-bbbbbbbbbbb0/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/ffffffff-eeee-dddd-cccc-bbbbbbbbbbb0/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

{
    "$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을 편집하고 테스트하기 위한 전략

JSON 정의를 사용하여 DCR을 만들거나 편집할 때 원하는 기능을 얻기 위해 여러 업데이트를 수행해야 하는 경우가 많습니다. DCR을 업데이트하고, 예상한 결과를 얻지 못하면 문제를 해결한 다음, 추가 업데이트를 수행할 수 있는 효율적인 방법이 필요합니다. 쿼리가 예상대로 작동하는지 확인해야 하므로 DCR에 변환을 추가하는 경우 특히 그렇습니다. Azure Portal에서 직접 JSON을 편집할 수 없으므로 사용할 수 있는 몇 가지 전략은 다음과 같습니다.

로컬 파일을 DCR의 원본으로 사용

로컬 JSON 파일을 만들고 편집하는 DCR의 원본으로 사용하는 경우 항상 최신 버전의 DCR 정의에 액세스할 수 있습니다. GitHub 또는 Azure DevOps와 같은 버전 제어 도구를 사용하여 변경 내용을 관리하려는 경우에 이상적입니다. VS Code와 같은 편집기를 사용하여 DCR을 변경한 다음 명령줄 도구를 사용하여 위에서 설명한 대로 Azure Monitor에서 DCR을 업데이트할 수도 있습니다.

다음은 원본 파일에서 DCR에 변경 내용을 푸시하는 데 사용할 수 있는 샘플 PowerShell 스크립트입니다. 이렇게 하면 원본 파일이 Azure Monitor로 보내기 전에 유효한 JSON인지 확인합니다.

param (
    [Parameter(Mandatory = $true)][string]$ResourceId,  # Resource ID of the DCR
    [Parameter(Mandatory = $true)][string]$FilePath  # Path to the DCR JSON file to upload
)

# Read the DCR content from the file
Write-Host "Reading new DCR content from: $FilePath" -ForegroundColor Green
$DCRContent = Get-Content $FilePath -Raw

# Ensure the DCR content is valid JSON
try {
    $ParsedDCRContent = $DCRContent | ConvertFrom-Json
} catch {
    Write-Host "Invalid JSON content in file: $FilePath" -ForegroundColor Red
    exit 1
}

# Create or update the DCR in the specified resource group
Write-Host "Deploying DCR $ResourceId ..." -ForegroundColor Green
Invoke-AzRestMethod -Path ("$ResourceId"+"?api-version=2023-03-11") -Method PUT -Payload $DCRContent		

임시 파일에 DCR 콘텐츠 저장

로컬 파일에 DCR 정의가 없는 경우 Azure Monitor에서 정의를 검색하여 임시 파일에 저장할 수 있습니다. 그런 다음, 업데이트를 Azure Monitor에 푸시하기 전에 VS Code와 같은 편집기를 사용하여 파일을 편집할 수 있습니다.

다음은 Azure Monitor에서 기존 DCR을 편집하는 데 사용할 수 있는 샘플 PowerShell 스크립트입니다. 스크립트는 DCR 정의를 검색하고 VS Code를 시작하기 전에 임시 파일에 저장합니다. 변경 내용을 저장했음을 스크립트에 표시하면 DCR이 새 콘텐츠로 업데이트되고 임시 파일이 삭제됩니다.

param ([Parameter(Mandatory=$true)] $ResourceId)

# Get DCR content and save it to a local file
$FilePath = "temp.dcr"
$DCR = Invoke-AzRestMethod -Path ("$ResourceId"+"?api-version=2023-03-11") -Method GET
$DCR.Content | ConvertFrom-Json | ConvertTo-Json -Depth 20 | Out-File $FilePath

# Open DCR in code editor
code $FilePath | Wait-Process

{ 
	#write DCR content back from the file
	$DCRContent = Get-Content $FilePath -Raw
	Invoke-AzRestMethod -Path ("$ResourceId"+"?api-version=2023-03-11") -Method PUT -Payload $DCRContent		
}

#Delete temporary file
Remove-Item $FilePath

ARM 템플릿을 사용하여 DCR을 현재 위치에서 편집

Azure Portal에서 편집을 완전히 수행하려면 템플릿 내보내기 기능을 사용하여 DCR에 대한 ARM 템플릿을 검색할 수 있습니다. 그런 다음 JSON에서 정의를 수정하고 Azure Portal에서 다시 배포할 수 있습니다.

1. Azure Portal에서 수정할 DCR을 선택하고 템플릿 내보내기를 선택합니다. 그런 다음 배포를 클릭하여 동일한 템플릿을 다시 배포합니다.

   

2. 템플릿 편집을 클릭하여 DCR에 대한 편집 가능한 버전의 JSON을 엽니다. 매개 변수 값을 변경하지 마세요.

   

3. DCR에 필요한 내용을 변경한 다음 저장을 클릭합니다.

   

4. 새 DCR을 만들려면 이름 매개 변수를 변경합니다. 그렇지 않으면 매개 변수를 변경하지 않고 그대로 둡니다. 검토 + 만들기를 클릭하여 수정된 템플릿을 배포하고 만들기를 클릭하여 새 DCR을 만듭니다.

   

5. DCR이 오류 없이 유효하면 배포가 성공하고 DCR이 새 구성으로 업데이트됩니다. 리소스로 이동을 클릭하여 수정된 DCR을 엽니다.

   

6. DCR에 컴파일 오류가 있는 경우 배포에 실패했다는 메시지가 표시됩니다. 오류 세부 정보 및 작업 세부 정보를 클릭하여 오류 세부 정보를 봅니다. 다시 배포를 클릭한 다음 템플릿 편집을 다시 클릭하여 DCR에 필요한 변경 내용을 적용한 다음 다시 저장하고 배포합니다.

   

데이터 수집 확인 및 문제 해결

DCR을 설치한 후에는 변경 내용이 적용되고 업데이트된 DCR을 사용하여 데이터를 수집하는 데 몇 분 정도 걸릴 수 있습니다. 수집되는 데이터가 표시되지 않으면 문제의 근본 원인을 확인하기 어려울 수 있습니다. 메트릭 및 로그를 포함하는 DCR 모니터링 기능을 사용하여 문제를 해결합니다.

DCR 메트릭 은 모든 DCR에 대해 자동으로 수집되며 다른 Azure 리소스에 대한 플랫폼 메트릭과 같은 메트릭 탐색기를 사용하여 분석할 수 있습니다. 데이터 처리에 성공하지 못한 경우 DCR 오류 로그를 사용하여 자세한 오류 정보를 가져올 수 있습니다.

수집되는 데이터가 표시되지 않는 경우 다음 기본 단계에 따라 문제를 해결합니다.

1. 데이터가 Azure Monitor에 도달하는지 확인하려면 Logs Ingestion Bytes per Min 및 Logs Rows Received per Min과 같은 메트릭을 확인합니다. 그렇지 않은 경우 데이터 원본을 확인하여 예상대로 데이터가 전송되고 있는지 확인합니다.
2. 삭제되는 행이 있는지 확인하려면 Logs Rows Dropped per Min을 확인합니다. 변환에 의해 행이 삭제될 수 있으므로 이는 오류를 나타내지 않을 수 있습니다. 삭제된 행이 Logs Rows Dropped per Min과 동일하면 작업 영역에서 데이터가 수집되지 않습니다. 변환 오류가 있는지 확인하려면 Logs Transformation Errors per Min을 검사합니다.
3. 수신 데이터에 적용된 변환에 오류가 있는지 확인하려면 Logs Transformation Errors per Min을 확인합니다. 이는 데이터 구조 또는 변환 자체의 변경으로 인해 발생할 수 있습니다.
4. DCRLogErrors 기록되었을 수 있는 수집 오류가 있는지 테이블을 확인합니다. 이를 통해 문제의 근본 원인을 식별하는 데 추가 세부 정보를 제공할 수 있습니다.

다음 단계

• 데이터 컬렉션 규칙의 세부 구조에 대해 읽어보기
• 데이터 컬렉션 규칙의 변환에 대한 세부 정보 가져오기