Partager via


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

--resource

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.

--aggregation

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
--dimension

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
--end-time

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
--filter

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.

--interval

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
--metadata

Retourne les valeurs de métadonnées au lieu des données de métrique.

--metrics

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
--namespace

Espace de noms pour lequel interroger les définitions de métriques.

Propriété Valeur
Valeur de: az monitor metrics list-namespaces
--offset

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
--orderby

Agrégation à utiliser pour trier les résultats et la direction du tri. Une seule commande peut être spécifique. Exemples : sum asc.

--resource-group -g

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
--resource-namespace

Espace de noms du fournisseur de ressources cible.

Propriété Valeur
Groupe de paramètres: Target Resource Arguments
--resource-parent

Chemin parent de la ressource cible, le cas échéant.

Propriété Valeur
Groupe de paramètres: Target Resource Arguments
--resource-type

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
--start-time

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
--top

Nombre maximal d’enregistrements à récupérer.

Propriété Valeur
Valeur par défaut: 10
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

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

--resource

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.

--namespace

Espace de noms pour lequel interroger les définitions de métriques.

Propriété Valeur
Valeur de: az monitor metrics list-namespaces
--resource-group -g

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
--resource-namespace

Espace de noms du fournisseur de ressources cible.

Propriété Valeur
Groupe de paramètres: Target Resource Arguments
--resource-parent

Chemin parent de la ressource cible, le cas échéant.

Propriété Valeur
Groupe de paramètres: Target Resource Arguments
--resource-type

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
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

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

Préversion

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

--resource-uri

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.

--start-time

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
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

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

--region

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.

--aggregation

Liste des types d’agrégation (séparés par des virgules) à récupérer.

Propriété Valeur
Groupe de paramètres: Body Arguments
--auto-adjust-timegrain

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
--filter

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
--interval

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
--metricnames

Noms des métriques (séparées par des virgules) à récupérer.

Propriété Valeur
Groupe de paramètres: Body Arguments
--metricnamespace

Espace de noms de métrique où résident les métriques souhaitées.

Propriété Valeur
Groupe de paramètres: Body Arguments
--order-by

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
--result-type

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
--roll-up-by

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
--timespan

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
--top

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
--validate-dimensions

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
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

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

--region

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.

--metricnamespace

Espace de noms de métrique où résident les métriques souhaitées.

Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

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