Membuat dan mengedit aturan pengumpulan data (DCR) di Azure Monitor

Artikel
04/04/2024

Ada beberapa metode untuk membuat aturan pengumpulan data (DCR) di Azure Monitor. Dalam beberapa kasus, Azure Monitor akan membuat dan mengelola DCR sesuai dengan pengaturan yang Anda konfigurasi di portal Azure. Dalam kasus lain, Anda mungkin perlu membuat DCR Anda sendiri untuk menyesuaikan skenario tertentu.

Artikel ini menjelaskan berbagai metode untuk membuat dan mengedit DCR. Untuk konten DCR itu sendiri, lihat Struktur aturan pengumpulan data di Azure Monitor.

Izin

Anda memerlukan izin berikut untuk membuat DCR dan asosiasi:

Peran bawaan	Cakupan	Alasan
Kontributor Pemantauan	Berlangganan dan/atau Grup sumber daya dan/atau DCR yang ada	Buat atau edit DCR, tetapkan aturan ke komputer, sebarkan asosiasi.
Kontributor Komputer Virtual Administrator Sumber Daya Komputer Yang Terhubung Azure	Mesin virtual, set skala mesin virtual Server dengan Azure Arc yang diaktifkan	Menyebarkan ekstensi agen pada VM.
Peran apa pun yang menyertakan tindakan Microsoft.Resources/deployments/*	Berlangganan dan/atau Grup sumber daya dan/atau DCR yang ada	Menyebarkan templat Azure Resource Manager.

Metode otomatis untuk membuat DCR

Tabel berikut mencantumkan metode untuk membuat skenario pengumpulan data menggunakan portal Azure tempat DCR dibuat untuk Anda. Dalam kasus ini, Anda tidak perlu berinteraksi langsung dengan DCR itu sendiri.

Skenario	Sumber	Deskripsi
Agen Azure Monitor	Mengonfigurasi pengumpulan data untuk Agen Azure Monitor	Gunakan portal Azure untuk membuat DCR yang menentukan peristiwa dan penghitung kinerja untuk dikumpulkan dari komputer dengan Agen Azure Monitor. Kemudian kaitkan aturan tersebut dengan satu atau beberapa komputer virtual. Agen Azure Monitor akan diinstal pada komputer apa pun yang saat ini tidak memilikinya.
	Mengaktifkan gambaran umum wawasan VM	Saat Anda mengaktifkan wawasan VM pada VM, agen Azure Monitor diinstal, dan DCR dibuat yang mengumpulkan serangkaian penghitung kinerja yang telah ditentukan sebelumnya. Anda tidak boleh mengubah DCR ini.
Wawasan kontainer	Mengaktifkan wawasan Kontainer	Saat Anda mengaktifkan wawasan Kontainer pada kluster Kubernetes, versi kontainer agen Azure Monitor diinstal, dan DCR dibuat yang mengumpulkan data sesuai dengan konfigurasi yang Anda pilih. Anda mungkin perlu mengubah DCR ini untuk menambahkan transformasi.
Teks atau log JSON	Mengumpulkan log dari teks atau file JSON dengan Agen Azure Monitor	Gunakan portal Azure untuk membuat DCR untuk mengumpulkan entri dari log teks di komputer dengan Agen Azure Monitor.

Membuat DCR secara manual

Untuk membuat DCR secara manual, buat file JSON menggunakan konfigurasi yang sesuai untuk pengumpulan data yang Anda konfigurasikan. Mulailah dengan salah satu DCR sampel dan gunakan informasi dalam Struktur aturan pengumpulan data di Azure Monitor untuk memodifikasi file JSON untuk lingkungan dan persyaratan tertentu Anda.

Setelah file JSON dibuat, Anda dapat menggunakan salah satu metode berikut untuk membuat DCR:

Gunakan perintah az monitor data-collection rule create untuk membuat DCR dari file JSON Anda menggunakan Azure CLI seperti yang ditunjukkan dalam contoh berikut.

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'

Gunakan cmdlet New-AzDataCollectionRule untuk membuat DCR dari file JSON Anda menggunakan PowerShell seperti yang ditunjukkan dalam contoh berikut.

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

Gunakan API buat DCR untuk membuat DCR dari file JSON Anda. Anda dapat menggunakan metode apa pun untuk memanggil REST API seperti yang ditunjukkan dalam contoh berikut.

$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

Lihat referensi berikut untuk menentukan DCR dan asosiasi dalam templat.

Gunakan templat berikut untuk membuat DCR menggunakan informasi dari Struktur aturan pengumpulan data di Azure Monitor dan Sampel aturan pengumpulan data (DCR) di Azure Monitor untuk menentukan 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>"
            }
        }
    ]
}

Asosiasi DCR -Azure VM

Sampel berikut membuat hubungan antara komputer virtual Azure dan aturan pengumpulan data.

File templat 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
  }
}

File templat 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')]"
      }
    }
  ]
}

File parameter

{
  "$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"
    }
   }
}

Asosiasi DCR -Server berkemampuan Arc

Sampel berikut membuat hubungan antara server yang diaktifkan Azure Arc dan aturan pengumpulan data.

File templat 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
  }
}

File templat 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')]"
      }
    }
  ]
}

File parameter

{
  "$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"
    }
   }
}

Mengedit DCR

Untuk mengedit DCR, Anda dapat menggunakan salah satu metode yang dijelaskan di bagian sebelumnya untuk membuat DCR menggunakan versi JSON yang dimodifikasi.

Jika Anda perlu mengambil JSON untuk DCR yang ada, Anda dapat menyalinnya dari Tampilan JSON untuk DCR di portal Azure. Anda juga dapat mengambilnya menggunakan panggilan API seperti yang ditunjukkan dalam contoh PowerShell berikut.

$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

Untuk tutorial yang menelusuri proses pengambilan lalu mengedit DCR yang ada, lihat Tutorial: Mengedit aturan pengumpulan data (DCR).