Delen via

Metrische gegevens exporteren via regels voor gegevensverzameling (preview)

Regels voor gegevensverzameling (DCR's) worden gebruikt om bewakingsgegevens van uw Azure-resources te verzamelen. Zie Regels voor gegevensverzameling - Overzicht voor een lijst met scenario's voor gegevensverzameling. U kunt nu DCR's gebruiken om metrische platformgegevens te verzamelen en te exporteren.

Op dit moment kunnen metrische platformgegevens worden verzameld met behulp van dcr en diagnostische instellingen. Een groeiend aantal resources biedt ondersteuning voor het exporteren van metrische gegevens met behulp van DCR's. Zie Ondersteunde resources en regio's voor een lijst met ondersteunende resources.

Het gebruik van DCR's voor het exporteren van metrische gegevens biedt de volgende voordelen ten opzichte van diagnostische instellingen:

  • Met DCR-configuratie kunt u metriek met dimensies exporteren.
  • De configuratie van DCR maakt het mogelijk om te filteren op basis van de metrieknaam, zodat u alleen de benodigde metrische gegevens kunt exporteren.
  • DCR's zijn flexibeler en schaalbaar in vergelijking met diagnostische instellingen.
  • De end-to-end-latentie voor DCR's is binnen 3 minuten. Dit is een belangrijke verbetering ten opzichte van diagnostische instellingen waarbij de exportlatentie voor metrische gegevens 6-10 minuten is.

Gebruik metrische gegevensexport via DCR's voor continue export van metrische gegevens. Voor het uitvoeren van query's op historische gegevens gebruikt u de Batch-API voor metrische gegevens van het gegevensvlak. Zie voor een vergelijking van de twee services de Batch API-query voor metrische gegevens in het gegevensvlak versus de export van metrische gegevens.

Maak DCR's voor metrische gegevens met behulp van de REST API, Azure CLI of Azure PowerShell. Zie Gegevensverzamelingsregels maken voor metrische gegevens voor informatie over het maken van DCR's voor het exporteren van metrische gegevens.

Wanneer u een DCR maakt, moet u een DCRA (Data Collection Rule Association) maken om de DCR te koppelen aan de resource die moet worden bewaakt. U kunt één DCR maken voor veel resourcetypen. Zie Koppelingen voor het maken van gegevensverzamelingsregels voor informatie over hoe u een DCRA maakt. Wanneer u Azure Portal gebruikt, wordt de DCRA automatisch gemaakt.

Opmerking

Het is mogelijk om DCR's en diagnostische instellingen tegelijkertijd te gebruiken. U wordt aangeraden diagnostische instellingen voor metrische gegevens uit te schakelen wanneer u DCR's gebruikt om dubbele gegevensverzameling te voorkomen.

Exportbestemmingen

Metrische gegevens kunnen worden geëxporteerd naar een van de volgende bestemmingen per DCR:

  • Log Analytics-werkruimten

    Exporteren naar Log Analytics-werkruimten kan plaatsvinden over verschillende regio's. De Log Analytics-werkruimte en de DCR moeten zich in dezelfde regio bevinden, maar resources die worden bewaakt, kunnen zich in elke regio bevinden. Metrische gegevens die naar een Log Analytics-werkruimte worden verzonden, worden opgeslagen in de AzureMetricsV2 tabel.

  • Azure-opslagaccounts

    Het opslagaccount, de DCR en de resources die worden bewaakt, moeten zich allemaal in dezelfde regio bevinden.

  • Event Hubs.

    De Event Hubs, de DCR en de resources die worden bewaakt, moeten zich allemaal in dezelfde regio bevinden.

Zie Geëxporteerde gegevens voor een voorbeeld van de gegevens in elke bestemming.

Opmerking

Latentie voor het exporteren van metrische gegevens duurt ongeveer 3 minuten. Het duurt maximaal 15 minuten voordat metrics na de eerste installatie op de bestemming worden weergegeven.

Beperkingen

DCR's voor het exporteren van metrische gegevens hebben de volgende beperkingen:

  • Er kan slechts één doeltype per DCR worden opgegeven.
  • Er kunnen maximaal 5 DCR's aan één Azure-resource worden gekoppeld.
  • Het exporteren van metrische gegevens door DCR biedt geen ondersteuning voor het exporteren van metrische gegevens per uur.

Ondersteunde middelen en regio's

De volgende resources ondersteunen het exporteren van metrische gegevens met behulp van regels voor gegevensverzameling:

Hulpmiddeltype Streamspecificatie
Schaalsets voor virtuele machines Microsoft.compute/virtualmachinescalesets
Virtuele machines Microsoft.compute/virtualmachines
Redis cache Microsoft.cache/redis
IoT-hubs Microsoft.devices/iothubs
Sleutelkluizen Microsoft.keyvault/vaults
Opslagrekeningen Microsoft.storage/storageaccounts
Microsoft.storage/Storageaccounts/blobservices
Microsoft.storage/storageaccounts/fileservices
Microsoft.storage/storageaccounts/queueservices
Microsoft.storage/storageaccounts/tableservices
SQL Server Microsoft.sql/servers
Microsoft.sql/servers/databases
Operationele inzichten Microsoft.operationalinsights/workspaces
Gegevensbescherming Microsoft.dataprotection/backupvaults
Azure Kubernetes Service Microsoft.ContainerService/beheerdeClusters

Ondersteunde regio's

U kunt een DCR maken voor het exporteren van metrische gegevens in elke regio, maar de resources waaruit u metrische gegevens wilt exporteren, moeten zich in een van de volgende regio's bevinden:

  • Oost-Australië
  • Centrale Verenigde Staten
  • CentralUsEuap
  • Zuid-Centraal Verenigde Staten
  • Oostelijke VS
  • Oostelijke Verenigde Staten 2
  • Eastus2Euap
  • Westelijke VS
  • Westelijke Verenigde Staten 2
  • Europa - noord
  • West-Europa
  • Verenigd Koninkrijk Zuid

DCR-specificaties

Regels voor gegevensverzameling worden gedefinieerd in een JSON-object. De volgende eigenschappen zijn vereist voor het maken van een DCR voor het exporteren van metrische gegevens.

Vastgoed Beschrijving
dataSources.platformTelemetry.streams Hier worden de resourcetypen en de metrische gegevens weergegeven. Geef Metrics-Group-All op om alle metrische gegevens voor de resource te verzamelen of afzonderlijke metrische gegevens op te geven. Formatteren: <resource type>:Metrics-Group-All \| <metric name>

Voorbeeld: Microsoft.Compute/virtualMachines:Percentage CPU
dataSources.platformTelemetry.name De naam van de gegevensbron.
destinations De bestemming voor de gegevens. Er wordt slechts één bestemming ondersteund per DCR.
Geldige typen bestemmingen:
storageAccounts
logAnalytics
eventHubs
dataflows.streams Een lijst met streams die moeten worden doorgegeven aan de bestemming in de indeling: <resource type>:Metrics-Group-All \| <metric name>

Voorbeeld: Microsoft.Compute/virtualMachines:Percentage CPU
dataflows.destinations Het doel waaraan de streams moeten worden doorgegeven zoals gedefinieerd in de destinations eigenschap.
identity.type Het identiteitstype dat moet worden gebruikt voor de DCR. Vereist voor opslagaccountbestemmingen.
Geldige waarden:
systemAssigned
userAssigned
kind Het soort regel voor het verzamelen van gegevens. Ingesteld op PlatformTelemetry export van metrische gegevens.
location De locatie van de DCR.

Opmerking

Er kan slechts één doeltype per DCR worden opgegeven.

JSON-indeling voor het exporteren van metrische gegevens DCR

Gebruik de indeling in het volgende algemene JSON-object om een DCR te maken voor het exporteren van metrische gegevens. Verwijder de ongewenste bestemmingen bij het kopiëren van het voorbeeld.

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

Opmerking

Bij het maken van een DCR voor het exporteren van metrische gegevens met behulp van de CLI, kindlocationen identity worden ze doorgegeven als argumenten en moeten ze worden verwijderd uit het JSON-object.

Door de gebruiker en het systeem toegewezen identiteiten

Zowel door de gebruiker als het systeem toegewezen identiteiten worden ondersteund bij het maken van DCR's. Er is een identiteit vereist voor opslagaccount- en Event Hubs-bestemmingen. U kunt een door het systeem toegewezen of door de gebruiker toegewezen identiteit gebruiken. Zie Azure-rollen toewijzen aan een beheerde identiteit voor meer informatie.

Als u een door het systeem toegewezen identiteit wilt gebruiken, voegt u het identity object als volgt toe:

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

Als u een door de gebruiker toegewezen identiteit wilt gebruiken, voegt u het identity object als volgt toe:

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

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

    }

