Ekspor metrik menggunakan aturan pengumpulan data

Metrik platform mengukur performa berbagai aspek sumber daya Azure Anda. Telemetri platform data collection rules (DCR) memungkinkan Anda mengumpulkan dan mengekspor metrik platform dari sumber daya Azure yang didukung. Artikel ini memperlihatkan kepada Anda cara membuat DCR untuk ekspor metrik.

Nota

Meskipun Anda dapat menggunakan DCR dan pengaturan diagnostik secara bersamaan, Anda harus menonaktifkan pengaturan diagnostik apa pun untuk metrik saat menggunakan DCR untuk menghindari pengumpulan data duplikat.

Bandingkan dengan pengaturan diagnostik

Sebelum fitur ini, Anda hanya dapat mengekspor metrik platform dengan menggunakan pengaturan diagnostik. Pengaturan diagnostik masih diperlukan untuk jenis sumber daya yang belum mendukung DCR.

DCR telemetri platform memberikan beberapa manfaat dibandingkan dengan pengaturan diagnostik:

• Konfigurasi DCR memungkinkan ekspor metrik dengan dimensi.
• Konfigurasi DCR memungkinkan pemfilteran berdasarkan nama metrik sehingga Anda hanya dapat mengekspor metrik yang Anda butuhkan.
• DCR lebih fleksibel dan dapat diskalakan daripada pengaturan diagnostik. Gunakan satu DCR dengan beberapa sumber daya, sementara pengaturan diagnostik terpisah diperlukan untuk setiap sumber daya.
• Latensi end-to-end untuk DCR kurang dari tiga menit, sedangkan latensi ekspor pengaturan diagnostik berkisar antara enam hingga sepuluh menit.

Nota

Gunakan ekspor metrik bersama DCRs untuk secara terus menerus mengekspor data metrik saat data tersebut dibuat. Untuk mengkueri data historis yang sudah dikumpulkan, gunakan DATA plane Metrics Batch API. Lihat Kueri API Batch Metrik Data Plane versus ekspor Metrik untuk membandingkan kedua strategi.

Tujuan ekspor

Metrik dapat diekspor ke tujuan berikut.

Jenis tujuan	Detail lebih lanjut
Ruang Kerja Log Analytics	Mengekspor ke ruang kerja Analitik Log bisa dilakukan di berbagai wilayah. Ruang kerja Analitik Log dan DCR harus berada di wilayah yang sama tetapi sumber daya yang sedang dipantau dapat berada di wilayah mana pun. Metrik yang dikirim ke ruang kerja analitik log disimpan dalam AzureMetricsV2 tabel.
Akun Penyimpanan Azure	Akun penyimpanan, DCR, dan sumber daya yang dipantau semuanya harus berada di wilayah yang sama.
Pusat Aktivitas	Event Hubs, DCR, dan sumber daya yang dipantau semua harus berada di wilayah yang sama.

Nota

Latensi untuk mengekspor metrik adalah sekitar 3 menit. Izinkan hingga 15 menit agar metrik mulai muncul di tujuan setelah penyiapan awal.

Keterbatasan

DCR untuk ekspor metrik memiliki batasan berikut:

• Hanya satu jenis tujuan yang dapat ditentukan per DCR. Untuk mengirim ke beberapa tujuan, buat beberapa DCR.
• Maksimal 5 DCR dapat dikaitkan dengan satu sumber daya Azure.
• Ekspor metrik dengan DCR tidak mendukung ekspor metrik berbutir per jam.

Sumber daya dan wilayah yang didukung

Untuk daftar sumber daya yang didukung saat ini dan wilayah yang didukung, lihat Metrik mengekspor sumber daya dan wilayah yang didukung.

Membuat aturan pengumpulan data (DCR) untuk ekspor metrik

Artikel ini menjelaskan cara membuat aturan pengumpulan data (DCR) untuk ekspor metrik menggunakan templat portal Azure, Azure CLI, PowerShell, API, atau ARM.

Penting

Untuk mengirim data Telemetri Platform ke Akun Penyimpanan atau Event Hubs, sumber daya, aturan pengumpulan data, dan Akun Penyimpanan tujuan atau Event Hubs semuanya harus berada di wilayah yang sama.

