Bagikan melalui

Ekspor metrik melalui aturan pengumpulan data (Pratinjau)

  • Artikel

Aturan pengumpulan data (DCR) digunakan untuk mengumpulkan data pemantauan dari sumber daya Azure Anda. Untuk daftar skenario pengumpulan data, lihat Aturan pengumpulan data - Gambaran Umum. Anda sekarang dapat menggunakan DCR untuk mengumpulkan dan mengekspor metrik platform.

Saat ini, metrik platform dapat dikumpulkan menggunakan Pengaturan DCR dan Diagnostik. Semakin banyak sumber daya yang mendukung ekspor metrik menggunakan DCR. Lihat Sumber daya dan wilayah yang didukung untuk daftar sumber daya pendukung.

Menggunakan DCR untuk mengekspor metrik memberikan keuntungan berikut daripada 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 dibandingkan dengan Pengaturan Diagnostik.
  • Latensi ujung ke ujung untuk DCR dalam waktu 3 menit. Ini adalah peningkatan besar atas Pengaturan Diagnostik di mana latensi ekspor metrik adalah 6-10 menit.

Gunakan ekspor metrik melalui DCR untuk ekspor data metrik berkelanjutan. Untuk mengkueri data historis, gunakan DATA plane Metrics Batch API. Untuk perbandingan dua layanan, lihat Kueri API Batch Metrik bidang data versus ekspor Metrik.

Buat DCR untuk metrik menggunakan REST API, Azure CLI, atau Azure PowerShell. Untuk informasi tentang cara membuat DCR untuk ekspor metrik, lihat Membuat aturan pengumpulan data untuk metrik.

Saat membuat DCR, Anda harus membuat asosiasi aturan pengumpulan data (DCRA) untuk mengaitkan DCR dengan sumber daya yang akan dipantau. Anda dapat membuat satu DCR untuk banyak jenis sumber daya. Untuk informasi tentang cara membuat DCRA lihat Membuat asosiasi aturan pengumpulan data. Saat menggunakan portal Azure, DCRA dibuat secara otomatis.

Catatan

Dimungkinkan untuk menggunakan DCR dan pengaturan diagnostik secara bersamaan. Sebaiknya nonaktifkan pengaturan diagnostik untuk metrik saat menggunakan DCR untuk menghindari pengumpulan data duplikat.

Tujuan ekspor

Metrik dapat diekspor ke salah satu tujuan berikut per DCR:

  • Ruang kerja Analitik Log.
    Mengekspor ke ruang kerja Analitik Log dapat melintasi 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 Acara.
    Azure Event Hubs, DCR, dan sumber daya yang dipantau semuanya harus berada di wilayah yang sama.

Untuk sampel data di setiap tujuan, lihat Data yang diekspor.

Catatan

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

Batasan

DCR untuk ekspor metrik memiliki batasan berikut:

  • Hanya satu jenis tujuan yang dapat ditentukan per DCR.
  • Maksimal 5 DCR dapat dikaitkan dengan satu Sumber Daya Azure.

Sumber daya dan wilayah yang didukung

Sumber daya berikut mendukung ekspor metrik menggunakan aturan pengumpulan data:

Jenis Sumber Daya Spesifikasi streaming
Virtual Machine Scale Sets Microsoft.compute/virtualmachinescalesets
Mesin virtual Microsoft.compute/virtualmachines
Cache Redis Microsoft.cache/redis
Hub IOT Microsoft.devices/iothubs
Brankas kunci Microsoft.keyvault/vaults
Akun penyimpanan Microsoft.storage/storageaccounts
Microsoft.storage/Storageaccounts/blobservices
Microsoft.storage/storageaccounts/fileservices
Microsoft.storage/storageaccounts/queueservices
Microsoft.storage/storageaccounts/tableservices
SQL Server Microsoft.sql/server
Microsoft.sql/server/database
Operational Insights Microsoft.operationalinsights/workspaces
Layanan media Microsoft.media/mediaservices
Microsoft.media/mediaservices/streamingendpoints
Microsoft.media/mediaservices/liveevents
Perlindungan data Microsoft.dataprotection/backupvaults
Azure Kubernetes Service Microsoft.ContainerService/managedClusters

Wilayah yang didukung

Anda dapat membuat DCR untuk ekspor metrik di wilayah mana pun, tetapi sumber daya yang ingin Anda ekspor metriknya harus berada di salah satu wilayah berikut:

  • Australia Timur
  • AS Tengah
  • CentralUsEuap
  • US Tengah Selatan
  • AS Timur
  • AS Timur 2
  • Eastus2Euap
  • AS Barat
  • US Barat 2
  • Eropa Utara
  • Eropa Barat
  • UK Selatan

Spesifikasi DCR

Aturan pengumpulan data ditentukan dalam objek JSON. Properti berikut diperlukan untuk membuat DCR untuk ekspor metrik.

