Exemples d’interface CLI Azure Monitor

Cet article vous montre des exemples de commandes d’interface de ligne de commande (CLI) qui vous permettent d’accéder aux fonctionnalités de surveillance d’Azure Monitor. Azure Monitor permet une mise à l'échelle automatique des services cloud, des machines virtuelles et des applications web, et d’envoyer des notifications d'alerte ou d’appeler des URL web basées sur des valeurs de données de télémétrie configurées.

Prérequis

Si vous n’avez pas déjà installé Azure CLI, suivez les instructions d’installation d’Azure CLI. Vous pouvez également utiliser Azure Cloud Shell pour exécuter l’interface CLI en tant qu’expérience interactive dans votre navigateur. Pour obtenir la documentation de référence complète sur l’ensemble des commandes disponibles, consultez la documentation de référence sur l’interface de ligne de commande Azure Monitor.

Connexion à Azure

La première étape consiste à vous connecter à votre compte Azure.

az login

Après avoir exécuté cette commande, vous devez vous connecter via les instructions à l’écran. Toutes les commandes fonctionnent dans le cadre de votre abonnement par défaut.

Listez les détails de votre abonnement actuel.

az account show

Basculez le contexte de travail vers un autre abonnement.

az account set -s <Subscription ID or name>

Affichez la liste de toutes les commandes Azure Monitor prises en charge.

az monitor -h

Afficher le journal d’activité

Affichez la liste des événements du journal d’activité.

az monitor activity-log list

Affichez toutes les options disponibles.

az monitor activity-log list -h

Listez les journaux d’un groupe de ressources.

az monitor activity-log list --resource-group <group name>

Listez les journaux par appelant.

az monitor activity-log list --caller myname@company.com

Listez les journaux par appelant, sur un type de ressource, dans une plage de dates.

az monitor activity-log list --resource-provider Microsoft.Web \
    --caller myname@company.com \
    --start-time 2016-03-08T00:00:00Z \
    --end-time 2016-03-16T00:00:00Z

Utilisation des alertes

Notes

Seules les alertes (classiques) sont prises en charge dans l’interface de ligne de commande pour le moment.

Obtenir des règles d’alerte (classique) dans un groupe de ressources

az monitor activity-log alert list --resource-group <group name>
az monitor activity-log alert show --resource-group <group name> --name <alert name>

Créer une règle d’alerte de métrique (classique)

az monitor alert create --name <alert name> --resource-group <group name> \
    --action email <email1 email2 ...> \
    --action webhook <URI> \
    --target <target object ID> \
    --condition "<METRIC> {>,>=,<,<=} <THRESHOLD> {avg,min,max,total,last} ##h##m##s"

Supprimer une règle d’alerte (classique)

az monitor alert delete --name <alert name> --resource-group <group name>

Profils de journal

Utilisez les informations figurant dans cette section pour utiliser les profils de journal.

Obtenir un profil de journal

az monitor log-profiles list
az monitor log-profiles show --name <profile name>

Ajouter un profil de journal avec rétention

az monitor log-profiles create --name <profile name> --location <location of profile> \
    --locations <locations to monitor activity in: location1 location2 ...> \
    --categories <categoryName1 categoryName2 ...> \
    --days <# days to retain> \
    --enabled true \
    --storage-account-id <storage account ID to store the logs in>

Ajouter un profil de journal avec rétention et EventHub

az monitor log-profiles create --name <profile name> --location <location of profile> \
    --locations <locations to monitor activity in: location1 location2 ...> \
    --categories <categoryName1 categoryName2 ...> \
    --days <# days to retain> \
    --enabled true
    --storage-account-id <storage account ID to store the logs in>
    --service-bus-rule-id <service bus rule ID to stream to>

Supprimer un profil de journal

az monitor log-profiles delete --name <profile name>

Diagnostics

Utilisez les informations figurant dans cette section pour utiliser les paramètres de diagnostic.

Obtenir un paramètre de diagnostic

az monitor diagnostic-settings list --resource <target resource ID>

Créer un paramètre de diagnostic

az monitor diagnostic-settings create --name <diagnostic name> \
    --storage-account <storage account ID> \
    --resource <target resource object ID> \
    --logs '[
    {
        "category": <category name>,
        "enabled": true,
        "retentionPolicy": {
            "days": <# days to retain>,
            "enabled": true
        }
    }]'

Supprimer un paramètre de diagnostic

az monitor diagnostic-settings delete --name <diagnostic name> \
    --resource <target resource ID>

Mise à l’échelle automatique

Utilisez les informations figurant dans cette section pour utiliser les paramètres de mise à l’échelle automatique. Vous devez modifier ces exemples.

Obtenir les paramètres de mise à l’échelle automatique pour un groupe de ressources

az monitor autoscale list --resource-group <group name>

Obtenir les paramètres de mise à l’échelle automatique par nom dans un groupe de ressources

az monitor autoscale show --name <settings name> --resource-group <group name>

Régler les paramètres de mise à l'échelle automatique

az monitor autoscale create --name <settings name> --resource-group <group name> \
    --count <# instances> \
    --resource <target resource ID>