웹후크를 사용하여 문제 관리 시스템에 대한 상태 알림 구성

  • 아티클

이 문서에서는 웹후크를 통해 기존 알림 시스템에 데이터를 보내도록 Azure Service Health 경고를 구성하는 방법을 보여 줍니다.

Azure 서비스 인시던트가 영향을 미치는 경우 문자 메시지 또는 이메일을 통해 알리도록 Service Health 경고를 구성할 수 있습니다.

그러나 선호하는 기존 외부 알림 시스템이 있을 수 있습니다. 이 문서에서는 웹후크 페이로드의 가장 중요한 부분을 식별합니다. 또한 관련 서비스 문제가 발생할 때 알리도록 사용자 지정 경고를 만드는 방법을 설명합니다.

미리 구성된 통합을 사용하려면 다음을 참조하세요.

소개 비디오 보기:

Service Health 웹후크 페이로드를 사용하여 사용자 지정 알림 구성

고유한 사용자 지정 웹후크 통합을 설정하려면 Service Health 알림을 통해 전송되는 JSON 페이로드를 구문 분석해야 합니다.

웹후크 페이로드 예제ServiceHealth를 참조하세요.

context.eventSource == "ServiceHealth"를 보면 Service Health 경고인지 확인할 수 있습니다. 가장 관련성이 높은 속성은 다음과 같습니다.

  • 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

특수 URL을 생성하여 데스크톱 또는 모바일 디바이스에서 Service Health 대시보드에 대한 직접 링크를 만들 수 있습니다. trackingId 및 subscriptionId의 처음 3자리와 마지막 3자리를 다음 형식으로 사용합니다.

https://app.azure.com/h/<trackingId>/<subscriptionId의 처음 3자리 및 마지막 3자리>

예를 들어 subscriptionId가 bba14129-e895-429b-8809-278e836ecdb3이고 trackingId가 0DET-URB인 경우 Service Health URL은 다음과 같습니다.

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

수준을 사용하여 문제의 심각도 검색

페이로드의 수준 속성은 낮은 심각도에서 높은 심각도 순으로 '정보', '경고', '오류' 또는 '위험'일 수 있습니다.

영향을 받는 서비스를 구문 분석하여 인시던트 범위 결정

Service Health 경고는 여러 지역 및 서비스에서 문제를 알릴 수 있습니다. 전체 세부 정보를 얻으려면 impactedServices 값을 구문 분석해야 합니다.

내부 콘텐츠는 이스케이프된 JSON 문자열이며, 이스케이프되지 않으면 정기적으로 구문 분석할 수 있는 다른 JSON 개체를 포함합니다. 예시:

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

다음과 같이 사용하십시오.

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

이 예제에서는 다음 문제를 보여 줍니다.

  • 오스트레일리아 동부 및 오스트레일리아 남동부의 '경고 및 메트릭'.
  • 오스트레일리아 남동부의 'App Service'.

HTTP POST 요청을 통해 웹후크 통합 테스트

다음 단계를 수행합니다.

  1. 보낼 Service Health 페이로드를 만듭니다. Azure 활동 로그 경고에 대한 웹후크에서 Service Health 웹후크 페이로드 예제를 참조하세요.

  2. 다음과 같이 HTTP POST 요청을 만듭니다.

    POST        https://your.webhook.endpoint

HEADERS     Content-Type: application/json

BODY        <service health payload>

    '2XX - Successful' 응답을 받게 됩니다.

  3. PagerDuty로 이동하여 통합이 성공적으로 설정되었는지 확인합니다.

다음 단계