Partager via

Procédure pas à pas d’utilisation de l’API REST d’Azure Monitoring

  • Article

Cet article vous montre comment utiliser la référence API REST d’Azure Monitor.

Récupérez des définitions de métriques, des valeurs de dimension et des valeurs de métrique à l’aide de l’API Azure Monitor, puis utilisez les données de vos applications, ou stockez-les dans une base de données à des fins d’analyse. Vous pouvez également répertorier les règles d’alerte et afficher les journaux d’activité en utilisant l’API Azure Monitor.

Authentification des demandes Azure Monitor

Une requête envoyée à l’aide de l’API Azure Monitor utilise le modèle d’authentification d’Azure Resource Manager. Toutes les requêtes sont authentifiées avec Microsoft Entra ID. Une approche pour authentifier l’application cliente consiste à créer un principal de service Microsoft Entra et à récupérer un jeton d’authentification. Vous pouvez créer un principal de service Microsoft Entra à l’aide du Portail Azure, de l’interface CLI ou de PowerShell. Pour plus d’informations, consultez Inscrire une application pour demander des jetons d’autorisation et utiliser des API.

Récupérer un jeton

Une fois que vous avez créé un principal de service, récupérez un jeton d’accès. Spécifiez resource=https://management.azure.com dans la demande de jeton.

Obtenez un jeton d’authentification à l’aide de l’une des méthodes suivantes :

  • INTERFACE DE LIGNE DE COMMANDE
  • API REST
  • Kit SDK

Lors de la demande d’un jeton, vous devez fournir un paramètre resource. Le paramètre resource est l’URL de la ressource que vous souhaitez accéder.

Les ressources incluent :

  • https://management.azure.com
  • https://api.loganalytics.io
  • https://monitoring.azure.com

Obtenir un jeton à l’aide d’une requête REST

Utilisez l’appel d’API REST suivant pour obtenir un jeton. Cette demande utilise un ID client et une clé secrète client pour authentifier la demande. L’ID client et la clé secrète client sont obtenus lorsque vous inscrivez votre application auprès de Microsoft Entra ID. Pour plus d’informations, voir Inscrire une application pour demander des jetons d’autorisation et utiliser des API

curl -X POST 'https://login.microsoftonline.com/<tennant ID>/oauth2/token' \
-H 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'grant_type=client_credentials' \
--data-urlencode 'client_id=<your apps client ID>' \
--data-urlencode 'client_secret=<your apps client secret' \
--data-urlencode 'resource=https://monitoring.azure.com'

Le corps de la réponse apparaît au format suivant :

{
    "token_type": "Bearer",
    "expires_in": "86399",
    "ext_expires_in": "86399",
    "expires_on": "1672826207",
    "not_before": "1672739507",
    "resource": "https://monitoring.azure.com",
    "access_token": "eyJ0eXAiOiJKV1Qi....gpHWoRzeDdVQd2OE3dNsLIvUIxQ"
}

Après l’authentification et la récupération d’un jeton, utilisez le jeton d’accès dans vos demandes d’API Azure Monitor en incluant l’en-tête 'Authorization: Bearer <access token>'

Notes

Pour plus d’informations sur l’utilisation de l’API REST Azure, reportez-vous à la référence de l’API REST Azure.

Récupération de l’ID de ressource

L’utilisation de l’API REST nécessite l’ID de ressource de la ressource Azure cible. Les ID de ressource doivent suivre le modèle suivant :

/subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/<provider>/<resource name>/

Par exemple

  • Azure IoT Hub : /subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.Devices/IotHubs/<iot-hub-name>
  • Pool SQL élastique : /subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.Sql/servers/<pool-db>/elasticpools/<sql-pool-name>
  • Azure SQL Database (v12) : /subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.Sql/servers/<server-name>/databases/<database-name>
  • Azure Service Bus : /subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.ServiceBus/<namespace>/<servicebus-name>
  • Azure Virtual Machine Scale Sets : /subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.Compute/virtualMachineScaleSets/<vm-name>
  • Machines virtuelles Azure : /subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.Compute/virtualMachines/<vm-name>
  • Azure Event Hubs : /subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.EventHub/namespaces/<eventhub-namespace>

