az monitor metrics
Affichez les métriques de ressources Azure.
Commandes
| Nom | Description | Type | État |
|---|---|---|---|
| az monitor metrics alert |
Gérez les règles d’alerte de métrique en temps quasi réel. |
Core | GA |
| az monitor metrics alert condition |
Gérer les conditions de règle d’alerte de métrique en temps quasi réel. |
Core | GA |
| az monitor metrics alert condition create |
Générez une condition de règle d’alerte de métrique. |
Core | Preview |
| az monitor metrics alert create |
Créez une règle d’alerte basée sur des métriques. |
Core | GA |
| az monitor metrics alert delete |
Supprimez une règle d’alerte basée sur des métriques. |
Core | GA |
| az monitor metrics alert dimension |
Gérer les dimensions de règle d’alerte de métrique en quasi-temps réel. |
Core | GA |
| az monitor metrics alert dimension create |
Générez une dimension de règle d’alerte de métrique. |
Core | Preview |
| az monitor metrics alert list |
Répertoriez les règles d’alerte basées sur les métriques. |
Core | GA |
| az monitor metrics alert show |
Afficher une règle d’alerte basée sur des métriques. |
Core | GA |
| az monitor metrics alert update |
Mettez à jour une règle d’alerte basée sur des métriques. |
Core | GA |
| az monitor metrics list |
Répertoriez les valeurs de métrique d’une ressource. |
Core | GA |
| az monitor metrics list-definitions |
Répertoriez les définitions de métriques de la ressource. |
Core | GA |
| az monitor metrics list-namespaces |
Répertoriez les espaces de noms de métriques de la ressource. |
Core | Preview |
| az monitor metrics list-sub |
Répertorie les données de métrique d’un abonnement. Les paramètres peuvent être spécifiés sur le corps. |
Core | GA |
| az monitor metrics list-sub-definitions |
Répertoriez les définitions de métriques de l’abonnement. |
Core | GA |
az monitor metrics list
Répertoriez les valeurs de métrique d’une ressource.
az monitor metrics list --resource
[--aggregation {Average, Count, Maximum, Minimum, None, Total}]
[--dimension]
[--end-time]
[--filter]
[--interval]
[--metadata]
[--metrics]
[--namespace]
[--offset]
[--orderby]
[--resource-group]
[--resource-namespace]
[--resource-parent]
[--resource-type]
[--start-time]
[--top]
Exemples
Répertorier l’utilisation du processeur d’une machine virtuelle pendant la dernière heure
az monitor metrics list --resource {ResourceName} --metric "Percentage CPU"
Répertorier la latence E2E réussie d’un compte de stockage et fractionner la série de données en fonction du nom de l’API
az monitor metrics list --resource {ResourceName} --metric SuccessE2ELatency \
--dimension ApiName
Répertorier la latence E2E réussie d’un compte de stockage et fractionner la série de données en fonction du nom de l’API et du type géographique
az monitor metrics list --resource {ResourceName} --metric SuccessE2ELatency \
--dimension ApiName GeoType
Répertorier la latence E2E d’un compte de stockage et fractionner la série de données en fonction du nom de l’API et du type géographique à l’aide du paramètre « --filter »
az monitor metrics list --resource {ResourceName} --metric SuccessE2ELatency \
--filter "ApiName eq '*' and GeoType eq '*'"
Répertoriez la latence E2E réussie d’un compte de stockage et fractionnez la série de données en fonction du nom de l’API et du type géographique. Limite le nom de l’API à « DeleteContainer »
az monitor metrics list --resource {ResourceName} --metric SuccessE2ELatency \
--filter "ApiName eq 'DeleteContainer' and GeoType eq '*'"
Répertorier les transactions d’un compte de stockage par jour depuis 2017-01-01
az monitor metrics list --resource {ResourceName} --metric Transactions \
--start-time 2017-01-01T00:00:00Z \
--interval PT24H
Répertorier les valeurs de métadonnées d’un compte de stockage sous la dimension de nom d’API de la métrique de transaction depuis 2017
az monitor metrics list --resource {ResourceName} --metric Transactions \
--filter "ApiName eq '*'" \
--start-time 2017-01-01T00:00:00Z
Paramètres obligatoires
Nom ou ID de la ressource cible.
| Propriété | Valeur |
|---|---|
| Groupe de paramètres: | Target Resource Arguments |
Paramètres facultatifs
Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.
Liste des types d’agrégation (séparés par des espaces) à récupérer.
| Propriété | Valeur |
|---|---|
| Valeurs acceptées: | Average, Count, Maximum, Minimum, None, Total |
| Valeur de: | az monitor metrics list-definitions |
La liste des dimensions (séparées par l’espace) dans lequel les métriques sont interrogées.
| Propriété | Valeur |
|---|---|
| Valeur de: | az monitor metrics list-definitions |
Heure de fin de la requête. La valeur par défaut est l’heure actuelle. Format : date (aaaa-mm-dd) heure (hh :mm :ss.xxxxx) fuseau horaire (+/-hh :mm).
| Propriété | Valeur |
|---|---|
| Groupe de paramètres: | Time Arguments |
Chaîne utilisée pour réduire l’ensemble de données de métrique retournées. eg. « BlobType eq '*' ».
Pour obtenir la liste complète des filtres, consultez la référence de chaîne de filtre à https://learn.microsoft.com/rest/api/monitor/metrics/list.
Intervalle sur lequel agréger les métriques, au format ##h##m.
| Propriété | Valeur |
|---|---|
| Groupe de paramètres: | Time Arguments |
| Valeur par défaut: | 1m |
Retourne les valeurs de métadonnées au lieu des données de métrique.
Liste séparée par l’espace des noms de métriques à récupérer.
| Propriété | Valeur |
|---|---|
| Valeur de: | az monitor metrics list-definitions |
Espace de noms pour lequel interroger les définitions de métriques.
| Propriété | Valeur |
|---|---|
| Valeur de: | az monitor metrics list-namespaces |
Décalage horaire de la plage de requêtes, au format ##d##h.
Peut être utilisé avec --start-time ou --end-time. Si elle est utilisée avec --start-time, l’heure de fin est calculée en ajoutant le décalage. Si elle est utilisée avec --end-time (valeur par défaut), l’heure de début est calculée en soustrayant le décalage. Si --start-time et --end-time sont fournis, --offset est ignoré.
| Propriété | Valeur |
|---|---|
| Groupe de paramètres: | Time Arguments |
| Valeur par défaut: | 1h |
Agrégation à utiliser pour trier les résultats et la direction du tri. Une seule commande peut être spécifique. Exemples : sum asc.
Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.
| Propriété | Valeur |
|---|---|
| Groupe de paramètres: | Target Resource Arguments |
Espace de noms du fournisseur de ressources cible.
| Propriété | Valeur |
|---|---|
| Groupe de paramètres: | Target Resource Arguments |
Chemin parent de la ressource cible, le cas échéant.
| Propriété | Valeur |
|---|---|
| Groupe de paramètres: | Target Resource Arguments |
Type de ressource cible. Peut également accepter le format d’espace de noms/type (par exemple , « Microsoft.Compute/virtualMachines »).
| Propriété | Valeur |
|---|---|
| Groupe de paramètres: | Target Resource Arguments |
Heure de début de la requête. Format : date (aaaa-mm-dd) heure (hh :mm :ss.xxxxx) fuseau horaire (+/-hh :mm).
| Propriété | Valeur |
|---|---|
| Groupe de paramètres: | Time Arguments |
Nombre maximal d’enregistrements à récupérer.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | 10 |
Paramètres globaux
Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | False |
Affichez ce message d’aide et quittez.
Afficher uniquement les erreurs, en supprimant les avertissements.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | False |
Format de sortie.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | json |
| Valeurs acceptées: | json, jsonc, none, table, tsv, yaml, yamlc |
Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.
Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | False |
az monitor metrics list-definitions
Répertoriez les définitions de métriques de la ressource.
az monitor metrics list-definitions --resource
[--namespace]
[--resource-group]
[--resource-namespace]
[--resource-parent]
[--resource-type]
Exemples
Répertoriez les définitions de métriques de la ressource. (autogenerated)
az monitor metrics list-definitions --resource /subscriptions/{subscriptionID}/resourceGroups/{resourceGroup}/Microsoft.Network/networkSecurityGroups/{resourceName}
Paramètres obligatoires
Nom ou ID de la ressource cible.
| Propriété | Valeur |
|---|---|
| Groupe de paramètres: | Target Resource Arguments |
Paramètres facultatifs
Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.
Espace de noms pour lequel interroger les définitions de métriques.
| Propriété | Valeur |
|---|---|
| Valeur de: | az monitor metrics list-namespaces |
Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.
| Propriété | Valeur |
|---|---|
| Groupe de paramètres: | Target Resource Arguments |
Espace de noms du fournisseur de ressources cible.
| Propriété | Valeur |
|---|---|
| Groupe de paramètres: | Target Resource Arguments |
Chemin parent de la ressource cible, le cas échéant.
| Propriété | Valeur |
|---|---|
| Groupe de paramètres: | Target Resource Arguments |
Type de ressource cible. Peut également accepter le format d’espace de noms/type (par exemple , « Microsoft.Compute/virtualMachines »).
| Propriété | Valeur |
|---|---|
| Groupe de paramètres: | Target Resource Arguments |
Paramètres globaux
Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | False |
Affichez ce message d’aide et quittez.
Afficher uniquement les erreurs, en supprimant les avertissements.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | False |
Format de sortie.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | json |
| Valeurs acceptées: | json, jsonc, none, table, tsv, yaml, yamlc |
Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.
Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | False |
az monitor metrics list-namespaces
Cette commande est en préversion et en cours de développement. Niveaux de référence et de support : https://aka.ms/CLI_refstatus
Répertoriez les espaces de noms de métriques de la ressource.
az monitor metrics list-namespaces --resource-uri
[--start-time]
Exemples
Répertoriez les espaces de noms de métriques de la ressource.
az monitor metrics list-namespaces --resource /subscriptions/{subscriptionID}/resourceGroups/{resourceGroup}/Microsoft.Network/networkSecurityGroups/{resourceName} --start-time 2021-03-01T00:00:00Z
Paramètres obligatoires
Identificateur de la ressource.
Paramètres facultatifs
Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.
Heure de début de la requête. Format : date (aaaa-mm-dd) heure (hh :mm :ss.xxxxx) fuseau horaire (+/-hh :mm).
| Propriété | Valeur |
|---|---|
| Groupe de paramètres: | Time Arguments |
Paramètres globaux
Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | False |
Affichez ce message d’aide et quittez.
Afficher uniquement les erreurs, en supprimant les avertissements.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | False |
Format de sortie.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | json |
| Valeurs acceptées: | json, jsonc, none, table, tsv, yaml, yamlc |
Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.
Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | False |
az monitor metrics list-sub
Répertorie les données de métrique d’un abonnement. Les paramètres peuvent être spécifiés sur le corps.
az monitor metrics list-sub --region
[--aggregation]
[--auto-adjust-timegrain {0, 1, f, false, n, no, t, true, y, yes}]
[--filter]
[--interval]
[--metricnames]
[--metricnamespace]
[--order-by]
[--result-type {Data, Metadata}]
[--roll-up-by]
[--timespan]
[--top]
[--validate-dimensions {0, 1, f, false, n, no, t, true, y, yes}]
Paramètres obligatoires
Région où résident les métriques souhaitées.
Paramètres facultatifs
Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.
Liste des types d’agrégation (séparés par des virgules) à récupérer.
| Propriété | Valeur |
|---|---|
| Groupe de paramètres: | Body Arguments |
Lorsque la valeur est true, si l’intervalle de temps passé n’est pas pris en charge par cette métrique, l’API retourne le résultat à l’aide de l’intervalle de temps le plus proche pris en charge. Lorsque la valeur est false, une erreur est retournée pour les paramètres d’intervalle de temps non valides. La valeur par défaut est false.
| Propriété | Valeur |
|---|---|
| Groupe de paramètres: | Body Arguments |
| Valeurs acceptées: | 0, 1, f, false, n, no, t, true, y, yes |
La $filter est utilisée pour réduire l’ensemble de données de métrique retournées.
Example:
La métrique contient les métadonnées A, B et C.
- Retourner toutes les séries chronologiques de C où A = a1 et B = b1 ou b2
$filter=A eq 'a1' et B eq 'b1' ou B eq 'b2' et C eq '*'
- Variante non valide :
$filter=A eq 'a1' et B eq 'b1' et C eq '*' ou B = 'b2'
Cela n’est pas valide, car l’opérateur ou logique ne peut pas séparer deux noms de métadonnées différents.
- Retourne toutes les séries chronologiques où A = a1, B = b1 et C = c1 :
$filter=A eq 'a1' et B eq 'b1' et C eq 'c1'
- Retourner toutes les séries chronologiques où A = a1
$filter=A eq 'a1' et B eq '' et C eq ''.
| Propriété | Valeur |
|---|---|
| Groupe de paramètres: | Body Arguments |
Intervalle (c.-à-d. timegrain) de la requête au format de durée ISO 8601. La valeur par défaut est PT1M. Cas spécial pour la valeur « FULL » qui retourne un point de données unique pendant toute la durée demandée. Exemples : PT15M, PT1H, P1D, FULL.
| Propriété | Valeur |
|---|---|
| Groupe de paramètres: | Body Arguments |
Noms des métriques (séparées par des virgules) à récupérer.
| Propriété | Valeur |
|---|---|
| Groupe de paramètres: | Body Arguments |
Espace de noms de métrique où résident les métriques souhaitées.
| Propriété | Valeur |
|---|---|
| Groupe de paramètres: | Body Arguments |
Agrégation à utiliser pour trier les résultats et la direction du tri. Une seule commande peut être spécifiée. Exemples : sum asc.
| Propriété | Valeur |
|---|---|
| Groupe de paramètres: | Body Arguments |
Réduit le jeu de données collectées. La syntaxe autorisée dépend de l’opération. Pour plus d’informations, consultez la description de l’opération.
| Propriété | Valeur |
|---|---|
| Groupe de paramètres: | Body Arguments |
| Valeurs acceptées: | Data, Metadata |
Nom(s) de dimension par utilisant les résultats cumulatifs. Par exemple, si vous souhaitez uniquement voir les valeurs de métrique avec un filtre tel que « City eq Seattle ou City eq Tacoma », mais que vous ne souhaitez pas voir des valeurs distinctes pour chaque ville, vous pouvez spécifier « RollUpBy=City » pour afficher les résultats de Seattle et Tacoma inscrits dans une seule série chronologique.
| Propriété | Valeur |
|---|---|
| Groupe de paramètres: | Body Arguments |
Intervalle de temps de la requête. Il s’agit d’une chaîne au format suivant « startDateTime_ISO/endDateTime_ISO ».
| Propriété | Valeur |
|---|---|
| Groupe de paramètres: | Body Arguments |
Nombre maximal d’enregistrements à récupérer. Valide uniquement si $filter est spécifié. La valeur par défaut est 10.
| Propriété | Valeur |
|---|---|
| Groupe de paramètres: | Body Arguments |
Lorsque la valeur est false, les valeurs de paramètre de filtre non valides sont ignorées. Lorsqu’elle est définie sur true, une erreur est retournée pour les paramètres de filtre non valides. La valeur par défaut est true.
| Propriété | Valeur |
|---|---|
| Groupe de paramètres: | Body Arguments |
| Valeurs acceptées: | 0, 1, f, false, n, no, t, true, y, yes |
Paramètres globaux
Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | False |
Affichez ce message d’aide et quittez.
Afficher uniquement les erreurs, en supprimant les avertissements.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | False |
Format de sortie.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | json |
| Valeurs acceptées: | json, jsonc, none, table, tsv, yaml, yamlc |
Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.
Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | False |
az monitor metrics list-sub-definitions
Répertoriez les définitions de métriques de l’abonnement.
az monitor metrics list-sub-definitions --region
[--metricnamespace]
Paramètres obligatoires
Région où résident les métriques souhaitées.
Paramètres facultatifs
Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.
Espace de noms de métrique où résident les métriques souhaitées.
Paramètres globaux
Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | False |
Affichez ce message d’aide et quittez.
Afficher uniquement les erreurs, en supprimant les avertissements.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | False |
Format de sortie.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | json |
| Valeurs acceptées: | json, jsonc, none, table, tsv, yaml, yamlc |
Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.
Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | False |