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 État
az monitor metrics alert condition

Gérer les conditions de règle d’alerte de métrique en temps quasi réel.

 Noyau GA
az monitor metrics alert condition create

Générez une condition de règle d’alerte de métrique.

 Noyau Aperçu
az monitor metrics alert create

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

 Noyau GA
az monitor metrics alert delete

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

 Noyau GA
az monitor metrics alert dimension

Gérer les dimensions de règle d’alerte de métrique en quasi-temps réel.

 Noyau GA
az monitor metrics alert dimension create

Générez une dimension de règle d’alerte de métrique.

 Noyau Aperçu
az monitor metrics alert list

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

 Noyau GA
az monitor metrics alert show

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

 Noyau GA
az monitor metrics alert update

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

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

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

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 la détail de journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez-le.

--only-show-errors

Affiche 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ê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 la détail de journalisation. Utilisez --debug pour les 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 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 ».

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

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

Paramètres globaux
--debug

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

--help -h

Affichez ce message d’aide et quittez-le.

--only-show-errors

Affiche 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ê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 la détail de journalisation. Utilisez --debug pour les 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 à l’aide de az configure --defaults group=<name>.

Paramètres globaux
--debug

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

--help -h

Affichez ce message d’aide et quittez-le.

--only-show-errors

Affiche 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ê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 la détail de journalisation. Utilisez --debug pour les 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 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 ».

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

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

Paramètres globaux
--debug

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

--help -h

Affichez ce message d’aide et quittez-le.

--only-show-errors

Affiche 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ê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 la détail de journalisation. Utilisez --debug pour les 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 or 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 de plusieurs arguments --add-action. 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 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.

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

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

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

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

--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 détail de journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez-le.

--only-show-errors

Affiche 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ê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 la détail de journalisation. Utilisez --debug pour les journaux de débogage complets.