Utilisez le portail Azure, PowerShell ou Azure CLI pour rechercher l’ID de ressource.

Pour trouver l’ID de ressource sur le portail, dans la page de présentation de la ressource, sélectionnez Vue JSONCapture d’écran montrant la page de présentation d’une ressource avec le lien Vue JSON mis en évidence.

La page JSON de ressource s’affiche. Vous pouvez copier l’ID de ressource à l’aide de l’icône située à droite de l’ID.

Capture d’écran montrant la page JSON de ressource pour une ressource.

Points de terminaison d’API

Les points de terminaison de l'API utilisent le modèle suivant :
/<resource URI>/providers/microsoft.insights/<metrics|metricDefinitions>?api-version=<apiVersion>
Le resource URI est composé des composants suivants :
/subscriptions/<subscription id>/resourcegroups/<resourceGroupName>/providers/<resourceProviderNamespace>/<resourceType>/<resourceName>/

Important

Assurez-vous d'inclure /providers/microsoft.insights/ après l'URI de la ressource lorsque vous effectuez un appel d'API pour récupérer d’indicateurs de performance ou des définitions d’indicateurs de performance.

Récupérer les définitions des métriques

Utilisez l’API REST de définitions de mesures Azure Monitor pour accéder à la liste des mesures disponibles pour un service. Utilisez le format de requête suivant pour récupérer des définitions de métriques.

GET /subscriptions/<subscription id>/resourcegroups/<resourceGroupName>/providers/<resourceProviderNamespace>/<resourceType>/<resourceName>/providers/microsoft.insights/metricDefinitions?api-version=<apiVersion>
Host: management.azure.com
Content-Type: application/json
Authorization: Bearer <access token>

Par exemple, la requête suivante récupère les définitions de métriques d’un compte Stockage Azure.

curl --location --request GET 'https://management.azure.com/subscriptions/12345678-abcd-98765432-abcdef012345/resourceGroups/azmon-rest-api-walkthrough/providers/Microsoft.Storage/storageAccounts/ContosoStorage/providers/microsoft.insights/metricDefinitions?api-version=2018-01-01'
--header 'Authorization: Bearer eyJ0eXAiOi...xYz

Le document JSON suivant montre un exemple de corps de réponse. Dans cet exemple, seule la deuxième métrique a des dimensions.

