Partager via

az monitor metrics alert

  • Référence

Gérez les règles d’alerte de métrique en temps quasi réel.

Commandes

Nom Description Type Statut
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 alert create

Modifier

Créez une règle d’alerte basée sur des métriques.

az monitor metrics alert create --condition
                                --name
                                --resource-group
                                --scopes
                                [--action]
                                [--auto-mitigate {false, true}]
                                [--description]
                                [--disabled {false, true}]
                                [--evaluation-frequency]
                                [--region]
                                [--severity]
                                [--tags]
                                [--target-resource-type]
                                [--window-size]

Exemples

Créez une alerte d’utilisation élevée du processeur sur une machine virtuelle sans action.

az monitor metrics alert create -n alert1 -g {ResourceGroup} --scopes {VirtualMachineID} --condition "avg Percentage CPU > 90" --description "High CPU"

Créez une alerte d’utilisation élevée du processeur sur une machine virtuelle avec des actions de messagerie et de webhook.

az monitor metrics alert create -n alert1 -g {ResourceGroup} --scopes {VirtualMachineID} \
    --condition "avg Percentage CPU > 90" --window-size 5m --evaluation-frequency 1m \
    --action "/subscriptions/<subscriptionId>/resourceGroups/<resourceGroupName>/providers/Microsoft.Insights/actionGroups/<actionGroupName>" apiKey={APIKey} type=HighCPU \
    --description "High CPU"

Créez une alerte lorsqu’un compte de stockage affiche un nombre élevé de transactions lentes, à l’aide de filtres multidimensionnels.

az monitor metrics alert create -g {ResourceGroup} -n alert1 --scopes {StorageAccountId} \
    --description "Storage Slow Transactions" \
    --condition "total transactions > 5 where ResponseType includes Success" \
    --condition "avg SuccessE2ELatency > 250 where ApiName includes GetBlob"

Créez une règle d’alerte basée sur des métriques qui surveille une métrique personnalisée.

az monitor metrics alert create -n "metric alert rule on a custom metric" -g "Demos" --scopes {VirtualMachineID} \
    --condition "max Azure.VM.Windows.GuestMetrics.Memory\Available Bytes > 90" \
    --window-size 5m --evaluation-frequency 1m

Créez une alerte d’utilisation élevée du processeur sur plusieurs machines virtuelles sans aucune action.

az monitor metrics alert create -n alert1 -g {ResourceGroup} --scopes {VirtualMachineID1} {VirtualMachineID2} {VirtualMachineID3} \
    --condition "avg Percentage CPU > 90" --description "High CPU" --region westus

Créez une alerte d’utilisation du processeur dynamique sur plusieurs machines virtuelles sans aucune action.

az monitor metrics alert create -n alert1 -g {ResourceGroup} --scopes {VirtualMachineID1} {VirtualMachineID2} {VirtualMachineID3} \
    --condition "avg Percentage CPU > dynamic medium 2 of 4 since 2020-10-01T10:23:00.000Z"
    --description "Dynamic CPU"
    --window-size 5m
    --region westus

Paramètres obligatoires

--condition

Condition qui déclenche la règle. Il peut être créé par la commande « az monitor metrics alert condition create ».

Utilisation : --condition {avg,min,max,total,count} [NAMESPACE.] METRIC [{=, !=,,=,>>,<,<=} THRESHOLD] [{<,>,><} violations dynamiques de SENSIBILITÉ des ÉVALUATIONS [depuis DATETIME]] [où DIMENSION {includes,excludes} VALUE [ou VALUE ...] [et DIMENSION {includes,excludes} VALUE [ou VALUE ...] ...]] [avec skipmetricvalidation]

La sensibilité peut être « faible », « moyenne », « élevée ».

Les violations peuvent être le nombre de violations à déclencher une alerte. Il doit être plus petit ou égal à l’évaluation.

Les évaluations peuvent être le nombre de périodes d’évaluation pour le seuil dynamique.

Datetime peut être la date à partir de laquelle commencer à apprendre les données historiques des métriques et calculer les seuils dynamiques (au format ISO8601).

Les dimensions peuvent être interrogées en ajoutant la mot clé « où » et plusieurs dimensions peuvent être interrogées en les combinant avec les mot clé « et ».

Les valeurs MÉTRIQUE, DIMENSION et seuil approprié peuvent être obtenues à partir de la az monitor metrics list-definitions commande.

En raison de la limitation du serveur, lorsqu’une règle d’alerte contient plusieurs critères, l’utilisation de dimensions est limitée à une valeur par dimension dans chaque critère.