Metrische gegevens filteren

Wanneer u de metrische gegevens opgeeft die u wilt exporteren, kunt u de metrische gegevens filteren op naam of alle metrische gegevens aanvragen met behulp van Metrics-Group-All. Zie Ondersteunde metrische gegevens en logboekcategorieën per resourcetype voor een lijst met ondersteunde metrische gegevens.

Als u meer dan één metrische waarde van hetzelfde resourcetype wilt opgeven, maakt u een afzonderlijk streamitem voor elke metrische waarde.

In het volgende voorbeeld ziet u hoe u metrische gegevens filtert op naam.

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

JSON-objecten voor voorbeeldmetrieke export

In de volgende voorbeelden ziet u voorbeelden van DCR JSON-objecten voor het exporteren van metrische gegevens naar elk doeltype.

Log Analytics-werkruimten

In het volgende voorbeeld ziet u een regel voor het verzamelen van metrische gegevens waarmee specifieke metrische gegevens van virtuele machines, schaalsets van virtuele machines en alle metrische gegevens van sleutelkluizen naar een Log Analytics-werkruimte worden verzonden.

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

DCR's maken voor het exporteren van metrische gegevens

Maak DCR's voor het exporteren van metrische gegevens met behulp van de Azure-portal, CLI, PowerShell, REST API of ARM-sjabloon. Zie DcR (Een regel voor gegevensverzameling maken) voor het exporteren van metrische gegevens voor meer informatie.