{
    "value": [
        {
            "id": "/subscriptions/12345678-abcd-98765432-abcdef012345/resourceGroups/azmon-rest-api-walkthrough/providers/Microsoft.Storage/storageAccounts/ContosoStorage/providers/microsoft.insights/metricdefinitions/UsedCapacity",
            "resourceId": "/subscriptions/12345678-abcd-98765432-abcdef012345/resourceGroups/azmon-rest-api-walkthrough/providers/Microsoft.Storage/storageAccounts/ContosoStorage",
            "namespace": "Microsoft.Storage/storageAccounts",
            "category": "Capacity",
            "name": {
                "value": "UsedCapacity",
                "localizedValue": "Used capacity"
            },
            "isDimensionRequired": false,
            "unit": "Bytes",
            "primaryAggregationType": "Average",
            "supportedAggregationTypes": [
                "Total",
                "Average",
                "Minimum",
                "Maximum"
            ],
            "metricAvailabilities": [
                {
                    "timeGrain": "PT1H",
                    "retention": "P93D"
                },
                 ...
                {
                    "timeGrain": "PT12H",
                    "retention": "P93D"
                },
                {
                    "timeGrain": "P1D",
                    "retention": "P93D"
                }
            ]
        },
        {
            "id": "/subscriptions/12345678-abcd-98765432-abcdef012345/resourceGroups/azmon-rest-api-walkthrough/providers/Microsoft.Storage/storageAccounts/ContosoStorage/providers/microsoft.insights/metricdefinitions/Transactions",
            "resourceId": "/subscriptions/12345678-abcd-98765432-abcdef012345/resourceGroups/azmon-rest-api-walkthrough/providers/Microsoft.Storage/storageAccounts/ContosoStorage",
            "namespace": "Microsoft.Storage/storageAccounts",
            "category": "Transaction",
            "name": {
                "value": "Transactions",
                "localizedValue": "Transactions"
            },
            "isDimensionRequired": false,
            "unit": "Count",
            "primaryAggregationType": "Total",
            "supportedAggregationTypes": [
                "Total"
            ],
            "metricAvailabilities": [
                {
                    "timeGrain": "PT1M",
                    "retention": "P93D"
                },
                {
                    "timeGrain": "PT5M",
                    "retention": "P93D"
                },
                ...
                {
                    "timeGrain": "PT30M",
                    "retention": "P93D"
                },
                {
                    "timeGrain": "PT1H",
                    "retention": "P93D"
                },
                ...
                {
                    "timeGrain": "P1D",
                    "retention": "P93D"
                }
            ],
            "dimensions": [
                {
                    "value": "ResponseType",
                    "localizedValue": "Response type"
                },
                {
                    "value": "GeoType",
                    "localizedValue": "Geo type"
                },
                {
                    "value": "ApiName",
                    "localizedValue": "API name"
                }
            ]
        },
        ...
    ]
}

Notes

Nous vous recommandons d’utiliser la version d’API « 2018-01-01 » ou une version ultérieure. Les versions antérieures de l’API des définitions de métrique ne prennent pas en charge les dimensions.

Récupérer des valeurs de dimension

Après avoir récupéré les définitions de métrique disponibles, récupérez la plage de valeurs pour les dimensions de la métrique. Utilisez des valeurs de dimension pour filtrer ou segmenter les métriques dans vos requêtes. Utilise l’API REST de métriques Azure Monitor pour rechercher toutes les valeurs pour une dimension de métrique donnée.

Utilisez l’élément name.value la métrique dans les définitions de filtre. Si aucun filtre n’est spécifié, la mesure par défaut est renvoyée. L’API permet à une seule dimension d’avoir un filtre de caractère générique. Spécifiez la demande pour les valeurs de dimension à l’aide du paramètre de requête "resultType=metadata". resultType est omis pour une demande de valeurs de métrique.

Notes

Pour récupérer les valeurs de dimension à l’aide de l’API REST Azure Monitor, utilisez la version d’API « 2019-07-01 » ou une version ultérieure.

Utilisez le format de requête suivant pour récupérer des valeurs de dimension.

GET /subscriptions/<subscription-id>/resourceGroups/  
<resource-group-name>/providers/<resource-provider-namespace>/  
<resource-type>/<resource-name>/providers/microsoft.insights/  
metrics?metricnames=<metric>  
&timespan=<starttime/endtime>  
&$filter=<filter>  
&resultType=metadata  
&api-version=<apiVersion>   HTTP/1.1
Host: management.azure.com
Content-Type: application/json
Authorization: Bearer <access token>

L’exemple suivant récupère la liste des valeurs de dimension qui ont été émises pour la dimension API Name de la métrique Transactions, où la dimension GeoType a la valeur Primary, pour l’intervalle de temps spécifié.

curl --location --request GET 'https://management.azure.com/subscriptions/12345678-abcd-98765432-abcdef012345/resourceGroups/azmon-rest-api-walkthrough/providers/Microsoft.Storage/storageAccounts/ContosoStorage/providers/microsoft.insights/metrics  \
?metricnames=Transactions \
&timespan=2023-03-01T00:00:00Z/2023-03-02T00:00:00Z \
&resultType=metadata \
&$filter=GeoType eq \'Primary\' and ApiName eq \'*\' \
&api-version=2019-07-01'
-header 'Content-Type: application/json' \
--header 'Authorization: Bearer eyJ0e..meG1lWm9Y'

