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 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.
Nom de la règle d’alerte.
Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.
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.
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.
Résolvez automatiquement l’alerte.
| Propriété | Valeur |
|---|---|
| Valeurs acceptées: | false, true |
Description de texte libre de la règle.
Créez la règle dans un état désactivé.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | False |
| Valeurs acceptées: | false, true |
Fréquence avec laquelle évaluer la règle au format « ##h##m##s ».
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | 1m |
Région des ressources cibles dans les étendues. Cela doit être fourni lorsque les étendues sont un groupe de ressources ou un abonnement.
Gravité de l’alerte de 0 (critique) à 4 (détaillé).
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | 2 |
Balises séparées par l’espace : key[=value] [key[=value] ...]. Utilisez « » pour effacer les balises existantes.
Type de ressource des ressources cibles dans les étendues. Cela doit être fourni lorsque les étendues sont un groupe de ressources ou un abonnement.
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
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 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.
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 |
Nom de la règle d’alerte.
| Propriété | Valeur |
|---|---|
| Groupe de paramètres: | Resource Id Arguments |
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 |
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
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/.
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.
Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.
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 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.
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 |
Nom de la règle d’alerte.
| Propriété | Valeur |
|---|---|
| Groupe de paramètres: | Resource Id Arguments |
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 |
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
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/.
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.
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 |
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 |
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 |
Résolvez automatiquement l’alerte.
| Propriété | Valeur |
|---|---|
| Valeurs acceptées: | 0, 1, f, false, n, no, t, true, y, yes |
Description de texte libre de la règle.
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 |
Fréquence avec laquelle évaluer la règle au format ##h##m##s.
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 |
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 |
Nom de la règle d’alerte.
| Propriété | Valeur |
|---|---|
| Groupe de paramètres: | Resource Id Arguments |
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 |
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 |
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 |
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 |
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.
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 |
Gravité de l’alerte de 0 (critique) à 4 (détaillé).
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 |
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.
Durée pendant laquelle agréger les métriques au format ##h##m##s.
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/.
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 |