Esportazione di metriche tramite regole di raccolta dati (anteprima)

Le regole di raccolta dati (DCR) vengono usate per raccogliere dati di monitoraggio dalle risorse di Azure. Per un elenco di scenari di raccolta dati, vedere Regole di raccolta dati - Panoramica. È ora possibile usare DCR per raccogliere ed esportare metriche della piattaforma.

Attualmente, le metriche della piattaforma possono essere raccolte usando sia DCR che Impostazioni di diagnostica. Un numero crescente di risorse supporta l'esportazione delle metriche tramite DCR. Per un elenco delle risorse supportate, vedere Risorse e aree supportate.

L'uso di DCR per esportare le metriche offre i vantaggi seguenti rispetto a Impostazioni di diagnostica:

• La configurazione di DCR consente di esportare metriche con dimensioni.
• La configurazione di DCR consente di filtrare le metriche in base al nome, in modo da poter esportare solo le metriche necessarie.
• Le DCR sono più flessibili e scalabili rispetto a Impostazioni di diagnostica.
• La latenza end-to-end per le DCR è inferiore ai 3 minuti. Si tratta di un miglioramento fondamentale rispetto a Impostazioni di diagnostica, in cui la latenza di esportazione delle metriche è di 6-10 minuti.

Usare l'esportazione delle metriche tramite DCR per l'esportazione continua dei dati delle metriche. Per eseguire query su dati storici, usare l'API Batch metriche del piano dati. Per un confronto dei due servizi, vedere Query batch su metriche del piano dati vs. esportazione delle metriche.

Creare DCR per le metriche usando l'API REST, l'interfaccia della riga di comando di Azure o Azure PowerShell. Per informazioni su come creare DCR per l'esportazione delle metriche, vedere Creare regole di raccolta dati per le metriche.

Quando si crea un record di controllo di dominio, è necessario creare un'associazione di regole di raccolta dati (DCRA) per associare la DCR alla risorsa da monitorare. È possibile creare una singola DCR per molti tipi di risorse. Per informazioni su come creare una DCRA, vedere Creare associazioni di regole di raccolta dati. Quando si usa il portale di Azure, la DCRA viene creata automaticamente.

Destinazioni di esportazione

Le metriche possono essere esportate in una delle destinazioni seguenti per DCR:

• Aree di lavoro Log Analytics.
  L'esportazione in aree di lavoro Log Analytics può essere in più aree. L'area di lavoro Log Analytics e la DCR devono trovarsi nella stessa area, ma le risorse monitorate possono trovarsi in qualsiasi area. Le metriche inviate a un'area di lavoro Log Analytics vengono archiviate nella tabella AzureMetricsV2.

• Account di archiviazione di Azure.
  L'account di archiviazione, la DCR e le risorse monitorate devono trovarsi nella stessa area.

• Hub eventi.
  Gli hub eventi, la DCR e le risorse monitorate devono trovarsi nella stessa area.

Per un esempio dei dati in ogni destinazione, vedere Dati esportati.

Limiti

I DCR per l'esportazione delle metriche presentano le limitazioni seguenti:

• È possibile specificare un solo tipo di destinazione per ogni DCR.
• Un massimo di 5 DCR può essere associato a una singola risorsa di Azure.
• L'esportazione delle metriche da parte di DCR non supporta l'esportazione di metriche con granularità oraria.

Risorse e aree supportate

Le risorse seguenti supportano l'esportazione delle metriche usando le regole di raccolta dati:

Aree supportate

È possibile creare una DCR per l'esportazione di metriche in qualsiasi area, ma le risorse da cui si vogliono esportare le metriche devono trovarsi in una delle aree seguenti:

• Australia orientale
• Stati Uniti centrali
• CentralUsEuap
• Stati Uniti centro-meridionali
• Stati Uniti orientali
• Stati Uniti orientali 2
• Eastus2Euap
• Stati Uniti occidentali
• West US 2
• Europa settentrionale
• Europa occidentale
• Regno Unito meridionale

Specifiche di DCR

Le regole di raccolta dati vengono definite in un oggetto JSON. Per creare una DCR per l'esportazione di metriche sono necessarie le proprietà seguenti.

Formato JSON per l'esportazione di DCR per le metriche

Usare il formato nell'oggetto JSON generico seguente per creare un record di controllo di dominio per l'esportazione delle metriche. Rimuovere le destinazioni indesiderate durante la copia dell'esempio.

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

Identità assegnate dall'utente e dal sistema

Le identità assegnate dall'utente e dal sistema sono supportate durante la creazione di DCR. È necessaria un'identità per le destinazioni dell'account di archiviazione e di Hub eventi. È possibile usare un'identità assegnata dal sistema o assegnata dall'utente. Per altre informazioni, vedere Assegnare ruoli di Azure a un'identità gestita.

