Exportation de métriques à l’aide de règles de collecte de données

Les métriques de plateforme mesurent les performances des différents aspects de vos ressources Azure. Les règles de télémétrie de plateforme data collection (DCRs) vous permettent de collecter et d’exporter des métriques de plateforme à partir de ressources Azure prises en charge. Cet article explique comment créer une DCR pour l’exportation de métriques.

Remarque

Bien que vous puissiez utiliser des contrôleurs de domaine et des paramètres de diagnostic en même temps, vous devez désactiver tous les paramètres de diagnostic pour les métriques lors de l’utilisation de contrôleurs de domaine pour éviter la collecte de données en double.

Comparer aux paramètres de diagnostic

Avant cette fonctionnalité, vous ne pouvez exporter que des métriques de plateforme à l’aide des paramètres de diagnostic. Les paramètres de diagnostic sont toujours requis pour les types de ressources qui ne prennent pas encore en charge les contrôleurs de domaine.

Les contrôleurs de domaine de télémétrie de plateforme offrent plusieurs avantages par rapport aux paramètres de diagnostic :

La configuration de DCR permet d’exporter des métriques avec des dimensions.
La configuration DCR active le filtrage en fonction du nom de la métrique afin de pouvoir exporter uniquement les métriques dont vous avez besoin.
Les DCR sont plus flexibles et évolutives que les paramètres de diagnostic. Utilisez une DCR unique avec plusieurs ressources, tandis qu’un paramètre de diagnostic distinct est requis pour chaque ressource.
La latence de bout en bout des DCR est inférieure à trois minutes, tandis que la latence d’exportation des paramètres de diagnostic est de six à dix minutes.

Remarque

Utilisez l’exportation des mesures avec les DCR pour exporter en continu les données de mesures au fur et à mesure de leur création. Pour interroger les données historiques déjà collectées, utilisez l’API Batch de métriques du plan de données. Consultez la comparaison entre la requête d'API de batch de métriques du plan de données et l'exportation de métriques pour évaluer les deux stratégies.

Destinations d’exportation

Les métriques peuvent être exportées vers les destinations suivantes.

Type de destination	Détails
Espaces de travail Log Analytics	L’exportation vers des espaces de travail Log Analytics peut couvrir plusieurs régions. L’espace de travail Log Analytics et la DCR doivent se trouver dans la même région, mais les ressources surveillées peuvent se trouver dans n’importe quelle région. Les métriques envoyées à un espace de travail Log Analytics sont stockées dans la table `AzureMetricsV2`.
Comptes de stockage Azure	Le compte de stockage, la DCR et les ressources surveillées doivent se trouver dans la même région.
Event Hubs	Les hubs d’événements, la DCR et les ressources surveillées doivent se trouver dans la même région.

Remarque

La latence pour l’exportation de métriques est d’environ 3 minutes. Après la configuration initiale, jusqu’à 15 minutes peuvent s’écouler avant que les métriques ne commencent à apparaître dans la destination.

Limites

Les DCR pour l’exportation de métriques présentent les limitations suivantes :

Un seul type de destination peut être spécifié par DCR. Pour envoyer à plusieurs destinations, créez plusieurs DCR.
Un maximum de 5 contrôleurs de domaine peuvent être associés à une seule ressource Azure.
L’exportation de métriques avec DCR ne prend pas en charge l’exportation de métriques à granularité horaire.

Ressources et régions prises en charge

Pour obtenir la liste actuelle des ressources prises en charge et des régions prises en charge, consultez Métriques exporter les ressources et les régions prises en charge.

Créez une règle de collecte de données (DCR) pour l'exportation de métriques

Cet article décrit comment créer une règle de collecte de données (DCR) pour l’exportation de métriques à l’aide du Portail Microsoft Azure, d’Azure CLI, de PowerShell, de l’API ou de modèles ARM.

Important

Pour envoyer des données de télémétrie de plateforme à des comptes de stockage ou à Event Hubs, la ressource, la règle de collecte des données et le compte de stockage de destination ou Event Hubs doivent tous se trouver dans la même région.

Créer une règle de collecte de données à l’aide du portail Azure