Le document JSON suivant montre un exemple de corps de réponse.

{
  "timespan": "2023-03-01T00:00:00Z/2023-03-02T00:00:00Z",
  "value": [
    {
      "id": "/subscriptions/12345678-abcd-98765432-abcdef012345/resourceGroups/azmon-rest-api-walkthrough/providers/Microsoft.Storage/storageAccounts/ContosoStorage/providers/Microsoft.Insights/metrics/Transactions",
      "type": "Microsoft.Insights/metrics",
      "name": {
        "value": "Transactions",
        "localizedValue": "Transactions"
      },
      "unit": "Count",
      "timeseries": [
        {
          "metadatavalues": [
            {
              "name": {
                "value": "apiname",
                "localizedValue": "apiname"
              },
              "value": "DeleteBlob"
            }
          ]
        },
        {
          "metadatavalues": [
            {
              "name": {
                "value": "apiname",
                "localizedValue": "apiname"
              },
              "value": "SetBlobProperties"
            }
          ]
        },
        ...
      ]
    }
  ],
  "namespace": "Microsoft.Storage/storageAccounts",
  "resourceregion": "eastus"
}

Récupération des valeurs des métriques

Une fois les définitions de métrique et les valeurs de dimension récupérées, récupérez les valeurs de métrique. Utilisez l’API REST des métriques Azure Monitor pour récupérer les valeurs de métriques.

Utilisez l’élément name.value la métrique dans les définitions de filtre. Si aucun filtre de dimension n’est spécifié, la métrique agrégée regroupée est retournée.

Série chronologique multiple

Une série chronologique est un ensemble de points de données classés par heure pour une combinaison donnée de dimensions. Une dimension est un aspect de la métrique qui décrit le point de données tel que l’ID de ressource, la région ou ApiName.

  • Pour extraire plusieurs séries chronologiques avec des valeurs de dimension spécifiques, spécifiez un paramètre de requête de filtre qui spécifie les valeurs de dimension, telles que "&$filter=ApiName eq 'ListContainers' or ApiName eq 'GetBlobServiceProperties'". Dans cet exemple, vous obtenez une série chronologique où ApiName se trouve ListContainers et une deuxième série chronologique où ApiName se GetBlobServicePropertiestrouve .
  • Pour retourner une série chronologique pour chaque valeur d’une dimension donnée, utilisez un filtre * comme "&$filter=ApiName eq '*'". Utilisez les paramètres de requête Top et OrderBy pour limiter et trier le nombre de séries chronologiques retournées. Dans cet exemple, vous obtenez une série chronologique pour chaque valeur du ApiNamejeu de résultats. Si aucune donnée n’est retournée, l’API retourne une série chronologique vide "timeseries": [].

Remarque

Pour récupérer les valeurs métriques multidimensionnelles à l’aide de l’API REST Azure Monitor, utilisez l’API version « 2019-07-01 » ou une version ultérieure.

Utilisez le format de requête suivant pour récupérer des valeurs de métriques.

GET /subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/<resource-provider-namespace>/<resource-type>/<resource-name>/providers/microsoft.insights/metrics?metricnames=<metric>&timespan=<starttime/endtime>&$filter=<filter>&interval=<timeGrain>&aggregation=<aggreation>&api-version=<apiVersion>
Host: management.azure.com
Content-Type: application/json
Authorization: Bearer <access token>

L’exemple suivant récupère les trois principales API, par le nombre de Transactions dans l’ordre décroissant des valeurs, pendant une plage de 5 minutes, où la dimension GeoType a une valeur de Primary.

