Mått exporteras via datainsamlingsregler (förhandsversion)

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 export av mätvärden med hjälp av DCR:er. 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 DCR:er är högst 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 datainsamlingsregler för mått med hjälp av REST API, Azure CLI eller Azure PowerShell. Information om hur du skapar DCR:er för export av mått 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.

Exportmål

Metrikdata kan exporteras till en av följande destinationer per DCR:

• Log Analytics-arbetsytorna

  Export av data till Log Analytics-arbetsytor kan ske över 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-lagringskonton

  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.

För ett exempel på data i varje destination, se Exporterade data.

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.
• DCR-export av mått stöder inte export av timvisa detaljnivåmått.

Resurser och regioner som stöds

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

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
• Mellersta USA
• CentralUsEuap
• Södra Centrala USA
• östra USA
• Östra USA 2
• Eastus2Euap
• Västra USA
• Västra USA 2
• Europa, norra
• Västeuropa
• UK South (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.

JSON-format för metrikexport 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"
}

Användar- och systemtilldelade identiteter

Både användar- och systemtilldelade identiteter stöds vid skapandet av DCRs. 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 metrik

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.

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

Skapa datainsamlingsregler för måttexport

Skapa DCR:er för export av mätvärden med hjälp av Azure Portal, CLI, PowerShell, REST API eller ARM-mall. Mer information finns i Skapa en datainsamlingsregel (DCR) för måttexport.

Exporterade data

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

logganalysarbetsytor

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

Till exempel:

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

• Skapa och redigera datainsamlingsregler
• Batch-API-fråga för dataplansmått jämfört med måttexport
• Datainsamlingsregler, översikt
• Metodtips för skapande och hantering av datainsamlingsregel i Azure Monitor