Partager via

az monitor metrics

  • Référence

Affichez les métriques de ressources Azure.

Commandes

Nom Description Type Statut
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 Aperçu
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 Aperçu
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 Aperçu
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

Modifier

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.

Paramètres facultatifs

--aggregation

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

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.

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).

--filter

Chaîne utilisée pour réduire l’ensemble de données de métrique retournées. par exemple « BlobType eq '*' ».

Pour obtenir la liste complète des filtres, consultez la référence de chaîne de filtre à l’adresse https://docs.microsoft.com/rest/api/monitor/metrics/list.

--interval

Intervalle sur lequel agréger les métriques, au format ##h##m.

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.

valeur de: az monitor metrics list-definitions
--namespace

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

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é.

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 en utilisant az configure --defaults group=<name>.

--resource-namespace

Espace de noms du fournisseur de ressources cible.

--resource-parent

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

--resource-type

Type de ressource cible. Peut également accepter le format d’espace de noms/type (par exemple , « Microsoft.Compute/virtualMachines »).

--start-time

Heure de début de la requête. Format : date (aaaa-mm-dd) heure (hh :mm :ss.xxxxx) fuseau horaire (+/-hh :mm).

--top

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

valeur par défaut: 10
Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az monitor metrics list-definitions

Modifier

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. (généré automatiquement)

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.

Paramètres facultatifs

--namespace

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

valeur de: az monitor metrics list-namespaces
--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

--resource-namespace

Espace de noms du fournisseur de ressources cible.

--resource-parent

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

--resource-type

Type de ressource cible. Peut également accepter le format d’espace de noms/type (par exemple , « Microsoft.Compute/virtualMachines »).

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az monitor metrics list-namespaces

Modifier
Préversion

Cette commande est en préversion et en cours de développement. Référence et niveaux 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

--start-time

Heure de début de la requête. Format : date (aaaa-mm-dd) heure (hh :mm :ss.xxxxx) fuseau horaire (+/-hh :mm).

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az monitor metrics list-sub

Modifier

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

--aggregation

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

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

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.
Exemple :
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 ''.

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

--metricnames

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

--metricnamespace

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

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

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

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.

--timespan

Intervalle de temps de la requête. Il s’agit d’une chaîne au format suivant « startDateTime_ISO/endDateTime_ISO ».

--top

Nombre maximal d’enregistrements à récupérer. Valide uniquement si $filter est spécifié. La valeur par défaut est 10.

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

valeurs acceptées: 0, 1, f, false, n, no, t, true, y, yes
Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az monitor metrics list-sub-definitions

Modifier

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

--metricnamespace

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

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.