Portal

Membuat aturan pengumpulan data menggunakan portal Microsoft Azure

1. Pada menu Monitor di portal Microsoft Azure, pilih Aturan Pengumpulan Data lalu Buat.

2. Pilih tautan di bagian atas halaman untuk menggunakan pengalaman pembuatan DCR baru.

   

3. Pada halaman Buat Aturan Pengumpulan Data, masukkan nama aturan, pilih Langganan, Grup sumber daya, dan Wilayah untuk DCR.

4. Pilih PlatformTelemetry untuk Jenis telemetri dan Aktifkan Identitas Terkelola jika Anda ingin mengirim metrik ke Akun Penyimpanan atau Azure Event Hubs.

   

5. Pada halaman Sumber Daya , pilih Tambahkan sumber daya untuk menambahkan sumber daya yang ingin Anda kumpulkan metriknya.

6. Pilih Berikutnya untuk berpindah ke tab Kumpulkan dan kirim .

   

7. Pilih Tambahkan sumber data baru.

8. Jenis sumber daya yang ditentukan di langkah sebelumnya dipilih secara otomatis. Tambahkan lebih banyak jenis sumber daya jika Anda ingin menggunakan aturan ini untuk mengumpulkan metrik dari beberapa jenis sumber daya di masa mendatang. Pilih Tindakan untuk jenis sumber daya jika Anda ingin menghapus beberapa metrik yang dikumpulkan untuk itu. Secara default, semua metrik yang tersedia untuk sumber daya dikumpulkan.

   

9. Pilih Tujuan Berikutnya untuk berpindah ke tab Tujuan .

10. Pilih Tambahkan tujuan lalu Jenis tujuan yang ingin Anda tambahkan. Bidang yang diperlukan berubah berdasarkan jenis tujuan yang Anda pilih.

    Nota

    Untuk mengirim metrik ke Akun Penyimpanan atau Azure Event Hubs, sumber daya yang menghasilkan metrik, DCR, dan Akun Penyimpanan atau Event Hub, semuanya harus berada di wilayah yang sama. Untuk mengirim metrik ke ruang kerja Analitik Log, DCR harus berada di wilayah yang sama dengan ruang kerja Analitik Log. Sumber daya yang menghasilkan metrik dapat berada di wilayah mana pun.

    

11. Pilih Simpan , lalu pilih Tinjau + buat.

Azure CLI

Membuat aturan pengumpulan data menggunakan Azure CLI

Buat file JSON yang berisi spesifikasi aturan koleksi. Untuk informasi selengkapnya, lihat Struktur aturan pengumpulan data (DCR) untuk ekspor metrik. Untuk contoh file JSON, lihat Objek JSON Ekspor Metrik Sampel.

Penting

File aturan memiliki format yang sama seperti yang digunakan untuk PowerShell dan REST API, namun file tidak boleh berisi identity, location, atau kind. Parameter ini ditentukan dalam az monitor data-collection rule create perintah .

Contoh Azure CLI berikut menggunakan perintah az monitor data-collection rule create.

subscriptionId="aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e"
resourceGroupName="myResourceGroup"
dataCollectionRuleName="myDataCollectionRule"
location="eastus"
ruleFile="./cli-dcr.json"

az account set --subscription "$subscriptionId"

az monitor data-collection rule create \
  --name "$dataCollectionRuleName" \
  --resource-group "$resourceGroupName" \
  --location "$location" \
  --kind PlatformTelemetry \
  --identity "{type:'SystemAssigned'}" \
  --rule-file "$ruleFile"

Nota

• perintah Azure CLI menggunakan titik akhir Azure Resource Manager dari konteks CLI saat ini, jadi management.azure.com tidak perlu ditentukan dalam sintaks perintah.

• Untuk akun penyimpanan dan tujuan Azure Event Hubs, Anda harus mengaktifkan identitas terkelola untuk DCR menggunakan --identity "{type:'SystemAssigned'}". Identitas tidak diperlukan untuk ruang kerja Analitik Log.

Salin id dan principalId dari DCR dari output berikut untuk digunakan saat menetapkan peran guna membuat asosiasi antara DCR dan sumber daya.

