Créer une alerte de métrique dans Azure CLI

Article
11/16/2023

Ces exemples créent des analyses d’alerte de métrique dans Azure Monitor avec des commandes Azure CLI. Le premier exemple crée une alerte pour une machine virtuelle. La deuxième commande crée une alerte qui comprend une dimension pour un plan App Service.

Prérequis

Utilisez l’environnement Bash dans Azure Cloud Shell. Pour plus d’informations, consultez Démarrage rapide pour Bash dans Azure Cloud Shell.
Si vous préférez exécuter les commandes de référence de l’interface de ligne de commande localement, installez l’interface Azure CLI. Si vous exécutez sur Windows ou macOS, envisagez d’exécuter Azure CLI dans un conteneur Docker. Pour plus d’informations, consultez Guide pratique pour exécuter Azure CLI dans un conteneur Docker.
- Si vous utilisez une installation locale, connectez-vous à Azure CLI à l’aide de la commande az login. Pour finir le processus d’authentification, suivez les étapes affichées dans votre terminal. Pour connaître les autres options de connexion, consultez Se connecter avec Azure CLI.
- Lorsque vous y êtes invité, installez l’extension Azure CLI lors de la première utilisation. Pour plus d’informations sur les extensions, consultez Utiliser des extensions avec Azure CLI.
- Exécutez az version pour rechercher la version et les bibliothèques dépendantes installées. Pour effectuer une mise à niveau vers la dernière version, exécutez az upgrade.

Créer une alerte

Cette alerte supervise une machine virtuelle existante nommée VM07 dans le groupe de ressources nommé ContosoVMRG.

Vous pouvez créer un groupe de ressources avec la commande az group create. Pour plus d’informations sur la création de machines virtuelles, consultez Créer une machine virtuelle Windows avec Azure CLI, Créer une machine virtuelle Linux avec Azure CLI et la commande az vm create.

# resource group name: ContosoVMRG
# virtual machine name: VM07

# Create scope
scope=$(az vm show --resource-group ContosoVMRG --name VM07 --output tsv --query id)

# Create action
action=$(az monitor action-group create --name ContosoWebhookAction \
  --resource-group ContosoVMRG --output tsv --query id \
  --action webhook https://alerts.contoso.com usecommonalertschema)

# Create condition
condition=$(az monitor metrics alert condition create --aggregation Average \
  --metric "Percentage CPU" --op GreaterThan --type static --threshold 90 --output tsv)

# Create metrics alert
az monitor metrics alert create --name alert-01 --resource-group ContosoVMRG \
  --scopes $scope --action $action --condition $condition --description "Test High CPU"

Cet exemple utilise le type de sortie tsv, qui n’inclut pas de symboles indésirables tels que les guillemets. Pour plus d’informations, consultez Utiliser Azure CLI efficacement.

Créer une alerte avec une dimension

Cet exemple crée un plan App Service, puis crée une alerte de métriques pour celui-ci. L’exemple utilise une dimension pour spécifier que toutes les instances du plan App Service relèvent de cette métrique. L’exemple crée un groupe de ressources et un plan de service d’application.

# Create resource group
az group create --name ContosoRG --location eastus2
 
# Create application service plan
az appservice plan create --resource-group ContosoRG --name ContosoAppServicePlan \
   --is-linux --number-of-workers 4 --sku S1 
 
# Create scope
scope=$(az appservice plan show --resource-group ContosoRG --name ContosoAppServicePlan \
   --output tsv --query id) 
 
# Create dimension
dim01=$(az monitor metrics alert dimension create --name Instance --value * --op Include --output tsv)
 
# Create condition
condition=$(az monitor metrics alert condition create --aggregation Average \
   --metric CpuPercentage --op GreaterThan --type static --threshold 90 \
   --dimension $dim01 --output tsv)

Pour voir la liste des métriques possibles, exécutez la commande az monitor metrics list-definitions. Le paramètre --output affiche les valeurs dans un format lisible.

az monitor metrics list-definitions --resource $scope --output table 
 
# Create metrics alert
az monitor metrics alert create --name alert-02 --resource-group ContosoRG \
   --scopes $scope --condition $condition --description "Service Plan High CPU"

Nettoyer le déploiement

Si vous avez créé des groupes de ressources pour tester ces commandes, vous pouvez supprimer un groupe de ressources et tout son contenu en utilisant la commande az group delete :

az group delete --name ContosoVMRG

az group delete --name ContosoRG

Si vous avez utilisé des ressources existantes que vous souhaitez conserver, utilisez la commande az monitor metrics alert delete pour supprimer vos alertes :

az monitor metrics alert delete --name alert-01

az monitor metrics alert delete --name alert-02

Commandes Azure CLI utilisées dans cet article

Cet article utilise les commandes Azure CLI suivantes :

Partager via