Partager via

Démarrage rapide : créer des alertes Service Health sur les notifications de service en utilisant un modèle ARM

Ce guide vous guide tout au long de la configuration des alertes d’intégrité de service pour les notifications d’intégrité de service à l’aide d’un modèle Azure Resource Manager (ARM).

Un modèle Azure Resource Manager est un fichier JSON (JavaScript Object Notation) qui définit l’infrastructure et la configuration de votre projet. Le modèle utilise la syntaxe déclarative. Vous décrivez le déploiement que vous avez prévu sans écrire la séquence de commandes de programmation pour créer le déploiement.

Aperçu

Les notifications sur l’intégrité du service sont stockées dans le journal d’activité Azure. Étant donné le volume d’informations potentiellement important stockées dans le journal d’activité, il existe une interface utilisateur distincte pour faciliter l’affichage et la configuration des alertes sur les notifications sur l'état de santé du service.

Vous pouvez recevoir une alerte lorsqu’Azure envoie des notifications sur l’état du service sur votre abonnement Azure. Vous pouvez configurer l’alerte en fonction des éléments suivants :

  • la classe de la notification sur l’intégrité du service (problèmes de service, maintenance planifiée, avis d’intégrité) ;
  • l’abonnement affecté ;
  • Les services concernés.
  • Régions affectées.

Notes

Les notifications d’intégrité du service n’envoient pas d’alertes concernant les événements d’intégrité des ressources.

Vous pouvez également configurer à qui l’alerte doit être envoyée :

  • sélectionner un groupe d’actions existant ;
  • Créez un groupe d’actions qui peut être utilisé pour les alertes futures.

Pour en savoir plus sur les groupes d’actions, consultez Créer et gérer des groupes d’actions.

Prérequis

1. Passez en revue le modèle

Le modèle suivant crée un groupe d’actions avec une cible de messagerie et active toutes les notifications d’intégrité de service pour l’abonnement cible.
Enregistrez ce modèle sous le nom CreateServiceHealthAlert.json.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "actionGroups_name": {
      "type": "string",
      "defaultValue": "SubHealth"
    },
    "activityLogAlerts_name": {
      "type": "string",
      "defaultValue": "ServiceHealthActivityLogAlert"
    },
    "emailAddress": {
      "type": "string"
    }
  },
  "variables": {
    "alertScope": "[format('/subscriptions/{0}', subscription().subscriptionId)]"
  },
  "resources": [
    {
      "type": "microsoft.insights/actionGroups",
      "apiVersion": "2019-06-01",
      "name": "[parameters('actionGroups_name')]",
      "location": "Global",
      "properties": {
        "groupShortName": "[parameters('actionGroups_name')]",
        "enabled": true,
        "emailReceivers": [
          {
            "name": "[parameters('actionGroups_name')]",
            "emailAddress": "[parameters('emailAddress')]"
          }
        ],
        "smsReceivers": [],
        "webhookReceivers": []
      }
    },
    {
      "type": "microsoft.insights/activityLogAlerts",
      "apiVersion": "2017-04-01",
      "name": "[parameters('activityLogAlerts_name')]",
      "location": "Global",
      "properties": {
        "scopes": [
          "[variables('alertScope')]"
        ],
        "condition": {
          "allOf": [
            {
              "field": "category",
              "equals": "ServiceHealth"
            },
            {
              "field": "properties.incidentType",
              "equals": "Incident"
            }
          ]
        },
        "actions": {
          "actionGroups": [
            {
              "actionGroupId": "[resourceId('microsoft.insights/actionGroups', parameters('actionGroups_name'))]",
              "webhookProperties": {}
            }
          ]
        },
        "enabled": true
      },
      "dependsOn": [
        "[resourceId('microsoft.insights/actionGroups', parameters('actionGroups_name'))]"
      ]
    }
  ]
}

Le modèle définit deux ressources :

2. Déployer le modèle

Déployez le modèle à l’aide de n’importe quelle méthode standard pour déployer un modèle ARM. Vous pouvez utiliser les exemples suivants pour utiliser l’interface CLI et PowerShell.

Remplacez les exemples de valeurs pour resource Group et emailAddress par les valeurs appropriées pour votre environnement.

az login
az deployment group create --name CreateServiceHealthAlert --resource-group my-resource-group --template-file CreateServiceHealthAlert.json --parameters emailAddress='user@contoso.com'

3. Valider le déploiement

Vérifiez que l’espace de travail est créé à l’aide de l’une des commandes suivantes. Remplacez les exemples de valeurs du groupe de ressources par les valeurs que vous avez utilisées.

az monitor activity-log alert show --resource-group my-resource-group --name ServiceHealthActivityLogAlert

4. Nettoyer les ressources

Si vous prévoyez d’utiliser d’autres guides de démarrage rapide et tutoriels, vous pouvez conserver ces ressources.

Vous pouvez supprimer le groupe de ressources lorsqu’il n’est plus nécessaire, ce qui supprime la règle d’alerte et les ressources associées. Pour supprimer le groupe de ressources à l’aide d’Azure CLI ou de commandes Azure PowerShell indiquées ici.

az group delete --name my-resource-group

Étapes suivantes