Plusieurs conditions peuvent être spécifiées à l’aide --condition de plusieurs arguments.

--name -n

Nom de la règle d’alerte.

--resource-group -g

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

--scopes

Liste séparée par l’espace des étendues à l’application de la règle. Les ressources spécifiées dans ce paramètre doivent être du même type et exister dans le même emplacement.

Paramètres facultatifs

--action -a

Ajoutez un groupe d’actions et des propriétés de webhook facultatives à déclencher lorsque l’alerte est déclenchée.

Utilisation : --action ACTION_GROUP_NAME_OR_ID [KEY=VAL [KEY=VAL ...]]

Plusieurs groupes d’actions peuvent être spécifiés à l’aide --action de plusieurs arguments.

--auto-mitigate

Résolvez automatiquement l’alerte.

valeurs acceptées: false, true
--description

Description de texte libre de la règle.

--disabled

Créez la règle dans un état désactivé.

valeurs acceptées: false, true
valeur par défaut: False
--evaluation-frequency

Fréquence avec laquelle évaluer la règle au format « ##h##m##s ».

valeur par défaut: 1m
--region --target-resource-region

Région des ressources cibles dans les étendues. Cela doit être fourni lorsque les étendues sont un groupe de ressources ou un abonnement.

--severity

Gravité de l’alerte de 0 (critique) à 4 (détaillé).

valeur par défaut: 2
--tags

Balises séparées par l’espace : key[=value] [key[=value] ...]. Utilisez « » pour effacer les balises existantes.

--target-resource-type --type

Type de ressource des ressources cibles dans les étendues. Cela doit être fourni lorsque les étendues sont un groupe de ressources ou un abonnement.

--window-size

Durée pendant laquelle agréger les métriques au format « ##h##m##s ».

valeur par défaut: 5m
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 alert delete

Modifier

Supprimez une règle d’alerte basée sur des métriques.

az monitor metrics alert delete [--ids]
                                [--name]
                                [--resource-group]
                                [--subscription]

Exemples

Supprimez une règle d’alerte basée sur des métriques.

az monitor metrics alert delete --name MyAlertRule --resource-group MyResourceGroup

Paramètres facultatifs

--ids

Un ou plusieurs ID de ressource (délimités par des espaces). Il doit s’agir d’un ID de ressource complet contenant toutes les informations des arguments « ID de ressource ». Vous devez fournir des arguments --id ou d’autres arguments « ID de ressource ».

--name -n

Nom de la règle d’alerte.

--resource-group -g

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

--subscription

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

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 alert list

Modifier

Répertoriez les règles d’alerte basées sur les métriques.

az monitor metrics alert list [--resource-group]

Exemples

Répertoriez les règles d’alerte basées sur les métriques.

az monitor metrics alert list --resource-group MyResourceGroup

Paramètres facultatifs

--resource-group -g

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

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 alert show

Modifier

Afficher une règle d’alerte basée sur des métriques.

az monitor metrics alert show [--ids]
                              [--name]
                              [--resource-group]
                              [--subscription]

Exemples

Afficher une règle d’alerte basée sur des métriques.

az --name MyAlertRule --resource-group MyResourceGroup

Paramètres facultatifs

--ids

Un ou plusieurs ID de ressource (délimités par des espaces). Il doit s’agir d’un ID de ressource complet contenant toutes les informations des arguments « ID de ressource ». Vous devez fournir des arguments --id ou d’autres arguments « ID de ressource ».

--name -n

Nom de la règle d’alerte.

--resource-group -g

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

--subscription

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

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 alert update

Modifier

Mettez à jour une règle d’alerte basée sur des métriques.

az monitor metrics alert update [--add]
                                [--add-action]
                                [--add-condition]
                                [--auto-mitigate {0, 1, f, false, n, no, t, true, y, yes}]
                                [--description]
                                [--enabled {0, 1, f, false, n, no, t, true, y, yes}]
                                [--evaluation-frequency]
                                [--force-string {0, 1, f, false, n, no, t, true, y, yes}]
                                [--ids]
                                [--name]
                                [--remove]
                                [--remove-actions]
                                [--remove-conditions]
                                [--resource-group]
                                [--scopes]
                                [--set]
                                [--severity]
                                [--subscription]
                                [--tags]
                                [--window-size]

Exemples

Désactiver/activer une règle d’alerte basée sur les métriques.

az monitor metrics alert update --enabled false --name MyAlertRule --resource-group MyResourceGroup

Paramètres facultatifs

--add