curl --location --request GET 'https://management.azure.com/subscriptions/12345678-abcd-98765432-abcdef012345/resourceGroups/azmon-rest-api-walkthrough/providers/Microsoft.Storage/storageAccounts/ContosoStorage/providers/microsoft.insights/metrics \
?metricnames=Transactions \
&timespan=2023-03-01T02:00:00Z/2023-03-01T02:05:00Z \
& $filter=apiname eq '\''GetBlobProperties'\'
&interval=PT1M \
&aggregation=Total  \
&top=3 \
&orderby=Total desc \
&api-version=2019-07-01"' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer yJ0eXAiOi...g1dCI6Ii1LS'

Le document JSON suivant montre un exemple de corps de réponse.

{
  "cost": 0,
  "timespan": "2023-03-01T02:00:00Z/2023-03-01T02:05:00Z",
  "interval": "PT1M",
  "value": [
    {
      "id": "/subscriptions/12345678-abcd-98765432-abcdef012345/resourceGroups/azmon-rest-api-walkthrough/providers/Microsoft.Storage/storageAccounts/ContosoStorage/providers/Microsoft.Insights/metrics/Transactions",
      "type": "Microsoft.Insights/metrics",
      "name": {
        "value": "Transactions",
        "localizedValue": "Transactions"
      },
      "unit": "Count",
      "timeseries": [
        {
          "metadatavalues": [
            {
              "name": {
                "value": "apiname",
                "localizedValue": "apiname"
              },
              "value": "GetBlobProperties"
            }
          ],
          "data": [
            {
              "timeStamp": "2023-09-19T02:00:00Z",
              "total": 2
            },
            {
              "timeStamp": "2023-09-19T02:01:00Z",
              "total": 1
            },
            {
              "timeStamp": "2023-09-19T02:02:00Z",
              "total": 3
            },
            {
              "timeStamp": "2023-09-19T02:03:00Z",
              "total": 7
            },
            {
              "timeStamp": "2023-09-19T02:04:00Z",
              "total": 2
            }
          ]
        },
        ...
      ]
    }
  ],
  "namespace": "Microsoft.Storage/storageAccounts",
  "resourceregion": "eastus"
}

Interrogation de métriques pour plusieurs ressources à la fois

Outre l’interrogation de métriques pour une ressource individuelle, certains types de ressources offrent également la possibilité d’interroger plusieurs ressources dans une même requête. Ces API constituent le socle de l’expérience multi-ressource dans Azure Metrics Explorer. Les types de ressources qui prennent en charge l’interrogation de plusieurs métriques sont visibles dans le panneau Métriques d’Azure Monitor via la liste déroulante Type de ressource située dans le sélecteur d’étendue du panneau de contexte. Pour plus d’informations, consultez la documentation sur l’expérience utilisateur multi-ressource.

L’interrogation de métriques varie sensiblement selon qu’elle porte sur plusieurs ressources ou sur des ressources individuelles.

  • Les API multi-ressources de métriques fonctionnent au niveau de l’abonnement et non au niveau de l’ID de ressource. Cette restriction signifie que les utilisateurs qui interrogent ces API doivent disposer d’autorisations Lecteur d’analyse sur l’abonnement proprement dit.
  • Les API multiressources de métriques ne prennent en charge qu’un seul resourceType par requête, qui doit être spécifié sous la forme d’un paramètre de requête d’espace de noms de métrique.
  • Les API multi-ressources de métriques ne prennent en charge qu’une seule région Azure par requête, qui doit être spécifiée sous la forme d’un paramètre de requête region.

Exemples d’interrogations de métriques pour plusieurs ressources

L'exemple suivant montre une requête de définitions de indicateurs de performance individuelles :

GET https://management.azure.com/subscriptions/12345678-abcd-98765432-abcdef012345/resourceGroups/EASTUS-TESTING/providers/Microsoft.Compute/virtualMachines/TestVM1/providers/microsoft.insights/metricdefinitions?api-version=2021-05-01

