Créer une règle d’alerte à l’aide de l’interface CLI, de PowerShell ou d’un modèle ARM

  • Article

Vous pouvez créer une règle d’alerte à l’aide de CLI, PowerShellou d’un modèle Azure Resource Manager.

Prérequis

Pour créer ou modifier une règle d’alerte de métrique, vous devez disposer des autorisations suivantes :

  • Autorisation de lecture sur la ressource cible de la règle d'alerte.
  • Autorisation d’écriture sur le groupe de ressources dans lequel la règle d’alerte est créée. Si vous créez la règle d’alerte à partir du portail Azure, elle est créée par défaut dans le groupe de ressources dans lequel réside la ressource cible.
  • Autorisation de lecture sur tout groupe d'actions associé à la règle d'alerte, le cas échéant).

Créer une règle d’alerte en utilisant l’interface CLI

Vous pouvez créer une règle d’alerte à l’aide d’Azure CLI. Les exemples de code suivants utilisent Azure Cloud Shell. Vous pouvez voir la liste complète des Commandes Azure CLI pour Azure Monitor.

  1. Dans le portail Azure, sélectionnez Cloud Shell. Quand vous y êtes invité, utilisez ces options.

    Par exemple, pour créer une règle d'alerte de métrique qui surveille si le pourcentage d'UC moyen sur une machine virtuelle est supérieur à 90 dans les cas suivants :

     az monitor metrics alert create -n {nameofthealert} -g {ResourceGroup} --scopes {VirtualMachineResourceID} --condition "avg Percentage CPU > 90" --description {descriptionofthealert}

Créer une règle d’alerte à l’aide de PowerShell

  • Pour créer une règle d’alerte de métrique en utilisant PowerShell, utilisez l’applet de commande Add-AzMetricAlertRuleV2.

    Remarque

    Lorsque vous créez une alerte de métrique sur une seule ressource, la syntaxe utilise la commande TargetResourceId. Lorsque vous créez une alerte de métrique sur plusieurs ressources, la syntaxe contient les TargetResourceScope, TargetResourceType et TargetResourceRegion.

  • Pour créer une règle d’alerte relative à la recherche dans les journaux à l’aide de PowerShell, utilisez la cmdlet New-AzScheduledQueryRule.
  • Pour créer une règle d’alerte de journal d’activité en utilisant PowerShell, utilisez l’applet de commande New-AzActivityLogAlert.

Créer une règle d’alerte en utilisant un modèle ARM

Vous pouvez utiliser un modèle Azure Resource Manager (modèle ARM) pour configurer des règles d’alerte de manière cohérente dans tous vos environnements.

  1. Créez une ressource avec les types de ressource suivants :

    • Pour les alertes de métrique : Microsoft.Insights/metricAlerts

      Remarque

      • Nous vous recommandons de créer l’alerte de métrique avec le même groupe de ressources que votre ressource cible.
      • Les alertes de métrique pour un type de ressource d’espace de travail Azure Log Analytics (Microsoft.OperationalInsights/workspaces) sont configurées différemment des autres alertes de métrique. Pour plus d’informations, consultez Modèle de ressource pour les alertes de métrique des journaux.
      • Si vous créez une alerte de métrique pour une seule ressource, le modèle utilise le ResourceId de la ressource cible. Si vous créez une alerte de métrique pour plusieurs ressources, le modèle utilise les scope, TargetResourceType et TargetResourceRegion des ressources cibles.
    • Pour les alertes relatives à la recherche dans les journaux : Microsoft.Insights/scheduledQueryRules
    • Pour les alertes de journal d’activité, d’intégrité de service et d’intégrité de ressource : microsoft.Insights/activityLogAlerts

  2. Copiez un des modèles ARM de ces exemples.

  3. Modifiez le fichier de modèle pour qu’il contienne les informations appropriées de votre alerte, puis enregistrez-le sous <your-alert-template-file>.json.

  4. Modifiez le fichier de paramètres correspondant pour personnaliser l’alerte et enregistrez-le sous <your-alert-template-file>.parameters.json.

  5. Définissez le paramètre metricName en utilisant une des valeurs des métriques prises en charge par Azure Monitor.

  6. Déployez le modèle avec PowerShell ou l’interface CLI.

Étapes suivantes