Partager via


az monitor metrics alert

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

Commandes

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

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 --target-resource-region]
                                [--severity]
                                [--tags]
                                [--target-resource-type --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 le mot clé « where » et plusieurs dimensions peuvent être interrogées en les combinant avec le mot clé « and ».

Les valeurs de MÉTRIQUE, DIMENSION et seuil approprié peuvent être obtenues à partir de 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 de plusieurs arguments --condition.

--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 à l’aide de 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

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.

--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 de plusieurs arguments --action.

--auto-mitigate

Résolvez automatiquement l’alerte.

Propriété Valeur
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é.

Propriété Valeur
Valeur par défaut: False
Valeurs acceptées: false, true
--evaluation-frequency

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

Propriété Valeur
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é).

Propriété Valeur
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 ».

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

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

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.

--ids

Un ou plusieurs ID de ressource (délimités par l’espace). 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 ».

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--name -n

Nom de la règle d’alerte.

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--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: Resource Id Arguments
--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.

Propriété Valeur
Groupe de paramètres: Resource Id 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/.

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

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

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.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

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

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

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.

--ids

Un ou plusieurs ID de ressource (délimités par l’espace). 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 ».

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--name -n

Nom de la règle d’alerte.

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--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: Resource Id Arguments
--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.

Propriété Valeur
Groupe de paramètres: Resource Id 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/.

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

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

az monitor metrics alert update [--add]
                                [--add-action --add-actions]
                                [--add-condition --add-conditions]
                                [--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

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.

--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 or JSON string>.

Propriété Valeur
Groupe de paramètres: Generic Update Arguments
--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 de plusieurs arguments --add-action. Prendre en charge la syntaxe abrégée, json-file et yaml-file. Essayez « ?? » pour en montrer plus.

Propriété Valeur
Groupe de paramètres: Action Arguments
--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 le mot clé « where » et plusieurs dimensions peuvent être interrogées en les combinant avec le mot clé « and ».

Les valeurs de MÉTRIQUE, DIMENSION et seuil approprié peuvent être obtenues à partir de 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 de plusieurs arguments --add-condition. Prendre en charge la syntaxe abrégée, json-file et yaml-file. Essayez « ?? » pour en montrer plus.

Propriété Valeur
Groupe de paramètres: Condition Arguments
--auto-mitigate

Résolvez automatiquement l’alerte.

Propriété Valeur
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.

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

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

--force-string

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

Propriété Valeur
Groupe de paramètres: Generic Update Arguments
Valeurs acceptées: 0, 1, f, false, n, no, t, true, y, yes
--ids

Un ou plusieurs ID de ressource (délimités par l’espace). 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 ».

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--name -n

Nom de la règle d’alerte.

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--remove

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

Propriété Valeur
Groupe de paramètres: Generic Update Arguments
--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.

Propriété Valeur
Groupe de paramètres: Action Arguments
--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.

Propriété Valeur
Groupe de paramètres: Condition Arguments
--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: Resource Id Arguments
--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=<value>.

Propriété Valeur
Groupe de paramètres: Generic Update Arguments
--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 à l’aide de az account set -s NAME_OR_ID.

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--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 format ##h##m##s.

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

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