La requête suivante montre la requête de définitions d’indicateurs de performance équivalentes pour plusieurs ressources. Les seuls changements portent sur le chemin de l’abonnement, qui remplace le chemin de l’ID de ressource, et l’ajout des paramètres de requête region et metricNamespace.

GET https://management.azure.com/subscriptions/12345678-abcd-98765432-abcdef012345/providers/microsoft.insights/metricdefinitions?api-version=2021-05-01&region=eastus&metricNamespace=microsoft.compute/virtualmachines

L’exemple suivant montre une requête de métriques individuelle.

GET https://management.azure.com/subscriptions/12345678-abcd-98765432-abcdef012345/resourceGroups/EASTUS-TESTING/providers/Microsoft.Compute/virtualMachines/TestVM1/providers/microsoft.Insights/metrics?timespan=2023-06-25T22:20:00.000Z/2023-06-26T22:25:00.000Z&interval=PT5M&metricnames=Percentage CPU&aggregation=average&api-version=2021-05-01

Voici une demande de métriques équivalente pour plusieurs ressources :

GET https://management.azure.com/subscriptions/12345678-abcd-98765432-abcdef012345/providers/microsoft.Insights/metrics?timespan=2023-06-25T22:20:00.000Z/2023-06-26T22:25:00.000Z&interval=PT5M&metricnames=Percentage CPU&aggregation=average&api-version=2021-05-01&region=eastus&metricNamespace=microsoft.compute/virtualmachines&$filter=Microsoft.ResourceId eq '*'

Remarque

Un filtre Microsoft.ResourceId eq '*' est ajouté dans l’exemple pour les requêtes de métriques multiressources. Le filtre * indique à l’API de retourner une série chronologique distincte pour chaque ressource de machine virtuelle disposant de données dans l’abonnement et la région. Sans le filtre, l’API retournerait une seule série chronologique agrégeant le processeur moyen pour toutes les machines virtuelles. La série chronologique de chaque ressource se distingue par la valeur de métadonnées Microsoft.ResourceId de chaque entrée de la série chronologique, comme le montre l’exemple de valeur de retour suivant. Si aucun resourceId n’est récupéré par cette requête, une série chronologique vide"timeseries": [] est retournée.

