알림 패널에서 잠금 화면까지
Grafana는 알림 규칙이 실행되면 이미 웹훅을 보냅니다. Pocket Alert는 이를 놓칠 수 없는 푸시 알림으로 바꿔 줍니다.
표준 연락처 지점
Grafana Alerting에서 Pocket Alert를 Webhook 연락처 지점으로 추가하세요. 플러그인도, 에이전트도 필요 없고 Cloud와 셀프 호스팅 모두에서 작동합니다.
GJSON으로 필드 매핑
GJSON 경로로 Grafana 페이로드에서 alertname, status, 요약 주석을 바로 꺼내 알림에 넣습니다.
심각도와 상태를 인라인으로
심각도 레이블과 firing/resolved 상태를 푸시 알림 안에 바로 표시해, critical 알림과 복구 알림이 한눈에 구분되게 합니다.
팀마다 채널 하나씩
애플리케이션마다 고유한 웹훅 URL이 있어, 인프라, 앱, 팀별 알림을 서로 다른 채널에 나눠 둘 수 있습니다.
1초 이내 전달
알림이 발생하면 1초 이내에 휴대폰에 도착하므로, 누군가 대시보드를 열기 훨씬 전에 확인할 수 있습니다.
비밀 웹훅 URL
웹훅 URL은 HTTPS로 전달되는 애플리케이션 비밀 값입니다. 새 엔드포인트가 필요하면 언제든 교체하세요.
휴대폰에서 Grafana 알림을 받는 세 단계
웹훅 만들기
GJSON 메시지 템플릿이 있는 Pocket Alert 웹훅을 만들고 수신 URL을 복사하세요.
연락처 지점 연결하기
Grafana Alerting에서 이 URL을 Webhook 연락처 지점으로 추가하고 알림 정책에 연결하세요.
매핑하고 전달하기
GJSON이 status, alertname, severity, 요약을 푸시 알림에 매핑합니다. 다음에 발생하는 알림이 휴대폰을 울립니다.
Grafana 알림을 휴대폰으로 보내기
1. Pocket Alert 웹훅 만들기
Webhooks 페이지에서 Grafana 페이로드를 읽는 GJSON message 템플릿이 포함된 웹훅을 만드세요. Grafana는 status, commonLabels 블록, alerts 배열을 보내므로, 다음과 같은 템플릿이 적합합니다:
curl -X POST "https://api.pocketalert.app/v1/webhooks" \
-H "Token: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"name":"Grafana","default_level":"critical","message":"[%status%] %commonLabels.alertname% (%commonLabels.severity%)\n%alerts.0.annotations.summary%","application_id":"qm47b9pzxzxg"}'
다음과 같은 수신 URL이 발급됩니다. https://p4a.me/wh/1234abcd
2. Webhook 연락처 지점으로 추가하기
Grafana에서 Alerting → Contact points → Add contact point로 이동해 Webhook 연동을 선택하고 수신 URL을 붙여넣으세요:
Integration: Webhook
URL: https://p4a.me/wh/1234abcd
Method: POST
연락처 지점을 알림 정책에 연결하면 조건에 맞는 알림이 해당 지점으로 라우팅됩니다. Grafana는 표준 JSON을 보내며, 위의 GJSON 경로가 status, commonLabels.alertname, commonLabels.severity, alerts.0.annotations.summary를 푸시 알림에 담습니다.
3. 테스트 실행하기
연락처 지점의 Test 버튼을 사용하세요. 발생한 알림은 [firing] HighCPU (critical)로 도착하고, 해제되면 status가 resolved로 바뀝니다.
모든 GJSON 경로와 웹훅 옵션은 웹훅 설정 문서에서 확인할 수 있습니다.
궁금한 점을 답해드려요
Grafana에서 Alerting → Contact points로 이동해 Webhook 연락처 지점을 추가하고, Pocket Alert 애플리케이션 URL을 붙여넣으세요. 알림 정책에 연결하면 다음에 울리는 알림이 1초 이내에 휴대폰에 도착합니다.
Grafana는 status, commonLabels 블록, alerts 배열이 담긴 JSON 페이로드를 보냅니다. Pocket Alert는 GJSON 경로로 이를 읽으므로, commonLabels.alertname을 제목에, alerts.0.annotations.summary를 본문에, status를 firing 또는 resolved 표시에 매핑하면 됩니다.
네. 페이로드의 commonLabels.severity에 심각도 레이블이 있고, status에는 firing 또는 resolved 값이 들어 있습니다. GJSON 메시지 템플릿에서 두 값을 모두 참조하면 critical 등급의 발생 알림과 해결된 알림을 다르게 표시할 수 있습니다.
Grafana 폴더나 팀마다 별도의 애플리케이션을 만드세요. 인프라 알림과 앱 알림이 서로 다른 채널로 들어오고, 한쪽만 음소거해도 다른 쪽에는 영향이 없습니다.
추가로 필요한 것은 없습니다. Pocket Alert는 Grafana 알림 엔진이 이미 보내는 웹훅을 그대로 받으므로, 설치할 플러그인이나 에이전트가 없습니다. Grafana Cloud와 셀프 호스팅 환경 모두에서 작동합니다.
네. 모든 메시지에는 silent, low, default, high, critical 중 하나의 등급을 지정할 수 있습니다. 페이로드에 "level" 필드를 넣거나, 웹훅에 default_level을 설정하면 해당 웹훅으로 라우팅되는 모든 알림이 그 우선순위로 도착합니다. 페이로드에 명시한 level이 우선합니다. firing=critical, resolved=silent로 나누면 좋습니다. 발생한 알림은 방해 금지 모드를 뚫고 울리고, 복구 알림은 기록에만 조용히 남습니다. 잘못된 값은 거부되지 않고 default로 대체됩니다.