Configure Webhook Notifications

Webhook 콜백을 사용하여 맞춤형 URL에서 경보 알림을 수신하면 자동 모니터링 및 대응 워크플로우를 구축할 수 있습니다. 본 가이드에서는 구성 및 테스트 과정을 단계별로 안내합니다.

구성 단계

1. 경보 규칙 생성

Webhook 기능을 사용하려면, 먼저 알림을 트리거할 경보 규칙을 생성해야 합니다.

1. Cloud Monitor → Alert Service → Alert Rules로 이동하세요.
2. 경보 규칙 생성 버튼을 클릭하세요.
3. 규칙의 이름을 설정하고 알림 조건을 정의하세요.
4. “알림 방식” 섹션에서 Webhook Callback 옵션을 선택하세요.

2. Webhook URL 구성

알림 규칙을 생성할 때 Webhook callback의 대상 URL을 지정해야 합니다.

1. 경보 알림을 수신할 URL을 입력하세요. 해당 URL이 공개적으로 접근 가능해야 하며, 서버가 POST 요청을 처리할 수 있도록 구성되어 있어야 합니다.
2. 변경 사항을 저장하세요.

참고: Webhook 엔드포인트는 Cloud Monitoring 시스템에서 전송하는 POST 요청을 정확하게 파싱하고 응답할 수 있어야 하며, 그렇지 않으면 알림이 실패할 수 있습니다.

웹후크 콜백 테스트하기

구성이 올바른지 확인하려면 테스트를 수행해야 합니다.

1. Webhook URL 입력란 옆에 위치한 테스트 버튼을 클릭하세요. 이 작업은 경보를 시뮬레이션하여 테스트 payload를 해당 URL로 전송합니다.
2. 모니터링 시스템에서 테스트 페이로드가 귀하의 엔드포인트로 정상적으로 수신되었는지 확인하십시오.

콜백은 다음과 같은 매개변수를 포함하는 JSON 본문의 POST 요청으로 전송됩니다. 추후 새로운 필드가 추가될 수 있으니, 귀하의 엔드포인트가 추가 매개변수도 처리할 수 있도록 해주십시오.

다음은 귀하의 엔드포인트가 수신하게 될 JSON 페이로드의 예시입니다:

{


"loginName": "user@example.com"


"alarmTime": "2025-07-09T15:22:00Z",


"ruleName": "High Bandwidth Alert",


"monitor": "Total egress bandwidth exceeded 100Gbps."


}

테스트 알림을 받지 못한 경우, 네트워크 연결과 엔드포인트 구성이 올바르게 작동하는지 확인해 주십시오.

문제 해결

알림을 받지 못하는 경우, 다음의 일반적인 문제를 확인하세요:

• 잘못된 URL: Webhook URL이 올바르고 외부에서 접근 가능한지 확인하세요.
• POST 요청 처리: 엔드포인트가 POST 요청을 올바르게 처리하고 JSON 페이로드를 파싱하도록 올바르게 구성되어 있는지 확인하세요.
• 네트워크 연결: 모니터링 시스템에서 들어오는 요청을 차단하는 방화벽 규칙이나 네트워크 문제가 있는지 확인하세요.

구성이 완료되면 Webhook 연동을 통해 자동화된 실시간 이벤트 알림을 받을 수 있습니다. 이제 이러한 알림을 파싱해서 사용자 정의 로직을 빌드하거나 자동화된 응답을 트리거하여, 인시던트 관리 효율성을 크게 향상시킬 수 있습니다.