Per usare un'identità assegnata dal sistema, aggiungere l'oggetto identity come segue:

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

Per usare un'identità assegnata dall'utente, aggiungere l'oggetto identity come segue:

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

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

    }

Filtrare metriche

Quando si specificano le metriche da esportare, è possibile filtrarle in base al nome o richiedere tutte le metriche usando Metrics-Group-All. Per un elenco delle metriche supportate, vedere Metriche supportate e categorie di log per tipo di risorsa.

Per specificare più metriche dello stesso tipo di risorsa, creare un elemento di flusso separato per ogni metrica.

L'esempio seguente illustra come filtrare le metriche in base al nome.

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

Le metriche campione esportano oggetti JSON

Gli esempi seguenti illustrano gli oggetti JSON DCR campione per l'esportazione di metriche in ogni tipo di destinazione.

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

{
    "properties": {
        "dataSources": {
            "platformTelemetry": [
                {
                    "streams": [
                        "Microsoft.Compute/virtualMachines:Percentage CPU",
                        "Microsoft.Compute/virtualMachines:Disk Read Bytes",
                        "Microsoft.Compute/virtualMachines:Inbound Flows"
                        "Microsoft.Compute/virtualMachineScaleSets:Metrics-Group-All",
                        "Microsoft.Cache/redis:Metrics-Group-All",
                        "Microsoft.keyvault/vaults:Metrics-Group-All"
                    ],
                    "name": "myPlatformTelemetryDataSource"
                }
            ]
        },
        "destinations": {
            "storageAccounts": [
                {
                    "storageAccountResourceId": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourcegroups/rg-001/providers/Microsoft.Storage/storageAccounts/metricsexport001",
                    "containerName": "metritcs-001",
                    "name": "desitnationName"
                }
            ]
        },
        "dataFlows": [
            {
                "streams": [
                    "Microsoft.Compute/virtualMachines:Percentage CPU",
                    "Microsoft.Compute/virtualMachines:Disk Read Bytes",
                    "Microsoft.Compute/virtualMachines:Inbound Flows"
                    "Microsoft.Compute/virtualMachineScaleSets:Metrics-Group-All",
                    "Microsoft.Cache/redis:Metrics-Group-All",
                    "Microsoft.keyvault/vaults:Metrics-Group-All"
                ],
                "destinations": [
                    "desitnationName"
                ]
            }
        ]
    },
    "identity": {
         "type": "systemAssigned"
    },
"kind": "PlatformTelemetry",
    "location": "eastus2"
}

{
    "properties": {
        "dataSources": {
            "platformTelemetry": [
                {
                    "streams": [
                        "Microsoft.Compute/virtualMachines:Metrics-Group-All",
                        "Microsoft.keyvault/vaults:ServiceApiHit",
                        "Microsoft.keyvault/vaults:Availability"

                    ],
                    "name": "myPlatformTelemetryDataSource"
                }
            ]
        },
        "destinations": {
            "eventHubs": [ 
                { 
                    "eventHubResourceId": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/rg-001/providers/Microsoft.EventHub/namespaces/event-hub-001/eventhubs/hub-001", 
                    "name": "hub1" 
                } 
           ] 
        },
        "dataFlows": [
            {
                "streams": [
                    "Microsoft.Compute/virtualMachines:Metrics-Group-All",
                        "Microsoft.keyvault/vaults:ServiceApiHit",
                        "Microsoft.keyvault/vaults:Availability"
                ],
                "destinations": [
                    "hub1"
                ]
            }
        ]
    },
    "identity": {
         "type": "systemAssigned"
    },
"kind": "PlatformTelemetry",
    "location": "eastus"
}

Creare DCR per l'esportazione delle metriche

Creare DCR per l'esportazione di metriche usando il portale di Azure, l'interfaccia della riga di comando, PowerShell, l'API REST o il modello di Resource Manager. Per altre informazioni, vedere Creare una regola di raccolta dati (DCR) per l'esportazione delle metriche.

Dati esportati

Negli esempi seguenti vengono illustrati i dati esportati in ogni destinazione.

Aree di lavoro Log Analytics

I dati esportati in un'area di lavoro Log Analytics vengono archiviati nella tabella AzureMetricsV2 nell'area di lavoro Log Analytics nel formato seguente:

Ad esempio:

Account di archiviazione

L'esempio seguente mostra i dati esportati in un account di archiviazione:

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

Hub eventi

L'esempio seguente mostra una metrica esportata in Hub eventi.

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

Passaggi successivi

• Creare e modificare regole di raccolta dati
• Query dell'API batch delle metriche del piano dati vs. Esportazione delle metriche
• Panoramica delle regole di raccolta dati
• Procedure consigliate per la creazione e la gestione delle regole di raccolta dati in Monitoraggio di Azure