Konfigurace oznámení o stavu pro systémy správy problémů pomocí webhooku

Článek
10/22/2024

V tomto článku se dozvíte, jak nakonfigurovat upozornění služby Azure Service Health tak, aby odesílala data prostřednictvím webhooků do stávajícího systému oznámení.

Upozornění služby Service Health můžete nakonfigurovat tak, aby vás informovala textovou zprávou nebo e-mailem, když vás ovlivní incident služby Azure.

Možná už ale máte existující externí systém oznámení, který dáváte přednost použití. Tento článek identifikuje nejdůležitější části datové části webhooku. Popisuje, jak vytvořit vlastní upozornění, která vás upozorní, když dojde k příslušným problémům se službami.

Pokud chcete použít předkonfigurovanou integraci, přečtěte si:

Podívejte se na úvodní video:

Konfigurace vlastního oznámení pomocí datové části webhooku služby Service Health

Pokud chcete nastavit vlastní integraci webhooku, musíte analyzovat datovou část JSON odeslanou prostřednictvím oznámení služby Service Health.

Podívejte se na ukázkovou ServiceHealth datovou část webhooku.

Můžete si ověřit, že se jedná o upozornění na stav služby, a to tak, že se podíváte na context.eventSource == "ServiceHealth". Nejrelevavantnější jsou následující vlastnosti:

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

Vytvoření odkazu na řídicí panel Service Health pro incident

Přímý odkaz na řídicí panel služby Service Health můžete vytvořit na stolním nebo mobilním zařízení tak, že vygenerujete specializovanou adresu URL. Použijte trackingId a první tři a poslední tři číslice id předplatného v tomto formátu:

https://app.azure.com/h/< trackingId>/<první tři a poslední tři číslice ID předplatného>

Pokud je například vaše id předplatného aaaa0a0a-bb1b-cc2c-dd3d-eeeeeee4e4e4e a id sledování je 0DET-URB, adresa URL služby Service Health je:

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

Zjištění závažnosti problému pomocí úrovně

Od nejnižší po nejvyšší závažnost může být vlastnost úrovně v datové části informační, upozornění, chyba nebo kritická.

Parsování ovlivněných služeb za účelem určení rozsahu incidentu

Výstrahy služby Service Health vás můžou informovat o problémech napříč několika oblastmi a službami. K získání úplných podrobností je nutné analyzovat hodnotu impactedServices.

Obsah, který je uvnitř, je uvozený řetězec JSON , který při zrušení zobrazení obsahuje další objekt JSON, který je možné pravidelně analyzovat. Příklad:

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

stane se:

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

Tento příklad ukazuje problémy pro:

Výstrahy a metriky v oblasti Austrálie – východ a Austrálie – jihovýchod.
App Service v Austrálii – jihovýchod.

Otestování integrace webhooku prostřednictvím požadavku HTTP POST

Postupujte následovně:

Vytvořte datovou část stavu služby, kterou chcete odeslat. Podívejte se na ukázkovou datovou část webhooku stavu služby na webhoocích pro upozornění protokolu aktivit Azure.

Následujícím způsobem vytvořte požadavek HTTP POST:

POST        https://your.webhook.endpoint

HEADERS     Content-Type: application/json

BODY        <service health payload>

Měla by se zobrazit odpověď 2XX – Úspěch.

Přejděte na PagerDuty a ověřte, že vaše integrace byla úspěšně nastavená.

Další kroky

Zkontrolujte schéma webhooku upozornění protokolu aktivit.
Přečtěte si informace o oznámeních o stavu služby.
Přečtěte si další informace o skupinách akcí.

Sdílet prostřednictvím