Een webhook gebruiken om statusmeldingen voor probleembeheersystemen te configureren

  • Artikel

In dit artikel leest u hoe u Azure Service Health-waarschuwingen configureert voor het verzenden van gegevens via webhooks naar uw bestaande meldingssysteem.

U kunt Service Health-waarschuwingen configureren om u per sms of e-mailbericht op de hoogte te stellen wanneer een Azure-service-incident van invloed is op u.

Maar mogelijk hebt u al een bestaand extern systeem voor meldingen dat u liever gebruikt. In dit artikel worden de belangrijkste onderdelen van de nettolading van de webhook geïdentificeerd. Daarnaast wordt beschreven hoe u aangepaste waarschuwingen maakt om u op de hoogte te stellen wanneer er relevante serviceproblemen optreden.

Als u een vooraf geconfigureerde integratie wilt gebruiken, raadpleegt u:

Bekijk een inleidende video:

Een aangepaste melding configureren met behulp van de nettolading van de Service Health-webhook

Als u uw eigen aangepaste webhookintegratie wilt instellen, moet u de JSON-nettolading parseren die wordt verzonden via servicestatusmelding.

Bekijk een voorbeeldServiceHealth van een webhook-nettolading.

U kunt bevestigen dat het een servicestatuswaarschuwing is door naar context.eventSource == "ServiceHealth"te kijken. De volgende eigenschappen zijn het meest relevant:

  • 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

U kunt een directe koppeling maken naar uw Service Health-dashboard op een desktop of mobiel apparaat door een gespecialiseerde URL te genereren. Gebruik de trackingId en de eerste drie en laatste drie cijfers van uw subscriptionId in deze indeling:

https://app.azure.com/h/< trackingId>/<first three and last three digits of subscriptionId>

Als uw subscriptionId bijvoorbeeld bba14129-e895-429b-8809-278e836ecdb3 is en uw trackingId 0DET-URB is, is uw Service Health-URL:

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

Het niveau gebruiken om de ernst van het probleem te detecteren

Van laag naar hoogste ernst kan de eigenschap niveau in de nettolading informatief, waarschuwing, fout of kritiek zijn.

De betrokken services parseren om het incidentbereik te bepalen

Service Health-waarschuwingen kunnen u informeren over problemen in meerdere regio's en services. Voor volledige details moet u de waarde van impactedServices.

De inhoud die zich in een escape-JSON-tekenreeks bevindt, bevat een ander JSON-object dat regelmatig kan worden geparseerd. Voorbeeld:

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

Wordt:

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

In dit voorbeeld ziet u problemen voor:

  • Waarschuwingen en metrische gegevens in Australië - oost en Australië - zuidoost.
  • 'App Service' in Australië - zuidoost.

Uw webhookintegratie testen via een HTTP POST-aanvraag

Volg vervolgens deze stappen:

  1. Maak de nettolading van de servicestatus die u wilt verzenden. Bekijk een voorbeeld van de webhookpayload van de servicestatus in Webhooks voor waarschuwingen voor azure-activiteitenlogboeken.

  2. Maak als volgt een HTTP POST-aanvraag:

    POST        https://your.webhook.endpoint

HEADERS     Content-Type: application/json

BODY        <service health payload>

    U ontvangt het antwoord '2XX - Geslaagd'.

  3. Ga naar PagerDuty om te bevestigen dat uw integratie is ingesteld.

Volgende stappen