Dans le menu Surveiller dans le portail Azure, sélectionnez Règles de collecte de données , puis Créez.
Dans la page Créer une règle de collecte des données, entrez un nom de règle, sélectionnez un abonnement, une groupe de ressources et une région pour la DCR.
Sélectionnez PlatformTelemetry pour le type de télémétrie et activez l’identité managée si vous souhaitez envoyer des métriques à un compte de stockage ou à Event Hubs.
Dans la page Ressources, sélectionnez Ajouter des ressources pour ajouter les ressources à partir desquelles vous souhaitez collecter des métriques.
Sélectionnez Suivant pour accéder à l’onglet Collecter et remettre .
Sélectionnez Ajouter une nouvelle source de données.
Le type de ressource de la ressource spécifiée à l’étape précédente est automatiquement sélectionné. Ajoutez d’autres types de ressources si vous souhaitez utiliser cette règle pour collecter des métriques à partir de plusieurs types de ressources à l’avenir. Sélectionnez les actions d’un type de ressource si vous souhaitez supprimer certaines des métriques collectées pour celle-ci. Par défaut, toutes les métriques disponibles pour la ressource sont collectées.
Sélectionnez Destinations suivantes pour accéder à l’onglet Destinations .
Sélectionnez Ajouter une destination , puis le type de destination que vous souhaitez ajouter. Les champs obligatoires changent en fonction du type de destination que vous sélectionnez.

Remarque

Pour envoyer des métriques à un compte de stockage ou à Event Hubs, la ressource qui génère les métriques, le DCR et le compte de stockage ou Event Hub doivent tous se trouver dans la même région. Pour envoyer des métriques à un espace de travail Log Analytics, la DCR doit se trouver dans la même région que l’espace de travail Log Analytics. La ressource générant les métriques peut se trouver dans n’importe quelle région.
Sélectionnez Enregistrer, puis Vérifier + créer.

Créer une règle de collecte de données à l’aide d’Azure CLI

Créez un fichier JSON contenant la spécification de la règle de collecte. Pour plus d’informations, consultez la structure de règle de collecte de données (DCR) pour l’exportation des métriques. Pour obtenir des exemples de fichiers JSON, consultez Exemples de métriques Exporter des objets JSON.

Important

Le fichier de règle a le même format que celui utilisé pour PowerShell et l’API REST, mais le fichier ne doit pas contenir identity, le locationou kind. Ces paramètres sont spécifiés dans la commande az monitor data-collection rule create.

L’exemple de Azure CLI suivant utilise la commande az monitor data collection rule create.

subscriptionId="aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e"
resourceGroupName="myResourceGroup"
dataCollectionRuleName="myDataCollectionRule"
location="eastus"
ruleFile="./cli-dcr.json"

az account set --subscription "$subscriptionId"

az monitor data-collection rule create \
  --name "$dataCollectionRuleName" \
  --resource-group "$resourceGroupName" \
  --location "$location" \
  --kind PlatformTelemetry \
  --identity "{type:'SystemAssigned'}" \
  --rule-file "$ruleFile"

Remarque

Azure CLI commandes utilisent le point de terminaison Azure Resource Manager à partir du contexte CLI actuel. Par conséquent, management.azure.com n'a pas besoin d'être spécifié dans la syntaxe de commande.
Pour les destinations Compte de stockage et Event Hubs, vous devez activer l’identité managée pour la DCR à l’aide de --identity "{type:'SystemAssigned'}". L’identité n’est pas requise pour les espaces de travail Log Analytics.

Copiez le id et le principalId du DCR à partir de la sortie suivante afin de les utiliser pour attribuer le rôle permettant de créer une association entre le DCR et une ressource.

Output:

"id": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/myResourceGroup/providers/Microsoft.Insights/dataCollectionRules/myDataCollectionRule",
"identity": {
  "principalId": "eeeeeeee-ffff-aaaa-5555-666666666666",
  "tenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
  "type": "systemAssigned"
},

Accorder des autorisations d’écriture à l’identité managée

L’identité managée utilisée par la DCR doit disposer d’autorisations d’écriture sur la destination lorsque la destination est un Compte de stockage ou Event Hubs. Pour accorder des autorisations à l’identité managée associée à la règle, attribuez le rôle approprié à l’entité.

Le tableau suivant présente les rôles requis pour chaque type de destination :