Properti Deskripsi
dataSources.platformTelemetry.streams Mencantumkan jenis sumber daya dan metrik. Tentukan Metrics-Group-All untuk mengumpulkan semua metrik untuk sumber daya atau menentukan metrik individual. Format: <resource type>:Metrics-Group-All | <metric name>
Misalnya: Microsoft.Compute/virtualMachines:Percentage CPU
dataSources.platformTelemetry.name Nama sumber data.
destinations Tujuan untuk metrik. Hanya satu tujuan yang didukung per DCR.
Jenis Tujuan yang Valid:
storageAccounts
logAnalytics
eventHubs
dataflows.streams Daftar aliran yang akan diteruskan ke tujuan dalam format: <resource type>:Metrics-Group-All |<metric name>
Misalnya, Microsoft.Compute/virtualMachines:Percentage CPU"
dataflows.destinations Tujuan untuk meneruskan aliran ke seperti yang destinations didefinisikan dalam properti .
identity.type Jenis identitas yang digunakan untuk DCR. Diperlukan untuk tujuan akun penyimpanan.
Nilai yang valid:
systemAssigned
userAssigned
kind Jenis aturan pengumpulan data. Atur ke PlatformTelemetry untuk ekspor metrik.
location Lokasi DCR.

Catatan

Hanya satu jenis tujuan yang dapat ditentukan per DCR.

Format JSON untuk DCR ekspor metrik

Gunakan format dalam objek JSON generik berikut untuk membuat DCR untuk ekspor metrik. Hapus tujuan yang tidak diinginkan saat menyalin contoh.

{
    "properties": {
        "dataSources": {
            "platformTelemetry": [
                {
                    "streams": [
                    // a list of resource types and metrics to collect metrics from
                        "<resourcetype>:<metric name> | Metrics-Group-All", 
                        "<resourcetype>:<metric name> | Metrics-Group-All"
                    ],
                    "name": "<data sources name>"
                }
            ]
        },
        "destinations": {
            // Choose a single destination type of either logAnalytics, storageAccounts, or eventHubs
            "logAnalytics": [
                {
                    "workspaceResourceId": "workspace Id",
                    "name": "<destination name>"
                }
            ],    
            "storageAccounts": [
                {
                    "storageAccountResourceId": "<storage account Id>", 
                    "containerName": "<container name>",
                    "name": "<destination name>"
                }
            ],
            "eventHubs": [ 
                 { 
                    "eventHubResourceId": "event hub id", 
                     "name": "<destination name>" 
                 } 
             ],     },
        "dataFlows": [
            {
                "streams": [
                 // a list of resource types and metrics to pass to the destination
                        "<resourcetype>:<metric name> | Metrics-Group-All", 
                        "<resourcetype>:<metric name> | Metrics-Group-All"               
                         ],
                "destinations": [
                    "<destination name>"               
                ]
            }
        ]
    },
    // identity is required for Storage Account and Event Hubs destinations
    "identity": {
         "type": "userassigned", 
         "userAssignedIdentities": { 
					 "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/rg-001/providers/Microsoft.ManagedIdentity/userAssignedIdentities/DRCIdentity": {} 
         }    
    },
"kind": "PlatformTelemetry",
    "location": "eastus"
}

Catatan

Saat membuat DCR untuk ekspor metrik menggunakan CLI, kind, , locationdan identity diteruskan sebagai argumen dan harus dihapus dari objek JSON.

Identitas yang ditetapkan pengguna dan sistem

Identitas yang ditetapkan pengguna dan sistem didukung saat membuat DCR. Identitas diperlukan untuk tujuan Akun Penyimpanan dan Azure Event Hubs. Anda dapat menggunakan sistem yang ditetapkan atau identitas yang ditetapkan pengguna. Untuk informasi selengkapnya, lihat Menetapkan peran Azure ke identitas terkelola.

Untuk menggunakan identitas yang ditetapkan sistem, tambahkan identity objek sebagai berikut:

    "identity": {
         "type": "systemAssigned"
    },

Untuk menggunakan identitas yang ditetapkan pengguna, tambahkan identity objek sebagai berikut:

    "identity": {
         "type": "userassigned", 

         "userAssignedIdentities": { 
           "/subscriptions/<subscriptionId>/resourceGroups/<resource group name>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/<identity name>": {} 
         }    

    }

Memfilter metrik

Saat menentukan metrik yang akan diekspor, Anda dapat memfilter metrik berdasarkan nama atau meminta semua metrik dengan menggunakan Metrics-Group-All. Untuk daftar metrik yang didukung, lihat Metrik yang didukung dan kategori log menurut jenis sumber daya.

Untuk menentukan lebih dari satu metrik dari jenis sumber daya yang sama, buat item aliran terpisah untuk setiap metrik.

Contoh berikut menunjukkan cara memfilter metrik menurut nama.

