Utiliser un webhook afin de configurer les notifications d’intégrité pour les systèmes de gestion des problèmes

Article
10/24/2024

Cet article vous montre comment configurer les alertes Azure Service Health pour envoyer des données via des webhooks à votre système de notification existant.

Vous pouvez configurer des alertes Service Health pour recevoir une notification par SMS ou par e-mail quand un incident lié à un service Azure vous concerne.

Toutefois, vous avez peut-être déjà en place un système de notification externe que vous préférez utiliser. Cet article identifie les parties les plus importantes de la charge utile du webhook. Il explique également comment créer des alertes personnalisées pour recevoir une notification en cas de problèmes liés à des services qui vous concernent.

Si vous souhaitez utiliser une intégration préconfigurée, consultez :

Regarder une vidéo d’introduction :

Configurer une notification personnalisée à l’aide de la charge utile du webhook Service Health

Pour configurer l’intégration de votre propre webhook personnalisé, vous devez analyser la charge utile JSON envoyée via la notification Service Health.

Consultez un exemple de charge utile de webhook ServiceHealth.

Vous pouvez vérifier qu’il s’agit d’une alerte Service Health en examinant context.eventSource == "ServiceHealth". Les propriétés suivantes sont les plus pertinentes :

data.context.activityLog.status
data.context.activityLog.level
data.context.activityLog.subscriptionId
data.context.activityLog.properties.title
data.context.activityLog.properties.impactStartTime
data.context.activityLog.properties.communication
data.context.activityLog.properties.impactedServices
data.context.activityLog.properties.trackingId

Créer un lien vers le tableau de bord Service Health pour un incident

Vous pouvez créer un lien direct vers votre tableau de bord Service Health sur un poste de travail ou un appareil mobile en générant une URL spécialisée. Utilisez le trackingId ainsi que les trois premiers et les trois derniers chiffres de votre subscriptionId au format suivant :

https://app.azure.com/h/<trackingId>/<trois premiers et trois derniers chiffres de subscriptionId>

Par exemple, si votre subscriptionId est aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e et que votre trackingId est 0DET-URB, votre URL Service Health est :

https://app.azure.com/h/0DET-URB/bbadb3

Utiliser la propriété level pour détecter le niveau de gravité du problème

Du niveau de gravité le plus faible au plus élevé, la propriété level de la charge utile peut avoir la valeur Informational, Warning, Error ou Critical.

Analyser les services impactés pour déterminer l’étendue de l’incident

Les alertes Service Health peuvent vous informer sur les problèmes rencontrés dans plusieurs régions et services. Pour obtenir tous les détails, vous devez analyser la valeur de impactedServices.

Le contenu est une chaîne JSON faisant l’objet d’une séquence d’échappement. En l’absence de séquence d’échappement, le contenu correspond à un autre objet JSON qui peut être analysé de manière régulière. Par exemple :

{"data.context.activityLog.properties.impactedServices": "[{\"ImpactedRegions\":[{\"RegionName\":\"Australia East\"},{\"RegionName\":\"Australia Southeast\"}],\"ServiceName\":\"Alerts & Metrics\"},{\"ImpactedRegions\":[{\"RegionName\":\"Australia Southeast\"}],\"ServiceName\":\"App Service\"}]"}

devient :

[
   {
      "ImpactedRegions":[
         {
            "RegionName":"Australia East"
         },
         {
            "RegionName":"Australia Southeast"
         }
      ],
      "ServiceName":"Alerts & Metrics"
   },
   {
      "ImpactedRegions":[
         {
            "RegionName":"Australia Southeast"
         }
      ],
      "ServiceName":"App Service"
   }
]

Cet exemple illustre des problèmes qui se produisent pour :

« Alerts & Metrics » (Alertes et métriques) dans les régions Australie Est et Australie Sud-Est
« App Service » dans la région Australie Sud-Est

Tester l’intégration de votre Webhook via une requête HTTP POST

Effectuez les étapes suivantes :

Créez la charge utile Service Health à envoyer. Vous trouverez un exemple de charge utile de Webhook Service Health dans Webhook des alertes du journal d’activité Azure.

Créez une requête HTTP POST comme suit :

POST        https://your.webhook.endpoint

HEADERS     Content-Type: application/json

BODY        <service health payload>

Vous devez recevoir une réponse « 2XX - Successful » (2XX - Réussite).

Accédez à PagerDuty pour confirmer que votre intégration a été définie avec succès.

Étapes suivantes

Consultez le schéma webhook des alertes de journal d’activité.
En savoir plus sur les notifications sur l’intégrité du service.
En savoir plus sur les groupes d’actions.

Partage via