Type de destination	Rôle
Espace de travail Log Analytics	non obligatoire
Compte de stockage Azure	`Storage Blob Data Contributor`
Event Hubs	`Azure Event Hubs Data Sender`

Pour plus d’informations sur l’attribution de rôles, consultez Affecter des rôles Azure à une identité managée.

Pour attribuer un rôle à une identité managée à l’aide de l’interface CLI, utilisez az role assignment create. Pour plus d’informations, consultez Attributions de rôles - Créer.

Attribuez le rôle approprié à l’identité managée de la DCR. L’exemple suivant affecte le rôle Storage Blob Data Contributor à l’identité managée de la DCR pour un compte de stockage.

L’exemple de Azure CLI suivant utilise la commande az role assignment create.

subscriptionId="aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e"
resourceGroupName="myResourceGroup"
storageAccountName="myStorageAccount"
principalId="eeeeeeee-ffff-aaaa-5555-666666666666"
roleDefinitionName="Storage Blob Data Contributor"
scope="/subscriptions/$subscriptionId/resourceGroups/$resourceGroupName/providers/Microsoft.Storage/storageAccounts/$storageAccountName"

az account set --subscription "$subscriptionId"

az role assignment create \
  --assignee "$principalId" \
  --role "$roleDefinitionName" \
  --scope "$scope"

Créer une association de règles de collecte des données

Après avoir créé la règle de collecte des données, créez une association de règles de collecte des données (DCRA) pour associer la règle à la ressource à surveiller. Pour plus d’informations, consultez Associations de règles de collecte de données - Créer.

L’exemple suivant utilise le groupe de commandes az monitor data-collection rule association pour create une association entre une règle de collecte de données et un Key Vault.

subscriptionId="aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e"
resourceGroupName="myResourceGroup"
associationName="myAssociation"
dataCollectionRuleName="myDataCollectionRule"
keyVaultName="myKeyVault"
dataCollectionRuleId="/subscriptions/$subscriptionId/resourceGroups/$resourceGroupName/providers/Microsoft.Insights/dataCollectionRules/$dataCollectionRuleName"
resourceUri="/subscriptions/$subscriptionId/resourceGroups/$resourceGroupName/providers/Microsoft.KeyVault/vaults/$keyVaultName"

az account set --subscription "$subscriptionId"

az monitor data-collection rule association create \
  --name "$associationName" \
  --rule-id "$dataCollectionRuleId" \
  --resource "$resourceUri"

Créer une règle de collecte de données à l’aide de PowerShell

L’exemple PowerShell suivant utilise l’applet de commande New-AzDataCollectionRule .

$subscriptionId = "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e"
$resourceGroupName = "myResourceGroup"
$dataCollectionRuleName = "myDataCollectionRule"
$jsonFilePath = ".\dcr-storage-account.json"

Set-AzContext -Subscription $subscriptionId

$dataCollectionRuleParams = @{
    Name              = $dataCollectionRuleName
    ResourceGroupName = $resourceGroupName
    JsonFilePath      = $jsonFilePath
}

New-AzDataCollectionRule @dataCollectionRuleParams

Copiez le id et le IdentityPrincipalId du DCR à partir de la sortie suivante afin de les utiliser pour attribuer le rôle permettant de créer une association entre le DCR et une ressource.

Output:

Id                                        : /subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/myResourceGroup/providers/Microsoft.Insights/dataCollectionRules/myDataCollectionRule
IdentityPrincipalId                       : eeeeeeee-ffff-aaaa-5555-666666666666
IdentityTenantId                          : aaaabbbb-0000-cccc-1111-dddd2222eeee
IdentityType                              : systemAssigned
IdentityUserAssignedIdentity              : {
                                            }

Accorder des autorisations d’écriture à l’identité managée

Le tableau suivant présente les rôles requis pour chaque type de destination :

Type de destination	Rôle
Espace de travail Log Analytics	non obligatoire
Compte de stockage Azure	`Storage Blob Data Contributor`
Event Hubs	`Azure Event Hubs Data Sender`

Pour plus d’informations, consultez Attribuer des rôles Azure à une identité managée.

Attribuez le rôle approprié à l’identité managée de la DCR à l’aide de New-AzRoleAssignment. L’exemple suivant attribue le rôle Azure Event Hubs Data Sender à l’identité managée de la DCR au niveau de l’abonnement.