Geëxporteerde gegevens

In de volgende voorbeelden ziet u de gegevens die naar elke bestemming zijn geëxporteerd.

Log Analytics-werkruimten

Gegevens die naar een Log Analytics-werkruimte worden geëxporteerd, worden opgeslagen in de AzureMetricsV2 tabel in de Log Analytics-werkruimte in de volgende indeling:

Rubriek Typologie Beschrijving
Gemiddeld reëel De gemiddelde waarde die in het tijdsbereik is verzameld.
_Facturatiegrootte reëel De omvang van het record in bytes
Aantal reëel Het aantal monsters dat tijdens de tijdsperiode is verzameld.
Dimensie dynamisch Gekoppelde dimensie van de metrische waarde in JSON-indeling.
_IsBillable # Geeft aan of iets factureerbaar is touw Specificeert of de inname van de gegevens factureerbaar is. Wanneer _IsBillable false is, wordt de invoer niet in rekening gebracht op uw Azure-account.
Maximaal reëel De maximumwaarde die binnen het tijdsbereik is verzameld.
Categorie voor Metriek touw Categorienaam van de metrische waarde.
Naam van de metriek touw Weergavenaam van de metrische waarde.
Type van metrische bron touw Resourcetype van de Azure-resource die de metrische gegevens rapporteert.
Minimaal reëel Minimale waarde verzameld in het tijdsbereik.
HulpbronId touw Een unieke identificatiecode voor de bron waarmee het record geassocieerd is.
BronSysteem touw Het type agent waarmee de gegevens van de gebeurtenis zijn verzameld. Bijvoorbeeld, OpsManager voor Windows-agenten, of het nu directe verbinding of Operations Manager betreft, Linux voor alle Linux-agenten, of Azure voor Azure Diagnostics.
_Abonneenummer touw Een unieke identificatie voor het abonnement waaraan het record is gekoppeld
huurder-ID touw De werkruimte-ID van Log Analytics
TijdstipGenereerd datum/tijd Tijdstempel (UTC) toen de record werd gegenereerd.
TimeGrain touw Tijdskorrel van de metriek.
Totaal reëel Som van alle waarden in het tijdsbereik.
Typologie touw De naam van de tabel
Eenheidsnaam touw Eenheid van de metrische waarde.

Voorbeeld:

Een schermopname van een Log Analytics-query van de AzureMetricsV2-tabel.

Opslagrekeningen

In het volgende voorbeeld ziet u gegevens die zijn geëxporteerd naar een opslagaccount:

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

In het volgende voorbeeld ziet u een metrische waarde die naar Event Hubs is geëxporteerd.

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

Volgende stappen