목차
장애가 발생했을 때 이메일이나 채팅 알림은 놓치기 쉽습니다. 중요한 알림이라면 Echobell이 Grafana Webhook 알림을 에스컬레이션과 재시도를 지원하는 실제 전화 통화로 바꿔 줍니다. 이 가이드에서는 전체 설정 과정을 단계별로 살펴봅니다.
관련 문서:
- Echobell이란 → /docs/what-is-echobell
- 알림 유형과 재시도 → /docs/notification
- Webhook 개요 → /docs/webhook
- Grafana 연동 레퍼런스 → /docs/developer/grafana
사전 준비
- 활성화된 채널과 Webhook URL이 있는 Echobell 계정(/docs/webhook 참고)
- Grafana 인스턴스의 관리자 권한
- 설정된 알림 규칙 최소 한 개
설정
1단계 — Grafana에서 Webhook 연락 지점 만들기
- Alerting → Contact points로 이동합니다
- New contact point를 클릭하고 Webhook을 선택합니다
- “Echobell Phone Calls”처럼 알아보기 쉬운 이름을 지정합니다
2단계 — Echobell Webhook URL 입력하기
URL을 채널의 Webhook 주소로 설정합니다.
https://hook.echobell.one/t/<channel-token>
이 주소는 Echobell의 채널 설정에서 복사할 수 있습니다(자세한 내용은 /docs/webhook 참고). 비밀 값처럼 다루고, 유출된 경우에는 새로 발급하세요.
3단계 — 연동 테스트하기
Grafana에서 Test를 클릭해 테스트 알림을 보냅니다. 몇 초 안에 Echobell 전화 알림을 받게 됩니다.
4단계 — 알림 정책에 연결하기
- Alerting → Notification policies로 이동합니다
- 중요 알림을 대상으로 하는 정책을 만들거나 편집합니다
- “Echobell Phone Calls” 연락 지점을 추가합니다
이제 Grafana가 조건에 맞는 알림을 Echobell로 전달합니다.
모범 사례
- 전화 알림은 우선순위가 높은 알림에만 사용하고, 심각도가 낮은 알림에는 채팅이나 이메일을 사용합니다
- 알림 피로를 줄이려면 Echobell에서 재시도 횟수와 타임아웃을 설정합니다(/docs/notification)
- 첫 번째 전화를 받지 못했을 때 팀원에게 에스컬레이션되도록 설정합니다
- 긴급하지 않은 알림으로 잠에서 깨지 않도록 방해 금지 시간대를 지정합니다
- 온콜 팀과 채널을 공유하고 담당자 목록을 최신 상태로 유지합니다
고급 옵션
- 더 넓은 범위를 커버할 수 있도록 팀원과 채널을 공유합니다
- 템플릿을 사용해 알림 유형별로 음성 내용을 맞춤 설정합니다
- 재시도 횟수와 에스컬레이션 경로를 설정합니다
- 안정성을 위해 백업 연락처를 지정합니다
전체 레퍼런스: /docs/developer/grafana
문제 해결
- 전화가 오지 않는 경우: 알림 정책이 Echobell 연락 지점으로 라우팅되는지 확인합니다
- Webhook에서 4xx 오류가 발생하는 경우: Webhook URL이 정확한지, 채널이 활성 상태인지 확인합니다
- 전화가 너무 많이 오는 경우: 정책 범위를 좁히거나 알림 심각도 기준을 높입니다
- 전화가 너무 적게 오는 경우: 심각도를 높이거나 레이블 필터를 추가해 중요한 알림이 정책에 매칭되도록 합니다
관련 글
- 직접 만든 시스템을 위한 Webhook 알림 → /blog/get-notified-with-webhook-mcp
- GitHub Actions 실패 알림 → /blog/github-actions-notifications
- Grafana 개발자 문서 → /docs/developer/grafana