{
    "properties": {
        "dataSources": {
            "platformTelemetry": [
                {
                    "streams": [
                        "Microsoft.Compute/virtualMachines:Percentage CPU",
                        "Microsoft.Compute/virtualMachines:Disk Read Bytes",
                        "Microsoft.Compute/virtualMachines:Inbound Flows",  
                        "Microsoft.Compute/virtualMachineScaleSets:Percentage CPU",
                        "Microsoft.Cache/redis:Cache Hits"
                    ],
                    "name": "myPlatformTelemetryDataSource"
                }
            ]
        },
        "destinations": {
            "logAnalytics": [
                {
                    "workspaceResourceId": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourcegroups/arg-001/providers/microsoft.operationalinsights/workspaces/loganalyticsworkspace001",
                    "name": "destinationName"
                }
            ]
        },
        "dataFlows": [
            {
                "streams": [
                    "Microsoft.Compute/virtualMachines:Percentage CPU",
                    "Microsoft.Compute/virtualMachines:Disk Read Bytes",
                    "Microsoft.Compute/virtualMachines:Inbound Flows",
                    "Microsoft.Compute/virtualMachineScaleSets:Percentage CPU",
                    "Microsoft.Cache/redis:Cache Hits"
                ],
                "destinations": [
                    "destinationName"
                ]
            }
        ]
    },
    "kind": "PlatformTelemetry",
    "location": "eastus"
}

Sampel metrik mengekspor objek JSON

Contoh berikut menunjukkan contoh objek DCR JSON untuk ekspor metrik ke setiap jenis tujuan.

Ruang Kerja Log Analytics

Contoh berikut menunjukkan aturan pengumpulan data untuk metrik yang mengirim metrik tertentu dari komputer virtual, set skala komputer virtual, dan semua metrik brankas kunci ke ruang kerja Analitik Log:

{
    "properties": {
        "dataSources": {
            "platformTelemetry": [
                {
                    "streams": [
                        "Microsoft.Compute/virtualMachines:Percentage CPU",
                        "Microsoft.Compute/virtualMachines:Disk Read Bytes",
                        "Microsoft.Compute/virtualMachines:Inbound Flows",
                        "Microsoft.Compute/virtualMachineScaleSets:Available Memory Bytes",
                         "Microsoft.KeyVault/vaults:Metrics-Group-All"
                    ],
                    "name": "myPlatformTelemetryDataSource"
                }
            ]
        },
        "destinations": {
            "logAnalytics": [ 
                { 
                    "workspaceResourceId": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourcegroups/rg-001/providers/microsoft.operationalinsights/workspaces/laworkspace001", 
                    "name": "ladestination" 
                } 
            ] 
        },
        "dataFlows": [
            {
                "streams": [
                        "Microsoft.Compute/virtualMachines:Percentage CPU",
                        "Microsoft.Compute/virtualMachines:Disk Read Bytes",
                        "Microsoft.Compute/virtualMachines:Inbound Flows",
                        "Microsoft.Compute/virtualMachineScaleSets:Available Memory Bytes",
                        "Microsoft.KeyVault/vaults:Metrics-Group-All"
                        ],    
                "destinations": [
                    "ladestination"
                    
                ]
            }
        ]
    },

"kind": "PlatformTelemetry",
    "location": "centralus"
}

Membuat DCR untuk ekspor metrik

Buat DCR untuk ekspor metrik menggunakan templat portal Azure, CLI, PowerShell, REST API, atau ARM. Untuk informasi selengkapnya, lihat Membuat dan mengedit aturan pengumpulan data (DCR) dan asosiasi di Azure Monitor.

Data yang diekspor

Contoh berikut menunjukkan data yang diekspor ke setiap tujuan.

Ruang kerja analitik log

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

Column Tipe Deskripsi
Tengah real Nilai rata-rata yang dikumpulkan selama dalam rentang waktu.
_BilledSize real Ukuran rekaman dalam byte
Hitung real Jumlah sampel yang dikumpulkan selama rentang waktu.
Dimensi dinamis Dimensi terkait metrik dalam format JSON.
_IsBillable string Menentukan apakah menyerap data dapat ditagih. Saat _IsBillable false penyerapan tidak ditagih ke akun Azure Anda
Maksimum real Nilai maksimum yang dikumpulkan selama dalam rentang waktu.
MetricCategory string Nama kategori metrik.
MetricName string Nama tampilan metrik.
MetricResourceType string Jenis sumber daya sumber daya Azure yang melaporkan metrik.
Minimum real Nilai minimum yang dikumpulkan selama dalam rentang waktu.
_ResourceId string Pengidentifikasi unik untuk sumber daya yang terkait dengan rekaman
SourceSystem string Jenis agen yang dikumpulkan oleh peristiwa. Misalnya, OpsManager untuk agen Windows, baik direct connect atau Operations Manager, Linux untuk semua agen Linux, atau Azure untuk Azure Diagnostics
_SubscriptionId string Pengidentifikasi unik untuk langganan yang dikaitkan dengan catatan
TenantId string ID ruang kerja Analitik Log
TimeGenerated datetime Tanda waktu (UTC) ketika rekaman dibuat.
TimeGrain string Butir waktu metrik.
Total real Jumlah semua nilai dalam rentang waktu.
Jenis string Nama tabel
UnitName string Unit metrik.

Contohnya:

Cuplikan layar kueri analitik log tabel AzureMetricsV2.

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

Event Hubs

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

Langkah berikutnya