L’exemple PowerShell suivant utilise l’applet de commande New-AzRoleAssignment .

$objectId = "eeeeeeee-ffff-aaaa-5555-666666666666"
$roleDefinitionName = "Azure Event Hubs Data Sender"
$subscriptionId = "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e"
$scope = "/subscriptions/$subscriptionId"

Set-AzContext -Subscription $subscriptionId

$roleAssignmentParams = @{
    ObjectId           = $objectId
    RoleDefinitionName = $roleDefinitionName
    Scope              = $scope
}

New-AzRoleAssignment @roleAssignmentParams

Créer une association de règles de collecte des données

Après avoir créé la règle de collecte des données, créez une association de règles de collecte des données (DCRA) pour associer la règle à la ressource à surveiller. Utilisez New-AzDataCollectionRuleAssociation pour créer une association entre une règle de collecte des données et une ressource. Pour plus d’informations, consultez New-AzDataCollectionRuleAssociation.

L’exemple PowerShell suivant utilise l’applet de commande New-AzDataCollectionRuleAssociation pour créer une association entre une règle de collecte de données et une Key Vault.

$subscriptionId = "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e"
$resourceGroupName = "myResourceGroup"
$associationName = "myDataCollectionRuleAssociation"
$keyVaultName = "myKeyVault"
$dataCollectionRuleName = "myDataCollectionRule"
$resourceUri = "/subscriptions/$subscriptionId/resourceGroups/$resourceGroupName/providers/Microsoft.KeyVault/vaults/$keyVaultName"
$dataCollectionRuleId = "/subscriptions/$subscriptionId/resourceGroups/$resourceGroupName/providers/Microsoft.Insights/dataCollectionRules/$dataCollectionRuleName"

Set-AzContext -Subscription $subscriptionId

$dataCollectionRuleAssociationParams = @{
    AssociationName      = $associationName
    ResourceUri          = $resourceUri
    DataCollectionRuleId = $dataCollectionRuleId
}

New-AzDataCollectionRuleAssociation @dataCollectionRuleAssociationParams

Pour créer une règle de collecte des données pour les métriques, procédez comme suit :

Créez la règle de collecte des données.
Accordez à l’identité managée de la règle les autorisations nécessaires pour écrire dans la destination.
Créez une association de règles de collecte des données.

Créer la règle de collecte de données

Pour créer une DCR à l’aide de l’API REST, vous devez effectuer une demande authentifiée à l’aide d’un jeton du porteur. Pour plus d’informations sur l’authentification auprès d’Azure Monitor, consultez Authentifier les requêtes Azure Monitor.

Utilisez le point de terminaison suivant pour créer une règle de collecte des données pour les métriques à l’aide de l’API REST. Pour plus d’informations, consultez Règles de collecte des données – Créer.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/dataCollectionRules/{dataCollectionRuleName}?api-version={apiVersion}
Authorization: Bearer {accessToken}
Content-Type: application/json

La charge utile est un objet JSON qui définit une règle de collecte. La charge utile est envoyée dans le corps de la requête. Pour plus d’informations sur la structure JSON, consultez la structure de règle de collecte de données (DCR) pour l’exportation des métriques. Pour obtenir des exemples d’objets JSON DCR, consultez Exemples d’objets JSON d’exportation de métriques.

Accorder des autorisations d’écriture à l’identité managée

Le tableau suivant présente les rôles requis pour chaque type de destination :

Type de destination	Rôle
Espace de travail Log Analytics	non obligatoire
Compte de stockage Azure	`Storage Blob Data Contributor`
Event Hubs	`Azure Event Hubs Data Sender`

Pour plus d’informations, consultez Attribuer des rôles Azure à une identité managée.

Pour attribuer un rôle à une identité managée à l’aide de REST, consultez Attributions de rôles - Créer.

Créer une association de règles de collecte des données

Pour créer une DCRA à l’aide de l’API REST, utilisez le point de terminaison et la charge utile suivants :

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{virtualMachineName}/providers/Microsoft.Insights/dataCollectionRuleAssociations/{associationName}?api-version={apiVersion}
Authorization: Bearer {accessToken}
Content-Type: application/json