Output:

"id": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/myResourceGroup/providers/Microsoft.Insights/dataCollectionRules/myDataCollectionRule",
"identity": {
  "principalId": "eeeeeeee-ffff-aaaa-5555-666666666666",
  "tenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
  "type": "systemAssigned"
},

Berikan izin menulis ke identitas terkelola

Identitas terkelola yang digunakan oleh DCR harus memiliki izin tulis ke tujuan saat tujuannya adalah Akun Penyimpanan atau Azure Event Hubs. Untuk memberikan izin bagi identitas terkelola milik aturan, tetapkan peran yang sesuai kepada entitas.

Tabel berikut ini memperlihatkan peran yang diperlukan untuk setiap jenis tujuan:

Jenis tujuan	Peranan
Ruang Kerja Log Analytics	tidak diperlukan
Akun penyimpanan Azure	Storage Blob Data Contributor
Pusat Aktivitas	Azure Event Hubs Data Sender

Untuk informasi selengkapnya tentang menetapkan peran, lihat Menetapkan peran Azure ke identitas terkelola.

Untuk menetapkan peran ke identitas terkelola menggunakan CLI, gunakan az role assignment create. Untuk informasi selengkapnya, lihat Penetapan Peran - Buat.

Tetapkan peran yang sesuai ke identitas terkelola DCR. Contoh berikut menetapkan Storage Blob Data Contributor peran ke identitas terkelola DCR untuk akun penyimpanan.

Contoh Azure CLI berikut menggunakan perintah az role assignment create.

subscriptionId="aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e"
resourceGroupName="myResourceGroup"
storageAccountName="myStorageAccount"
principalId="eeeeeeee-ffff-aaaa-5555-666666666666"
roleDefinitionName="Storage Blob Data Contributor"
scope="/subscriptions/$subscriptionId/resourceGroups/$resourceGroupName/providers/Microsoft.Storage/storageAccounts/$storageAccountName"

az account set --subscription "$subscriptionId"

az role assignment create \
  --assignee "$principalId" \
  --role "$roleDefinitionName" \
  --scope "$scope"

Membuat asosiasi aturan pengumpulan data

Setelah Anda membuat aturan pengumpulan data, buat asosiasi aturan pengumpulan data (DCRA) untuk mengaitkan aturan dengan sumber daya yang akan dipantau. Untuk informasi selengkapnya, lihat Asosiasi Aturan Pengumpulan Data - Buat.

Contoh berikut menggunakan grup perintah az monitor data-collection rule association untuk create membuat asosiasi antara aturan pengumpulan data dan Key Vault.

subscriptionId="aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e"
resourceGroupName="myResourceGroup"
associationName="myAssociation"
dataCollectionRuleName="myDataCollectionRule"
keyVaultName="myKeyVault"
dataCollectionRuleId="/subscriptions/$subscriptionId/resourceGroups/$resourceGroupName/providers/Microsoft.Insights/dataCollectionRules/$dataCollectionRuleName"
resourceUri="/subscriptions/$subscriptionId/resourceGroups/$resourceGroupName/providers/Microsoft.KeyVault/vaults/$keyVaultName"

az account set --subscription "$subscriptionId"

az monitor data-collection rule association create \
  --name "$associationName" \
  --rule-id "$dataCollectionRuleId" \
  --resource "$resourceUri"

PowerShell

Membuat aturan pengumpulan data menggunakan PowerShell

Buat file JSON yang berisi spesifikasi aturan koleksi. Untuk informasi selengkapnya, lihat Struktur aturan pengumpulan data (DCR) untuk ekspor metrik. Untuk contoh file JSON, lihat Objek JSON Ekspor Metrik Sampel.

Contoh PowerShell berikut menggunakan cmdlet New-AzDataCollectionRule .

$subscriptionId = "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e"
$resourceGroupName = "myResourceGroup"
$dataCollectionRuleName = "myDataCollectionRule"
$jsonFilePath = ".\dcr-storage-account.json"

Set-AzContext -Subscription $subscriptionId

$dataCollectionRuleParams = @{
    Name              = $dataCollectionRuleName
    ResourceGroupName = $resourceGroupName
    JsonFilePath      = $jsonFilePath
}

