Mått exporteras via datainsamlingsregler (förhandsversion)

  • Artikel

Datainsamlingsregler (DCR) används för att samla in övervakningsdata från dina Azure-resurser. En lista över datainsamlingsscenario finns i Datainsamlingsregler – Översikt. Nu kan du använda DCR för att samla in och exportera plattformsmått.

För närvarande kan plattformsmått samlas in med både DCR och diagnostikinställningar. Ett växande antal resurser stöder måttexport med hjälp av domänkontrollanter. En lista över stödresurser finns i Resurser och regioner som stöds.

Att använda DCR för att exportera mått ger följande fördelar jämfört med diagnostikinställningar:

  • DCR-konfiguration möjliggör export av mått med dimensioner.
  • DCR-konfiguration möjliggör filtrering baserat på måttnamn – så att du bara kan exportera de mått som du behöver.
  • DCR:er är mer flexibla och skalbara jämfört med diagnostikinställningar.
  • Svarstiden från slutpunkt till slutpunkt för domänkontrollanter är inom 3 minuter. Det här är en stor förbättring jämfört med diagnostikinställningar där måttens exportfördröjning är 6–10 minuter.

Använd måttexport via DCR för kontinuerlig export av måttdata. Om du vill köra frågor mot historiska data använder du Batch-API:et för dataplansmått. En jämförelse av de två tjänsterna finns i Batch API-fråga för dataplansmått jämfört med export av mått.

Skapa domänkontrollanter för mått med hjälp av REST API, Azure CLI eller Azure PowerShell. Information om hur du skapar domänkontrollanter för måttexport finns i Skapa datainsamlingsregler för mått.

När du skapar en DCR måste du skapa en DCRA (Data Collection Rule Association) för att associera DCR med den resurs som ska övervakas. Du kan skapa en enda DCR för många resurstyper. Information om hur du skapar en DCRA finns i Skapa regelassociationer för datainsamling. När du använder Azure Portal skapas DCRA automatiskt.

Kommentar

Det är möjligt att använda dcrs och diagnostikinställningar samtidigt. Vi rekommenderar att du inaktiverar diagnostikinställningar för mått när du använder DCR för att undvika dubbletter av datainsamling.

Exportera mål

Mått kan exporteras till något av följande mål per DCR:

  • Log Analytics-arbetsytor.
    Export till Log Analytics-arbetsytor kan finnas i flera regioner. Log Analytics-arbetsytan och DCR måste finnas i samma region, men resurser som övervakas kan finnas i valfri region. Mått som skickas till en log analytics-arbetsyta lagras i AzureMetricsV2 tabellen.

  • Azure Storage-konton.
    Lagringskontot, DCR och de resurser som övervakas måste alla finnas i samma region.

  • Event Hubs.
    Event Hubs, DCR och de resurser som övervakas måste alla finnas i samma region.

Ett exempel på data i varje mål finns i Exporterade data.

Kommentar

Svarstiden för att exportera mått är cirka 3 minuter. Tillåt upp till 15 minuter innan måtten börjar visas i målet efter den första installationen.

Begränsningar

DCR:erna för måttexport har följande begränsningar:

  • Endast en måltyp kan anges per DCR.
  • Högst 5 domänkontrollanter kan associeras med en enda Azure-resurs.

Resurser och regioner som stöds

Följande resurser stöder måttexport med hjälp av datainsamlingsregler:

Resurstyp Stream-specifikation
Skalningsuppsättningar för Virtual Machines Microsoft.compute/virtualmachinescalesets
Virtuella datorer Microsoft.compute/virtualmachines
Redis-cache Microsoft.cache/redis
IOT-hubbar Microsoft.devices/iothubs
Nyckelvalv Microsoft.keyvault/vaults
Lagringskonton Microsoft.storage/storageaccounts
Microsoft.storage/Storageaccounts/blobservices
Microsoft.storage/storageaccounts/fileservices
Microsoft.storage/storageaccounts/queueservices
Microsoft.storage/storageaccounts/tableservices
SQL Server Microsoft.sql/servrar
Microsoft.sql/servrar/databaser
Operational Insights Microsoft.operationalinsights/workspaces
Media Services Microsoft.media/mediaservices
Microsoft.media/mediaservices/streamingendpoints
Microsoft.media/mediaservices/liveevents
Dataskydd Microsoft.dataprotection/backupvaults
Azure Kubernetes Service Microsoft.ContainerService/managedClusters

Regioner som stöds

Du kan skapa en DCR för måttexport i valfri region, men de resurser som du vill exportera mått från måste finnas i någon av följande regioner:

  • Australien, östra
  • Centrala USA
  • CentralUsEuap
  • USA, södra centrala
  • East US
  • USA, östra 2
  • Eastus2Euap
  • USA, västra
  • USA, västra 2
  • Europa, norra
  • Europa, västra
  • Södra Storbritannien

DCR-specifikationer

Regler för datainsamling definieras i ett JSON-objekt. Följande egenskaper krävs för att skapa en DCR för måttexport.

