Metrische gegevens exporteren via regels voor gegevensverzameling (preview)

Artikel
09/23/2024

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 metrische gegevens exporteren met dimensies.
MET DCR-configuratie kunt u filteren op basis van de metrische naam, zodat u alleen de metrische gegevens kunt exporteren die u nodig hebt.
DCR's zijn flexibeler en schaalbaar in vergelijking met diagnostische instellingen.
De end-to-endlatentie 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 Regels voor gegevensverzameling maken voor metrische gegevens voor metrische gegevens voor 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 gegevensverzamelingsregels maken voor informatie over het maken van een DCRA. Wanneer u Azure Portal gebruikt, wordt de DCRA automatisch gemaakt.

Notitie

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.

Bestemmingen exporteren

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

Log Analytics-werkruimten.
Exporteren naar Log Analytics-werkruimten kan zich in verschillende regio's bevinden. 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 Storage-accounts.
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.

Notitie

Latentie voor het exporteren van metrische gegevens duurt ongeveer 3 minuten. Het duurt maximaal 15 minuten voordat metrische gegevens na de eerste installatie in het doel 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.
Export van metrische gegevens door DCR biedt geen ondersteuning voor de export van metrische gegevens per uur.

Ondersteunde resources en regio's

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

Brontype	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
Opslagaccounts	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
Operational Insights	Microsoft.operationalinsights/workspaces
Media Services	Microsoft.media/mediaservices Microsoft.media/mediaservices/streamingendpoints Microsoft.media/mediaservices/liveevents
Gegevensbescherming	Microsoft.dataprotection/backupvaults
Azure Kubernetes Service	Microsoft.ContainerService/managedClusters

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:

Australië - oost
Central US
CentralUsEuap
VS - zuid-centraal
VS - oost
VS - oost 2
Eastus2Euap
VS - west
VS - west 2
Europa - noord
Europa -west
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.

Eigenschappen	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>` Bijvoorbeeld `Microsoft.Compute/virtualMachines:Percentage CPU`
`dataSources.platformTelemetry.name`	De naam van de gegevensbron.
`destinations`	Het doel voor de metrische 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>` Bijvoorbeeld 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.

Notitie

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

Notitie

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 exporteren met voorbeeldgegevens

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 gegevens voor metrische gegevens waarmee specifieke metrische gegevens van virtuele machines, virtuele-machineschaalsets en alle metrische 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"
}

Opslagaccounts

In het volgende voorbeeld ziet u een regel voor het verzamelen van gegevens voor metrische gegevens die metrische gegevens van virtuele machines verzendenPercentage CPU, Disk Read Bytesen Inbound Flows metrische gegevens voor virtuele-machineschaalsets, Redis-cache en Sleutelkluizen naar een opslagaccount.

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

Event Hubs

In het volgende voorbeeld ziet u een regel voor het verzamelen van gegevens voor het exporteren van metrische gegevens waarmee alle metrische gegevens van virtuele machines en de ServiceApiHit metrische Availability gegevens van Key Vaults naar Event Hubs worden verzonden.

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

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:

Column	Type	Description
Gemiddeld	werkelijk	De gemiddelde waarde die in het tijdsbereik is verzameld.
_BilledSize	werkelijk	De recordgrootte in bytes
Tellen	werkelijk	Het aantal monsters dat tijdens het tijdsbereik is verzameld.
Dimensie	dynamisch	Gekoppelde dimensie van de metrische waarde in JSON-indeling.
_IsBillable	tekenreeks	Hiermee geeft u op of het opnemen van de gegevens factureerbaar is. Wanneer _IsBillable wordt `false` opgenomen, worden er geen kosten in rekening gebracht voor uw Azure-account
Maximum	werkelijk	De maximumwaarde die in het tijdsbereik is verzameld.
MetricCategory	tekenreeks	Categorienaam van de metrische waarde.
MetricName	tekenreeks	Weergavenaam van de metrische waarde.
MetricResourceType	tekenreeks	Resourcetype van de Azure-resource die de metrische gegevens rapporteert.
Minimum	werkelijk	Minimumwaarde verzameld in het tijdsbereik.
_ResourceId	tekenreeks	Een unieke id voor de resource waaraan de record is gekoppeld
SourceSystem	tekenreeks	Het type agent dat de gebeurtenis heeft verzameld. Bijvoorbeeld `OpsManager` voor Windows-agent, direct verbinding maken of Operations Manager, `Linux` voor alle Linux-agents of `Azure` voor Azure Diagnostics
_SubscriptionId	tekenreeks	Een unieke id voor het abonnement waaraan de record is gekoppeld
TenantId	tekenreeks	De Log Analytics-werkruimte-id
TimeGenerated	datetime	Tijdstempel (UTC) toen de record werd gegenereerd.
TimeGrain	tekenreeks	Tijdsinterval van de metrische waarde.
Totaal	werkelijk	Som van alle waarden in het tijdsbereik.
Type	tekenreeks	De naam van de tabel
UnitName	tekenreeks	Eenheid van de metrische waarde.

Voorbeeld:

Opslagaccounts

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

Delen via

Metrische gegevens exporteren via regels voor gegevensverzameling (preview)

Bestemmingen exporteren

Beperkingen

Ondersteunde resources en regio's

Ondersteunde regio’s

DCR-specificaties

JSON-indeling voor het exporteren van metrische gegevens DCR

Door de gebruiker en het systeem toegewezen identiteiten

Metrische gegevens filteren

JSON-objecten exporteren met voorbeeldgegevens

Log Analytics-werkruimten

Opslagaccounts

Event Hubs

DCR's maken voor het exporteren van metrische gegevens

Geëxporteerde gegevens

Log Analytics-werkruimten

Opslagaccounts

Event Hubs

Volgende stappen

Feedback

Aanvullende resources