New-AzDataCollectionRule @dataCollectionRuleParams

Salin id dan IdentityPrincipalId dari DCR dari output berikut untuk digunakan saat menetapkan peran guna membuat asosiasi antara DCR dan sumber daya.

Output:

Id                                        : /subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/myResourceGroup/providers/Microsoft.Insights/dataCollectionRules/myDataCollectionRule
IdentityPrincipalId                       : eeeeeeee-ffff-aaaa-5555-666666666666
IdentityTenantId                          : aaaabbbb-0000-cccc-1111-dddd2222eeee
IdentityType                              : systemAssigned
IdentityUserAssignedIdentity              : {
                                            }

Berikan izin menulis ke identitas terkelola

Identitas terkelola yang digunakan oleh DCR harus memiliki izin tulis ke tujuan saat tujuannya adalah Akun Penyimpanan atau Azure Event Hubs. Untuk memberikan izin bagi identitas terkelola milik aturan, tetapkan peran yang sesuai kepada entitas.

Tabel berikut ini memperlihatkan peran yang diperlukan untuk setiap jenis tujuan:

Jenis tujuan	Peranan
Ruang Kerja Log Analytics	tidak diperlukan
Akun penyimpanan Azure	Storage Blob Data Contributor
Pusat Aktivitas	Azure Event Hubs Data Sender

Untuk informasi selengkapnya, lihat Menetapkan peran Azure ke identitas terkelola.

Tetapkan peran yang sesuai untuk identitas terkelola dari DCR dengan menggunakan New-AzRoleAssignment. Contoh berikut menetapkan peran Azure Event Hubs Data Sender ke identitas terkelola DCR pada tingkat langganan.

Contoh PowerShell berikut menggunakan cmdlet New-AzRoleAssignment .

$objectId = "eeeeeeee-ffff-aaaa-5555-666666666666"
$roleDefinitionName = "Azure Event Hubs Data Sender"
$subscriptionId = "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e"
$scope = "/subscriptions/$subscriptionId"

Set-AzContext -Subscription $subscriptionId

$roleAssignmentParams = @{
    ObjectId           = $objectId
    RoleDefinitionName = $roleDefinitionName
    Scope              = $scope
}

New-AzRoleAssignment @roleAssignmentParams

Membuat asosiasi aturan pengumpulan data

Setelah Anda membuat aturan pengumpulan data, buat asosiasi aturan pengumpulan data (DCRA) untuk mengaitkan aturan dengan sumber daya yang akan dipantau. Gunakan New-AzDataCollectionRuleAssociation untuk membuat hubungan antara aturan pengumpulan data dan sumber daya. Untuk informasi selengkapnya, lihat New-AzDataCollectionRuleAssociation.

Contoh PowerShell berikut menggunakan cmdlet New-AzDataCollectionRuleAssociation untuk membuat hubungan antara aturan pengumpulan data dan Key Vault.

$subscriptionId = "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e"
$resourceGroupName = "myResourceGroup"
$associationName = "myDataCollectionRuleAssociation"
$keyVaultName = "myKeyVault"
$dataCollectionRuleName = "myDataCollectionRule"
$resourceUri = "/subscriptions/$subscriptionId/resourceGroups/$resourceGroupName/providers/Microsoft.KeyVault/vaults/$keyVaultName"
$dataCollectionRuleId = "/subscriptions/$subscriptionId/resourceGroups/$resourceGroupName/providers/Microsoft.Insights/dataCollectionRules/$dataCollectionRuleName"

Set-AzContext -Subscription $subscriptionId

$dataCollectionRuleAssociationParams = @{
    AssociationName      = $associationName
    ResourceUri          = $resourceUri
    DataCollectionRuleId = $dataCollectionRuleId
}

New-AzDataCollectionRuleAssociation @dataCollectionRuleAssociationParams

SISANYA

Membuat aturan pengumpulan data untuk metrik memerlukan langkah-langkah berikut:

1. Buat aturan pengumpulan data.
2. Berikan izin agar identitas terkelola milik aturan dapat menulis ke tujuan.
3. Membuat asosiasi aturan pengumpulan data.

