Webhook 커스터마이징¶

Webhook 커스터마이징은 일반적인 알림 방식입니다. Guance에서 생성된 알림 이벤트를 HTTP 수신을 지원하는 모든 시스템이나 플랫폼으로 전송하여 내부 운영 시스템, 자동화 플랫폼 또는 타사 도구와의 통합을 구현할 수 있습니다.

설정 단계¶

현재 알림 대상의 이름을 정의합니다. 알림 대상 목록에서 식별하는 데 사용됩니다.
알림을 수신할 HTTP 인터페이스 주소를 입력합니다. 모니터가 알림을 트리거하면 Guance에서 해당 주소로 POST 요청을 전송합니다(❗️입력한 Webhook URL이 선택한 알림 플랫폼 유형과 일치하는지 확인해야 합니다).
알림과 함께 전송할 멤버를 선택합니다.
필요에 따라 알림이 전송되었는지 테스트합니다(❗️이 Webhook에 해당하는 그룹/채널로 테스트 메시지를 전송합니다. 해당 알림 대상 내에서 테스트 정보가 성공적으로 전송되었는지 확인하세요).
작업 권한을 구성합니다.
확인합니다.

멤버 선택¶

알림과 함께 전송할 멤버를 선택합니다. Webhook 알림 시 선택한 멤버 정보가 함께 외부로 전송되어, 타사 시스템이 멤버를 기준으로 권한 할당 또는 알림 라우팅을 수행할 수 있도록 합니다.

여기서 선택 가능한 멤버에는 현재 워크스페이스 내의 모든 팀 및 워크스페이스 멤버가 포함됩니다:

알림 내용¶

최종적으로 외부로 전송되는 Webhook 이벤트 알림에는 다음 내용이 포함됩니다:

이벤트 정보¶

bodyType은 json 텍스트입니다:

POST http://my-system/accept-webhook
Content-Type: application/json

{
    "timestamp"               : 1625638440,
    "df_status"               : "warning",
    "df_event_id"             : "event-xxxxxxxxxx",
    "df_title"                : "web001存在问题",
    "df_message"              : "web001存在问题\nCPU使用率大于90\n内存使用率大于90",
    "df_dimension_tags"       : "{\"host\":\"web001\"}",
    "df_monitor_id"           : "monitor_xxxxxxxxxx",
    "df_monitor_name"         : "异常检测名",
    "df_monitor_checker_id"   : "rul_xxxxxxxxxx",
    "df_monitor_checker_name" : "异常检测项目名",
    "df_monitor_checker_value": "99",
    "df_event_link"           : "https://console.guance.com/keyevents/monitorChart?xxxxxxxxxx"
    "df_workspace_uuid"       : "wksp_xxxxxxxxxx",
    "df_workspace_name"       : "我的工作空间",
    "Result"                  : 99,
    "...其他更多字段": "略",

    // 다음은 이전 버전의 필드입니다
    "date"          : 1625638440,
    "workspace_uuid": "wksp_xxxxxxxxxx",
    "workspace_name": "我的工作空间",
}

멤버 정보¶

멤버가 구성된 경우 Webhook는 멤버 정보를 함께 전달합니다.

워크스페이스 속성 클레임 동기 추가¶

워크스페이스에 속성 클레임이 구성된 경우 관련 필드가 알림 내용에 자동으로 추가됩니다.

자세한 내용은 속성 클레임을 참조하세요.

설명

Webhook 커스터마이징 알림 전송 내용의 유형은 JSON 형식만 지원합니다. 각 필드의 자세한 내용은 이벤트 생성을 참조하세요.

더 많은 실습 사례는 Guance Webhook 커스터마이징 알림 통합을 참조하세요.