{
  "properties": {
    "description": "Association of platform telemetry DCR with VM myVirtualMachine",
    "dataCollectionRuleId": "/subscriptions/<subscriptionId>/resourceGroups/<resourceGroupName>/providers/Microsoft.Insights/dataCollectionRules/<dataCollectionRuleName>"
  }
}

Créer une règle de collecte de données à l’aide de modèles Bicep

Utilisez le modèle suivant pour créer une DCR. Pour plus d’informations, consultez Microsoft.Insights dataCollectionRules.

@description('Specifies the name of the Data Collection Rule to create.')
param dataCollectionRuleName string

@description('Specifies the Log Analytics workspace.')
param workspaceId string

@description('Specifies the location in which to create the Data Collection Rule.')
param location string

resource dataCollectionRule 'Microsoft.Insights/dataCollectionRules@2024-03-11' = {
  name: dataCollectionRuleName
  kind: 'PlatformTelemetry'
  identity: {
    type: 'UserAssigned' | 'SystemAssigned'
    userAssignedIdentities: {
      type: 'string'
    }
  }
  location: location
  properties: {
    dataSources: {
      platformTelemetry: [
        {
          streams: [
            '<resourceType>:<metricName> | Metrics-Group-All'
          ]
          name: 'myPlatformTelemetryDataSource'
        }
      ]
    }
    destinations: {
      logAnalytics: [
        {
          workspaceResourceId: workspaceId
          name: 'myDestination'
        }
      ]
    }
    dataFlows: [
      {
        streams: [
          '<resourceType>:<metricName> | Metrics-Group-All'
        ]
        destinations: [
          'myDestination'
        ]
      }
    ]
  }
}

Fichier de paramètres

using './<template-name>.bicep'

param dataCollectionRuleName = 'myDataCollectionRule'

param workspaceId = '/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/myResourceGroup/providers/microsoft.operationalinsights/workspaces/myWorkspace'

param location = 'eastus'

Exemple de modèle DCR

@description('Specifies the name of the Data Collection Rule to create.')
param dataCollectionRuleName string

@description('Specifies the Log Analytics workspace.')
param workspaceId string

@description('Specifies the location in which to create the Data Collection Rule.')
param location string

resource dataCollectionRule 'Microsoft.Insights/dataCollectionRules@2024-03-11' = {
  name: dataCollectionRuleName
  location: location
  kind: 'PlatformTelemetry'
  identity: {
    type: 'SystemAssigned'
  }
  properties: {
    dataSources: {
      platformTelemetry: [
        {
          streams: [
            'Microsoft.Compute/virtualMachines:Metrics-Group-All'
            'Microsoft.Compute/virtualMachineScaleSets:Metrics-Group-All'
            'Microsoft.Cache/redis:Metrics-Group-All'
            'Microsoft.keyvault/vaults:Metrics-Group-All'
          ]
          name: 'myPlatformTelemetryDataSource'
        }
      ]
    }
    destinations: {
      logAnalytics: [
        {
          workspaceResourceId: workspaceId
          name: 'myDestination'
        }
      ]
    }
    dataFlows: [
      {
        streams: [
          'Microsoft.Compute/virtualMachines:Metrics-Group-All'
          'Microsoft.Compute/virtualMachineScaleSets:Metrics-Group-All'
          'Microsoft.Cache/redis:Metrics-Group-All'
          'Microsoft.keyvault/vaults:Metrics-Group-All'
        ]
        destinations: [
          'myDestination'
        ]
      }
    ]
  }
}

Créer une règle de collecte de données à l’aide de modèles ARM