Membuat aturan pengumpulan data

Untuk membuat DCR menggunakan REST API, Anda harus membuat permintaan terautentikasi menggunakan token pembawa. Untuk informasi selengkapnya tentang mengautentikasi dengan Azure Monitor, lihat Mengautentikasi permintaan Azure Monitor.

Gunakan titik akhir berikut untuk membuat aturan pengumpulan data untuk metrik menggunakan REST API. Untuk informasi selengkapnya, lihat Aturan Pengumpulan Data - Buat.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/dataCollectionRules/{dataCollectionRuleName}?api-version={apiVersion}
Authorization: Bearer {accessToken}
Content-Type: application/json

Payload adalah objek JSON yang mendefinisikan aturan koleksi. Muatan dikirim dalam isi permintaan. Untuk informasi selengkapnya tentang struktur JSON, lihat Struktur aturan pengumpulan data (DCR) untuk ekspor metrik. Untuk contoh objek JSON DCR, lihat Objek JSON Ekspor Metrik Sampel.

Berikan izin menulis ke identitas terkelola

Identitas terkelola yang digunakan oleh DCR harus memiliki izin tulis ke tujuan saat tujuannya adalah Akun Penyimpanan atau Azure Event Hubs. Untuk memberikan izin bagi identitas terkelola milik aturan, tetapkan peran yang sesuai kepada entitas.

Tabel berikut ini memperlihatkan peran yang diperlukan untuk setiap jenis tujuan:

Jenis tujuan	Peranan
Ruang Kerja Log Analytics	tidak diperlukan
Akun penyimpanan Azure	Storage Blob Data Contributor
Pusat Aktivitas	Azure Event Hubs Data Sender

Untuk informasi selengkapnya, lihat Menetapkan peran Azure ke identitas terkelola.

Untuk menetapkan peran ke identitas terkelola menggunakan REST, lihat Penetapan Peran - Buat.

Membuat asosiasi aturan pengumpulan data

Setelah Anda membuat aturan pengumpulan data, buat asosiasi aturan pengumpulan data (DCRA) untuk mengaitkan aturan dengan sumber daya yang akan dipantau. Untuk informasi selengkapnya, lihat Asosiasi Aturan Pengumpulan Data - Buat

Untuk membuat DCRA menggunakan REST API, gunakan titik akhir dan payload berikut:

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{virtualMachineName}/providers/Microsoft.Insights/dataCollectionRuleAssociations/{associationName}?api-version={apiVersion}
Authorization: Bearer {accessToken}
Content-Type: application/json

{
  "properties": {
    "description": "Association of platform telemetry DCR with VM myVirtualMachine",
    "dataCollectionRuleId": "/subscriptions/<subscriptionId>/resourceGroups/<resourceGroupName>/providers/Microsoft.Insights/dataCollectionRules/<dataCollectionRuleName>"
  }
}

Bicep

Membuat aturan pengumpulan data menggunakan templat Bicep

Gunakan templat berikut untuk membuat DCR. Untuk informasi selengkapnya, lihat Microsoft.Insights dataCollectionRules.

@description('Specifies the name of the Data Collection Rule to create.')
param dataCollectionRuleName string

@description('Specifies the Log Analytics workspace.')
param workspaceId string

@description('Specifies the location in which to create the Data Collection Rule.')
param location string

resource dataCollectionRule 'Microsoft.Insights/dataCollectionRules@2024-03-11' = {
  name: dataCollectionRuleName
  kind: 'PlatformTelemetry'
  identity: {
    type: 'UserAssigned' | 'SystemAssigned'
    userAssignedIdentities: {
      type: 'string'
    }
  }
  location: location
  properties: {
    dataSources: {
      platformTelemetry: [
        {
          streams: [
            '<resourceType>:<metricName> | Metrics-Group-All'
          ]
          name: 'myPlatformTelemetryDataSource'
        }
      ]
    }
    destinations: {
      logAnalytics: [
        {
          workspaceResourceId: workspaceId
          name: 'myDestination'
        }
      ]
    }
    dataFlows: [
      {
        streams: [
          '<resourceType>:<metricName> | Metrics-Group-All'
        ]
        destinations: [
          'myDestination'
        ]
      }
    ]
  }
}