Property beskrivning
dataSources.platformTelemetry.streams Visar en lista över resurstyper och mått. Ange Metrics-Group-All för att samla in alla mått för resursen eller ange enskilda mått. Format: <resource type>:Metrics-Group-All | <metric name>
Till exempel: Microsoft.Compute/virtualMachines:Percentage CPU
dataSources.platformTelemetry.name Namnet på datakällan.
destinations Målet för måtten. Endast ett mål stöds per DCR.
Giltiga måltyper:
storageAccounts
logAnalytics
eventHubs
dataflows.streams En lista över strömmar som ska skickas till målet i formatet: <resource type>:Metrics-Group-All |<metric name>
Till exempel Microsoft.Compute/virtualMachines:Percentage CPU"
dataflows.destinations Målet som strömmarna ska skickas till enligt definitionen i egenskapen destinations .
identity.type Den identitetstyp som ska användas för DCR. Krävs för lagringskontomål.
Giltiga värden:
systemAssigned
userAssigned
kind Typ av datainsamlingsregel. Ange till PlatformTelemetry för måttexport.
location Platsen för DCR.

Kommentar

Endast en måltyp kan anges per DCR.

JSON-format för mått, exportera DCR

Använd formatet i följande generiska JSON-objekt för att skapa en DCR för måttexport. Ta bort oönskade mål när du kopierar exemplet.

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

Kommentar

När du skapar en DCR för måttexport med hjälp av CLI, kind, locationoch identity skickas som argument och måste tas bort från JSON-objektet.

Användar- och systemtilldelade identiteter

Både användar- och systemtilldelade identiteter stöds när du skapar domänkontrollanter. En identitet krävs för lagringskonto och Event Hubs-mål. Du kan använda en systemtilldelad eller användartilldelad identitet. Mer information finns i Tilldela Azure-roller till en hanterad identitet.

Om du vill använda en systemtilldelad identitet lägger du till objektet på identity följande sätt:

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

Om du vill använda en användartilldelad identitet lägger du till objektet på identity följande sätt:

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

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

    }

Filtrera mått

När du anger de mått som ska exporteras kan du filtrera måtten efter namn eller begära alla mått med hjälp Metrics-Group-Allav . En lista över mått som stöds finns i Mått som stöds och loggkategorier efter resurstyp.

Om du vill ange mer än ett mått från samma resurstyp skapar du ett separat dataströmobjekt för varje mått.

I följande exempel visas hur du filtrerar mått efter namn.

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

Exempelmått exporterar JSON-objekt

I följande exempel visas exempel på DCR JSON-objekt för måttexport till varje måltyp.

Log Analytics-arbetsytor

I följande exempel visas en datainsamlingsregel för mått som skickar specifika mått från virtuella datorer, vm-skalningsuppsättningar och alla nyckelvalvsmått till en Log Analytics-arbetsyta:

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

Skapa domänkontrollanter för måttexport

Skapa domänkontrollanter för måttexport med hjälp av mallen Azure Portal, CLI, PowerShell, REST API eller ARM. Mer information finns i Skapa och redigera regler för datainsamling (DCR) och associationer i Azure Monitor.

Exporterade data

I följande exempel visas de data som exporteras till varje mål.

Log Analytics-arbetsytor

Data som exporteras till en Log Analytics-arbetsyta lagras i AzureMetricsV2 tabellen på Log Analytics-arbetsytan i följande format:

Column Type Beskrivning
Genomsnitt real Genomsnittligt värde som samlats in under i tidsintervallet.
_BilledSize real Poststorleken i byte
Antal real Antal prover som samlats in under tidsintervallet.
Dimension dynamisk Associerad dimension av måttet i JSON-format.
_IsBillable sträng Anger om inmatningen av data är fakturerbar. När _IsBillable är false inmatning debiteras inte ditt Azure-konto
Högsta real Maximalt värde som samlas in under i tidsintervallet.
MetricCategory sträng Måttets kategorinamn.
MetricName sträng Måttets visningsnamn.
MetricResourceType sträng Resurstyp för Azure-resursen som rapporterar måttet.
Minimal real Minsta värde som samlats in under i tidsintervallet.
_ResourceId sträng En unik identifierare för resursen som posten är associerad med
SourceSystem sträng Typen av agent som händelsen samlades in av. Till exempel OpsManager för Windows-agenten, antingen direktanslutning eller Operations Manager, Linux för alla Linux-agenter eller Azure för Azure Diagnostics
_SubscriptionId sträng En unik identifierare för prenumerationen som posten är associerad med
TenantId sträng Log Analytics-arbetsytans ID
TimeGenerated datetime Tidsstämpel (UTC) när posten genererades.
TimeGrain sträng Tidsintervall för måttet.
Totalt real Summan av alla värden i tidsintervallet.
Typ sträng Namnet på tabellen
UnitName sträng Måttenhet.

Till exempel:

En skärmbild av en log analytics-fråga i AzureMetricsV2-tabellen.

Lagringskonton

I följande exempel visas data som exporterats till ett lagringskonto:

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

I följande exempel visas ett mått som exporteras till 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"
    }

Nästa steg