Ajoutez un objet à une liste d’objets en spécifiant un chemin d’accès et des paires clé-valeur. Exemple : --add property.listProperty <key=value, string ou JSON string>.

--add-action --add-actions

Ajoutez un groupe d’actions et des propriétés de webhook facultatives à déclencher lorsque l’alerte est déclenchée.

Utilisation : --add-action ACTION_GROUP_NAME_OR_ID [KEY=VAL [KEY=VAL ...]]

Plusieurs groupes d’actions peuvent être spécifiés à l’aide --add-action de plusieurs arguments. Prendre en charge la syntaxe abrégée, json-file et yaml-file. Essayez « ?? » pour en montrer plus.

--add-condition --add-conditions

Ajoutez une condition qui déclenche la règle.

Utilisation : --add-condition {avg,min,max,total,count} [NAMESPACE.] METRIC [{=, !=,,=,>>,<,<=} THRESHOLD] [{<,>,><} violations dynamiques de SENSIBILITÉ des ÉVALUATIONS [depuis DATETIME]] [où DIMENSION {includes,excludes} VALUE [ou VALUE ...] [et DIMENSION {includes,excludes} VALUE [ou VALUE ...] ...]]

La sensibilité peut être « faible », « moyenne », « élevée ».

Les violations peuvent être le nombre de violations à déclencher une alerte. Il doit être plus petit ou égal à l’évaluation.

Les évaluations peuvent être le nombre de périodes d’évaluation pour le seuil dynamique.

Datetime peut être la date à partir de laquelle commencer à apprendre les données historiques des métriques et calculer les seuils dynamiques (au format ISO8601).

Les dimensions peuvent être interrogées en ajoutant la mot clé « où » et plusieurs dimensions peuvent être interrogées en les combinant avec les mot clé « et ».

Les valeurs MÉTRIQUE, DIMENSION et seuil approprié peuvent être obtenues à partir de la az monitor metrics list-definitions commande.

En raison de la limitation du serveur, lorsqu’une règle d’alerte contient plusieurs critères, l’utilisation de dimensions est limitée à une valeur par dimension dans chaque critère.

Plusieurs conditions peuvent être spécifiées à l’aide --add-condition de plusieurs arguments. Prendre en charge la syntaxe abrégée, json-file et yaml-file. Essayez « ?? » pour en montrer plus.

--auto-mitigate

Résolvez automatiquement l’alerte.

valeurs acceptées: 0, 1, f, false, n, no, t, true, y, yes
--description

Description de texte libre de la règle.

--enabled

Indique si la règle d’alerte de métrique est activée.

valeurs acceptées: 0, 1, f, false, n, no, t, true, y, yes
--evaluation-frequency

Fréquence avec laquelle évaluer la règle au ##h##m##s format.

--force-string

Lorsque vous utilisez « set » ou « add », conservez les littéraux de chaîne au lieu de tenter de convertir en JSON.

valeurs acceptées: 0, 1, f, false, n, no, t, true, y, yes
--ids

Un ou plusieurs ID de ressource (délimités par des espaces). Il doit s’agir d’un ID de ressource complet contenant toutes les informations des arguments « ID de ressource ». Vous devez fournir des arguments --id ou d’autres arguments « ID de ressource ».

--name -n

Nom de la règle d’alerte.

--remove

Supprimez une propriété ou un élément d’une liste. Exemple : --remove property.list OR --remove propertyToRemove.

--remove-actions

Liste séparée par l’espace des noms de groupes d’actions à supprimer. Prendre en charge la syntaxe abrégée, json-file et yaml-file. Essayez « ?? » pour en montrer plus.

--remove-conditions

Liste séparée par l’espace des noms de conditions à supprimer. Prendre en charge la syntaxe abrégée, json-file et yaml-file. Essayez « ?? » pour en montrer plus.

--resource-group -g

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

--scopes

Liste séparée par l’espace des étendues à l’application de la règle. Les ressources spécifiées dans ce paramètre doivent être du même type et exister dans le même emplacement. Prendre en charge la syntaxe abrégée, json-file et yaml-file. Essayez « ?? » pour en montrer plus.

--set

Mettez à jour un objet en spécifiant un chemin d’accès et une valeur de propriété à définir. Exemple : --set property1.property2=.

--severity

Gravité de l’alerte de 0 (critique) à 4 (détaillé).

--subscription

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

--tags

Balises séparées par l’espace : key[=value] [key[=value] ...]. Prendre en charge la syntaxe abrégée, json-file et yaml-file. Essayez « ?? » pour en montrer plus.

--window-size

Durée pendant laquelle agréger les métriques au ##h##m##s format.

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.