Utilisez le modèle suivant pour créer une DCR. Pour plus d’informations, consultez Microsoft.Insights dataCollectionRules.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "dataCollectionRuleName": {
      "type": "string",
      "metadata": {
        "description": "Specifies the name of the Data Collection Rule to create."
      }
    },
    "workspaceId": {
      "type": "string",
      "metadata": {
        "description": "Specifies the Log Analytics workspace."
      }
    },
    "location": {
      "type": "string",
      "metadata": {
        "description": "Specifies the location in which to create the Data Collection Rule."
      }
    }
  },
  "resources": [
    {
      "type": "Microsoft.Insights/dataCollectionRules",
      "name": "[parameters('dataCollectionRuleName')]",
      "kind": "PlatformTelemetry",
      "identity": {
        "type": "UserAssigned" | "SystemAssigned",
        "userAssignedIdentities": {
          "type": "string"
        }
      },
      "location": "[parameters('location')]",
      "apiVersion": "2024-03-11",
      "properties": {
        "dataSources": {
          "platformTelemetry": [
            {
              "streams": [
                "<resourceType>:<metricName> | Metrics-Group-All"
              ],
              "name": "myPlatformTelemetryDataSource"
            }
          ]
        },
        "destinations": {
          "logAnalytics": [
            {
              "workspaceResourceId": "[parameters('workspaceId')]",
              "name": "myDestination"
            }
          ]
        },
        "dataFlows": [
          {
            "streams": [
              "<resourceType>:<metricName> | Metrics-Group-All"
            ],
            "destinations": [
              "myDestination"
            ]
          }
        ]
      }
    }
  ]
}

Fichier de paramètres

{
  "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentParameters.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "dataCollectionRuleName": {
      "value": "myDataCollectionRule"
    },
    "workspaceId": {
      "value": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/myResourceGroup/providers/microsoft.operationalinsights/workspaces/myWorkspace"
    },
    "location": {
      "value": "eastus"
    }
  }
}

Exemple de modèle DCR

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "resources": [
    {
      "type": "Microsoft.Insights/dataCollectionRules",
      "apiVersion": "2024-03-11",
      "name": "[parameters('dataCollectionRuleName')]",
      "location": "[parameters('location')]",
      "kind": "PlatformTelemetry",
      "identity": {
        "type": "SystemAssigned"
      },
      "properties": {
        "dataSources": {
          "platformTelemetry": [
            {
              "streams": [
                "Microsoft.Compute/virtualMachines:Metrics-Group-All",
                "Microsoft.Compute/virtualMachineScaleSets:Metrics-Group-All",
                "Microsoft.Cache/redis:Metrics-Group-All",
                "Microsoft.keyvault/vaults:Metrics-Group-All"
              ],
              "name": "myPlatformTelemetryDataSource"
            }
          ]
        },
        "destinations": {
          "logAnalytics": [
            {
              "workspaceResourceId": "[parameters('workspaceId')]",
              "name": "myDestination"
            }
          ]
        },
        "dataFlows": [
          {
            "streams": [
              "Microsoft.Compute/virtualMachines:Metrics-Group-All",
              "Microsoft.Compute/virtualMachineScaleSets:Metrics-Group-All",
              "Microsoft.Cache/redis:Metrics-Group-All",
              "Microsoft.keyvault/vaults:Metrics-Group-All"
            ],
            "destinations": [
              "myDestination"
            ]
          }
        ]
      }
    }
  ]
}

Variable	Exemple de valeur	Purpose
host	management.azure.com	Point de terminaison ARM implicite
subscriptionId	aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e	Entrée de l’utilisateur
resourceGroupName	myResourceGroup	Entrée de l’utilisateur
dataCollectionRuleName	myDataCollectionRule	Entrée de l’utilisateur
associationName	myAssociation	Entrée de l’utilisateur
location	eastus	Entrée de l’utilisateur
workspaceName	myWorkspace	Entrée de l’utilisateur
keyVaultName	myKeyVault	Entrée de l’utilisateur
storageAccountName	myStorageAccount	Entrée de l’utilisateur
monitoredResourceName	myKeyVault	Entrée de l’utilisateur
apiVersion	2024-03-11	Référence

Vérifier la collecte de données

Après avoir créé la DCR, autorisez jusqu’à 30 minutes pour que les données de métriques de la première plateforme apparaissent dans l’espace de travail Log Analytics. Une fois que les données commencent à circuler, la latence d’une série chronologique de métriques de plateforme qui transite vers un espace de travail Log Analytics, un compte de stockage ou Event Hubs est d’environ trois minutes, selon le type de ressource.

Données exportées

Les exemples suivants montrent les données exportées vers chaque destination.

Espace de travail Log Analytics

Les données exportées vers un espace de travail Log Analytics sont stockées dans la table AzureMetricsV2 dans l’espace de travail Log Analytics au format suivant :