{
    "timespan": "2023-06-25T22:35:00Z/2023-06-26T22:40:00Z",
    "interval": "PT6H",
    "value": [
        {
            "id": "subscriptions/12345678-abcd-98765432-abcdef012345/providers/Microsoft.Insights/metrics/Percentage CPU",
            "type": "Microsoft.Insights/metrics",
            "name": {
                "value": "Percentage CPU",
                "localizedValue": "Percentage CPU"
            },
            "displayDescription": "The percentage of allocated compute units that are currently in use by the Virtual Machine(s)",
            "unit": "Percent",
            "timeseries": [
                {
                    "metadatavalues": [
                        {
                            "name": {
                                "value": "Microsoft.ResourceId",
                                "localizedValue": "Microsoft.ResourceId"
                            },
                            "value": "/subscriptions/12345678-abcd-98765432-abcdef012345/resourceGroups/EASTUS-TESTING/providers/Microsoft.Compute/virtualMachines/TestVM1"
                        }
                    ],
                    "data": [
                        {
                            "timeStamp": "2023-06-25T22:35:00Z",
                            "average": 3.2618888888888886
                        },
                        {
                            "timeStamp": "2023-06-26T04:35:00Z",
                            "average": 4.696944444444445
                        },
                        {
                            "timeStamp": "2023-06-26T10:35:00Z",
                            "average": 6.19701388888889
                        },
                        {
                            "timeStamp": "2023-06-26T16:35:00Z",
                            "average": 2.630347222222222
                        },
                        {
                            "timeStamp": "2023-06-26T22:35:00Z",
                            "average": 21.288999999999998
                        }
                    ]
                },
                {
                    "metadatavalues": [
                        {
                            "name": {
                                "value": "Microsoft.ResourceId",
                                "localizedValue": "Microsoft.ResourceId"
                            },
                            "value": "/subscriptions/12345678-abcd-98765432-abcdef012345/resourceGroups/EASTUS-TESTING/providers/Microsoft.Compute/virtualMachines/TestVM2"
                        }
                    ],
                    "data": [
                        {
                            "timeStamp": "2023-06-25T22:35:00Z",
                            "average": 7.567069444444444
                        },
                        {
                            "timeStamp": "2023-06-26T04:35:00Z",
                            "average": 5.111835883171071
                        },
                        {
                            "timeStamp": "2023-06-26T10:35:00Z",
                            "average": 10.078277777777778
                        },
                        {
                            "timeStamp": "2023-06-26T16:35:00Z",
                            "average": 8.399097222222222
                        },
                        {
                            "timeStamp": "2023-06-26T22:35:00Z",
                            "average": 2.647
                        }
                    ]
                },
                {
                    "metadatavalues": [
                        {
                            "name": {
                                "value": "Microsoft.ResourceId",
                                "localizedValue": "Microsoft.ResourceId"
                            },
                            "value": "/subscriptions/12345678-abcd-98765432-abcdef012345/resourceGroups/Common-TESTING/providers/Microsoft.Compute/virtualMachines/CommonVM1"
                        }
                    ],
                    "data": [
                        {
                            "timeStamp": "2023-06-25T22:35:00Z",
                            "average": 6.892319444444444
                        },
                        {
                            "timeStamp": "2023-06-26T04:35:00Z",
                            "average": 3.5054305555555554
                        },
                        {
                            "timeStamp": "2023-06-26T10:35:00Z",
                            "average": 8.398817802503476
                        },
                        {
                            "timeStamp": "2023-06-26T16:35:00Z",
                            "average": 6.841666666666667
                        },
                        {
                            "timeStamp": "2023-06-26T22:35:00Z",
                            "average": 3.3850000000000002
                        }
                    ]
                }
            ],
            "errorCode": "Success"
        }
    ],
    "namespace": "microsoft.compute/virtualmachines",
    "resourceregion": "eastus"
}

Résolution des problèmes liés à l’interrogation de métriques pour plusieurs ressources

  • Série chronologique vide retournée "timeseries": []

    • Une série chronologique vide est retournée quand aucune donnée n’est disponible pour l’intervalle de temps et le filtre spécifiés. La cause la plus courante est la spécification d’un intervalle de temps qui ne contient aucune donnée. Par exemple, si l’intervalle de temps a la valeur d’une date future.
    • Une autre cause courante est la spécification d’un filtre qui ne correspond à aucune ressource. Par exemple, si le filtre spécifie une valeur de dimension qui n’existe dans aucune ressource de la combinaison abonnement et région, "timeseries": [] est retourné.

  • Filtres de caractères génériques
    L’utilisation d’un filtre de caractères génériques tel que Microsoft.ResourceId eq '*' permet à l’API de retourner une série chronologique pour chaque resourceId de l’abonnement et de la région. Si la combinaison abonnement et région ne contient aucune ressource, une série chronologique vide est retournée. La même requête sans filtre de caractères génériques retourne une seule série chronologique, en agrégeant la métrique demandée sur les dimensions demandées, par exemple l’abonnement et la région.

  • 401 Erreurs d’autorisation :
    Les API de métriques de ressources individuelles imposent à l’utilisateur de disposer de l’autorisation Lecteur d’analyse sur la ressource interrogée. Les API de métriques multi-ressources étant des API de niveau abonnement, les utilisateurs doivent disposer de l’autorisation Lecteur d’analyse pour l’abonnement interrogé pour pouvoir utiliser les API de métriques multi-ressources. Même si les utilisateurs disposent de l’autorisation Lecture d’analyse sur toutes les ressources d’un abonnement, la demande échoue si l’utilisateur ne dispose pas de cette autorisation sur l’abonnement proprement dit.

Étapes suivantes