Berkas parameter

using './<template-name>.bicep'

param dataCollectionRuleName = 'myDataCollectionRule'

param workspaceId = '/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/myResourceGroup/providers/microsoft.operationalinsights/workspaces/myWorkspace'

param location = 'eastus'

Contoh templat DCR

@description('Specifies the name of the Data Collection Rule to create.')
param dataCollectionRuleName string

@description('Specifies the Log Analytics workspace.')
param workspaceId string

@description('Specifies the location in which to create the Data Collection Rule.')
param location string

resource dataCollectionRule 'Microsoft.Insights/dataCollectionRules@2024-03-11' = {
  name: dataCollectionRuleName
  location: location
  kind: 'PlatformTelemetry'
  identity: {
    type: 'SystemAssigned'
  }
  properties: {
    dataSources: {
      platformTelemetry: [
        {
          streams: [
            'Microsoft.Compute/virtualMachines:Metrics-Group-All'
            'Microsoft.Compute/virtualMachineScaleSets:Metrics-Group-All'
            'Microsoft.Cache/redis:Metrics-Group-All'
            'Microsoft.keyvault/vaults:Metrics-Group-All'
          ]
          name: 'myPlatformTelemetryDataSource'
        }
      ]
    }
    destinations: {
      logAnalytics: [
        {
          workspaceResourceId: workspaceId
          name: 'myDestination'
        }
      ]
    }
    dataFlows: [
      {
        streams: [
          'Microsoft.Compute/virtualMachines:Metrics-Group-All'
          'Microsoft.Compute/virtualMachineScaleSets:Metrics-Group-All'
          'Microsoft.Cache/redis:Metrics-Group-All'
          'Microsoft.keyvault/vaults:Metrics-Group-All'
        ]
        destinations: [
          'myDestination'
        ]
      }
    ]
  }
}

ARM (JSON)

Membuat aturan pengumpulan data menggunakan templat ARM

Gunakan templat berikut untuk membuat DCR. Untuk informasi selengkapnya, lihat Microsoft.Insights dataCollectionRules.

{
  "$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."
      }
    },
    "workspaceId": {
      "type": "string",
      "metadata": {
        "description": "Specifies the Log Analytics workspace."
      }
    },
    "location": {
      "type": "string",
      "metadata": {
        "description": "Specifies the location in which to create the Data Collection Rule."
      }
    }
  },
  "resources": [
    {
      "type": "Microsoft.Insights/dataCollectionRules",
      "name": "[parameters('dataCollectionRuleName')]",
      "kind": "PlatformTelemetry",
      "identity": {
        "type": "UserAssigned" | "SystemAssigned",
        "userAssignedIdentities": {
          "type": "string"
        }
      },
      "location": "[parameters('location')]",
      "apiVersion": "2024-03-11",
      "properties": {
        "dataSources": {
          "platformTelemetry": [
            {
              "streams": [
                "<resourceType>:<metricName> | Metrics-Group-All"
              ],
              "name": "myPlatformTelemetryDataSource"
            }
          ]
        },
        "destinations": {
          "logAnalytics": [
            {
              "workspaceResourceId": "[parameters('workspaceId')]",
              "name": "myDestination"
            }
          ]
        },
        "dataFlows": [
          {
            "streams": [
              "<resourceType>:<metricName> | Metrics-Group-All"
            ],
            "destinations": [
              "myDestination"
            ]
          }
        ]
      }
    }
  ]
}

Berkas parameter

{
  "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentParameters.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "dataCollectionRuleName": {
      "value": "myDataCollectionRule"
    },
    "workspaceId": {
      "value": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/myResourceGroup/providers/microsoft.operationalinsights/workspaces/myWorkspace"
    },
    "location": {
      "value": "eastus"
    }
  }
}

