# Grafana 알림을 휴대폰으로 받아보세요.

> Grafana 알림을 푸시 알림으로 받아보세요. Pocket Alert를 웹훅 컨택트 포인트로 추가하면 발생한 알림 규칙을 1초 안에 휴대폰에서 확인할 수 있어요.

<!-- source: https://pocketalert.app/ko/use-cases/grafana-alerts -->

마지막 업데이트: 2026-08-11

Grafana 알림 규칙이 실행되면 알림 이름, 심각도, 상태가 1초 이내에 휴대폰에 도착합니다. 화면을 계속 열어 두지 않아도 대시보드가 빨갛게 변하기 전에 문제를 확인할 수 있습니다.

## 휴대폰에서 Grafana 알림을 받는 세 단계

1. **웹훅 만들기** — GJSON 메시지 템플릿이 있는 Pocket Alert 웹훅을 만들고 수신 URL을 복사하세요.
2. **연락처 지점 연결하기** — Grafana Alerting에서 이 URL을 Webhook 연락처 지점으로 추가하고 알림 정책에 연결하세요.
3. **매핑하고 전달하기** — GJSON이 status, alertname, severity, 요약을 푸시 알림에 매핑합니다. 다음에 발생하는 알림이 휴대폰을 울립니다.

## 알림 패널에서 잠금 화면까지

Grafana는 알림 규칙이 실행되면 이미 웹훅을 보냅니다. Pocket Alert는 이를 놓칠 수 없는 푸시 알림으로 바꿔 줍니다.

- **표준 연락처 지점** — Grafana Alerting에서 Pocket Alert를 Webhook 연락처 지점으로 추가하세요. 플러그인도, 에이전트도 필요 없고 Cloud와 셀프 호스팅 모두에서 작동합니다.
- **GJSON으로 필드 매핑** — GJSON 경로로 Grafana 페이로드에서 alertname, status, 요약 주석을 바로 꺼내 알림에 넣습니다.
- **심각도와 상태를 인라인으로** — 심각도 레이블과 firing/resolved 상태를 푸시 알림 안에 바로 표시해, critical 알림과 복구 알림이 한눈에 구분되게 합니다.
- **팀마다 채널 하나씩** — 애플리케이션마다 고유한 웹훅 URL이 있어, 인프라, 앱, 팀별 알림을 서로 다른 채널에 나눠 둘 수 있습니다.
- **1초 이내 전달** — 알림이 발생하면 1초 이내에 휴대폰에 도착하므로, 누군가 대시보드를 열기 훨씬 전에 확인할 수 있습니다.
- **비밀 웹훅 URL** — 웹훅 URL은 HTTPS로 전달되는 애플리케이션 비밀 값입니다. 새 엔드포인트가 필요하면 언제든 교체하세요.

## Grafana 알림을 휴대폰으로 보내기

### 1. Pocket Alert 웹훅 만들기

[Webhooks](https://pocketalert.app/ko/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](https://grafana.com/docs/grafana/latest/alerting/configure-notifications/manage-contact-points/integrations/webhook-notifier/)로 이동해 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 경로와 웹훅 옵션은 [웹훅 설정 문서](https://info.pocketalert.app/api/webhooks/settings.html)에서 확인할 수 있습니다.

## 자주 묻는 질문

### Grafana 알림을 휴대폰으로 보내려면 어떻게 하나요?

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로 대체됩니다.