Colonne	Type	Descriptif
Moyen	real	Valeur moyenne collectée pendant l’intervalle de temps.
_BilledSize	real	Taille de l’enregistrement en octets
Nombre	real	Nombre d’échantillons collectés pendant l’intervalle de temps.
Dimension	dynamic	Dimension associée de la métrique au format JSON.
_IsBillable	ficelle	Spécifie si l’ingestion des données est facturable. Quand _IsBillable est `false`, l’ingestion n’est pas facturée sur votre compte Azure.
Maximale	real	Valeur maximale collectée pendant l’intervalle de temps.
MetricCategory	ficelle	Nom de catégorie de la métrique.
Nom de la Mesure	ficelle	Nom d’affichage de la métrique.
Type de Ressource de Mesure	ficelle	Type de ressource de la ressource Azure rendant compte de la métrique.
Minimum	real	Valeur minimale collectée pendant l’intervalle de temps.
_ResourceId (Identifiant de Ressource)	ficelle	Un identificateur unique de la ressource à laquelle l’enregistrement est associé
SourceSystem	ficelle	Type d’agent ayant collecté l’événement. Par exemple, `OpsManager` pour l’agent Windows (connexion directe ou Operations Manager), `Linux` pour tous les agents Linux, ou `Azure` pour Diagnostics Azure.
_IdentifiantDeSouscription	ficelle	Un identificateur unique de l’abonnement auquel l’enregistrement est associé
Id de locataire	ficelle	ID de l’espace de travail Log Analytics
TimeGenerated	datetime	Timestamp (UTC) de la génération de l’enregistrement.
TimeGrain	ficelle	Granularité temporelle de la métrique.
Total	real	Somme de toutes les valeurs de l’intervalle de temps.
Type	ficelle	Le nom de la table de données
NomDeL'Unité	ficelle	Unité de la métrique.

Par exemple:

Comptes de stockage

L’exemple suivant montre les données exportées vers un compte de stockage :

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

L’exemple suivant montre une métrique exportée vers 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"
}

Vérifier et résoudre les problèmes de collecte de données

Une fois la DCR installé, plusieurs minutes peuvent s'écouler avant que les modifications prennent effet et que les données soient collectées avec la DCR mise à jour. Si vous ne voyez pas de données collectées, utilisez les fonctionnalités de surveillance DCR , qui incluent des métriques et des journaux pour faciliter la résolution des problèmes.

Les métriques DCR sont collectées automatiquement pour toutes les DCR et vous pouvez les analyser en utilisant un explorateur de métriques comme les métriques de plateforme pour d’autres ressources Azure. Activez les journaux d’erreurs DCR pour obtenir des informations détaillées sur les erreurs lorsque le traitement des données n’a pas réussi.

Vérifiez des métriques telles que Logs Ingestion Bytes per Min et Logs Rows Received per Min pour être certain que les données atteignent Azure Monitor. Si ce n’est pas le cas, vérifiez votre source de données pour être certain qu’elle envoie des données comme prévu.
Vérifiez Logs Rows Dropped per Min pour voir si des lignes sont supprimées. Cela peut ne pas indiquer une erreur, car les lignes peuvent être supprimées par une transformation. Si les lignes supprimées sont identiques à Logs Rows Dropped per Min, alors aucune donnée n’est ingérée dans l’espace de travail. Examinez Logs Transformation Errors per Min pour voir s’il existe des erreurs de transformation.
Vérifiez Logs Transformation Errors per Min pour déterminer s’il existe des erreurs liées aux transformations appliquées aux données entrantes. Ces erreurs peuvent être dues aux modifications apportées à la structure de données ou à la transformation elle-même.
Vérifiez la table DCRLogErrors pour voir si des erreurs d’ingestion ont été journalisées. Cela peut fournir des détails supplémentaires pour identifier la cause racine du problème.

Étapes suivantes

Commentaires

Cette page a-t-elle été utile ?

Last updated on 2026-06-02

Exportation de métriques à l’aide de règles de collecte de données

Comparer aux paramètres de diagnostic

Destinations d’exportation

Limites

Ressources et régions prises en charge

Créez une règle de collecte de données (DCR) pour l'exportation de métriques

Créer une règle de collecte de données à l’aide du portail Azure

Vérifier la collecte de données

Données exportées

Espace de travail Log Analytics

Comptes de stockage

Event Hubs

Vérifier et résoudre les problèmes de collecte de données

Étapes suivantes

Commentaires

Ressources supplémentaires