Contoh templat DCR

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "resources": [
    {
      "type": "Microsoft.Insights/dataCollectionRules",
      "apiVersion": "2024-03-11",
      "name": "[parameters('dataCollectionRuleName')]",
      "location": "[parameters('location')]",
      "kind": "PlatformTelemetry",
      "identity": {
        "type": "SystemAssigned"
      },
      "properties": {
        "dataSources": {
          "platformTelemetry": [
            {
              "streams": [
                "Microsoft.Compute/virtualMachines:Metrics-Group-All",
                "Microsoft.Compute/virtualMachineScaleSets:Metrics-Group-All",
                "Microsoft.Cache/redis:Metrics-Group-All",
                "Microsoft.keyvault/vaults:Metrics-Group-All"
              ],
              "name": "myPlatformTelemetryDataSource"
            }
          ]
        },
        "destinations": {
          "logAnalytics": [
            {
              "workspaceResourceId": "[parameters('workspaceId')]",
              "name": "myDestination"
            }
          ]
        },
        "dataFlows": [
          {
            "streams": [
              "Microsoft.Compute/virtualMachines:Metrics-Group-All",
              "Microsoft.Compute/virtualMachineScaleSets:Metrics-Group-All",
              "Microsoft.Cache/redis:Metrics-Group-All",
              "Microsoft.keyvault/vaults:Metrics-Group-All"
            ],
            "destinations": [
              "myDestination"
            ]
          }
        ]
      }
    }
  ]
}

Variabel	Contoh nilai	Kegunaan
host	management.azure.com	Titik akhir ARM implisit
subscriptionId	aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e	Masukan pengguna
resourceGroupName	myResourceGroup	Masukan pengguna
dataCollectionRuleName	myDataCollectionRule	Masukan pengguna
associationName	myAssociation	Masukan pengguna
lokasi	eastus	Masukan pengguna
namaRuangKerja	myWorkspace	Masukan pengguna
keyVaultName	myKeyVault	Masukan pengguna
storageAccountName	myStorageAccount	Masukan pengguna
monitoredResourceName	myKeyVault	Masukan pengguna
apiVersion	2024-03-11	Referensi

Memverifikasi pengumpulan data

Setelah membuat DCR, izinkan hingga 30 menit agar data metrik platform pertama muncul di ruang kerja Log Analytics. Setelah data mulai mengalir, latensi untuk deret waktu metrik platform yang mengalir ke ruang kerja Log Analytics, akun penyimpanan, atau Event Hubs adalah sekitar tiga menit, bergantung pada jenis sumber daya.

Data yang diekspor

Contoh berikut menunjukkan data yang diekspor ke setiap tujuan.

Ruang Kerja Log Analytics

Data yang diekspor ke ruang kerja Analitik Log disimpan dalam AzureMetricsV2 tabel di ruang kerja Analitik Log dalam format berikut:

kolom	Tipe	Description
Average	nyata / asli	Nilai rata-rata yang dikumpulkan selama dalam rentang waktu.
_ UkuranTagihan	nyata / asli	Ukuran rekaman dalam bita
Jumlah	nyata / asli	Jumlah sampel yang dikumpulkan selama rentang waktu.
Dimensi	dynamic	Dimensi metrik yang terkait dalam format JSON.
_DapatDibayar	string	Menentukan apakah memasukkan data berpotensi menghasilkan tagihan. Jika _IsBillable adalah false, penyerapan tidak akan ditagihkan ke akun Azure Anda.
Maximum	nyata / asli	Nilai maksimum yang dikumpulkan selama dalam rentang waktu.
MetricCategory	string	Nama kategori metrik.
Nama Metrik	string	Nama tampilan metrik.
JenisSumberDayaMetrik	string	Jenis sumber daya dari sumber daya Azure yang melaporkan metrik.
Sekurang-kurangnya	nyata / asli	Nilai minimum yang dikumpulkan selama dalam rentang waktu.
_ResourceId	string	Sebuah pengenal unik untuk sumber daya yang terkait dengan catatan tersebut.
SourceSystem	string	Jenis agen yang mengumpulkan data peristiwa. Sebagai contoh, OpsManager untuk agen Windows, baik dengan koneksi langsung maupun menggunakan Manajer Operasional, Linux untuk semua agen Linux, atau Azure untuk Azure Diagnostics.
_LanggananID	string	Sebuah pengenal unik untuk langganan yang terkait dengan rekaman tersebut.
ID Penyewa	string	ID Log Analytics untuk ruang kerja
TimeGenerated	tanggalwaktu	Tanda waktu (UTC) ketika rekaman dibuat.
TimeGrain	string	Tingkat ketelitian waktu metrik.
Total	nyata / asli	Jumlah semua nilai dalam rentang waktu.
Tipe	string	Nama dari tabel
UnitName	string	Satuan dari metrik.

Contohnya:

Akun penyimpanan

Contoh berikut menunjukkan data yang diekspor ke akun penyimpanan:

{
  "Average": "31.5",
  "Count": "2",
  "Maximum": "52",
  "Minimum": "11",
  "Total": "63",
  "resourceId": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourcegroups/rg-dcrs/providers/microsoft.keyvault/vaults/dcr-vault",
  "time": "2024-08-20T14:13:00.0000000Z",
  "unit": "MilliSeconds",
  "metricName": "ServiceApiLatency",
  "timeGrain": "PT1M",
  "dimension": {
    "ActivityName": "vaultget",
    "ActivityType": "vault",
    "StatusCode": "200",
    "StatusCodeClass": "2xx"
  }
}

Pusat Aktivitas

Contoh berikut menunjukkan metrik yang diekspor ke Azure Event Hubs.

{
  "Average": "1",
  "Count": "1",
  "Maximum": "1",
  "Minimum": "1",
  "Total": "1",
  "resourceId": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourcegroups/rg-dcrs/providers/microsoft.keyvault/vaults/dcr-vault",
  "time": "2024-08-22T13:43:00.0000000Z",
  "unit": "Count",
  "metricName": "ServiceApiHit",
  "timeGrain": "PT1M",
  "dimension": {
    "ActivityName": "keycreate",
    "ActivityType": "key"
  },
  "EventProcessedUtcTime": "2024-08-22T13:49:17.1233030Z",
  "PartitionId": 0,
  "EventEnqueuedUtcTime": "2024-08-22T13:46:04.5570000Z"
}

Memverifikasi dan memecahkan masalah pengumpulan data

Setelah Anda menginstal DCR, mungkin perlu beberapa menit agar perubahan diterapkan dan data dikumpulkan dengan DCR yang diperbarui. Jika Anda tidak melihat data apa pun yang dikumpulkan, gunakan fitur pemantauan DCR , yang mencakup metrik dan log untuk membantu pemecahan masalah.

Metrik DCR dikumpulkan secara otomatis untuk semua DCR, dan Anda dapat menganalisisnya menggunakan penjelajah metrik seperti metrik platform untuk sumber daya Azure lainnya. Aktifkan log kesalahan DCR untuk mendapatkan informasi kesalahan terperinci saat pemrosesan data tidak berhasil.

• Periksa metrik seperti Logs Ingestion Bytes per Min dan Logs Rows Received per Min untuk memastikan bahwa data mencapai Azure Monitor. Jika tidak, periksa sumber data Anda untuk memastikan bahwa sumber data mengirim data seperti yang diharapkan.
• Periksa Logs Rows Dropped per Min untuk melihat apakah ada baris yang dihilangkan. Ini mungkin tidak menunjukkan kesalahan karena baris dapat dihilangkan oleh transformasi. Jika baris yang dihilangkan sama dengan Logs Rows Dropped per Min , maka tidak ada data yang diserap di ruang kerja. Periksa Logs Transformation Errors per Min untuk melihat apakah ada kesalahan transformasi.
• Periksa Logs Transformation Errors per Min untuk menentukan apakah ada kesalahan dari transformasi yang diterapkan ke data masuk. Ini bisa disebabkan oleh perubahan struktur data atau transformasi itu sendiri.
• DCRLogErrors Periksa tabel untuk setiap kesalahan penyerapan yang mungkin telah dicatat. Ini dapat memberikan detail tambahan dalam mengidentifikasi akar penyebab masalah.

Langkah selanjutnya

• Baca tentang struktur terperinci aturan pengumpulan data.
• Dapatkan detail tentang transformasi dalam aturan pengumpulan data.
• Kumpulkan log platform menggunakan aturan pengumpulan data.
• Tinjau jenis dan kategori sumber daya log platform yang didukung.