# Datadog 모니터 알림을 휴대폰으로 받아보세요.

> Datadog 모니터 알림을 푸시 알림으로 받아보세요. Pocket Alert를 웹훅으로 등록하면 임계값 초과를 휴대폰에서 1초 안에 확인할 수 있어요.

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

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

Datadog 모니터가 트리거되면 알림과 심각도가 1초 이내에 휴대폰에 도착해요. 페이지로 에스컬레이션되기 전에 장애를 잡아내세요.

## 세 단계로 Datadog 알림을 휴대폰에서 받기

1. **웹훅 만들기** — GJSON message 템플릿으로 Pocket Alert 웹훅을 만들고 수신 URL을 복사하세요.
2. **웹훅 연결하기** — Datadog Webhooks 연동에 URL을 등록하고 $EVENT_TITLE / $TEXT_ONLY_MSG 커스텀 페이로드를 설정한 뒤, 모니터에서 호출하세요.
3. **매핑하고 발송하기** — GJSON이 이벤트 제목, 메시지, 전환 상태를 푸시 알림으로 매핑해요. 다음 트리거부터 휴대폰이 울려요.

## 임계치 초과 모니터에서 잠금 화면까지

Datadog은 모니터가 임계치를 넘으면 이미 웹훅을 보내요. Pocket Alert은 이를 놓칠 수 없는 푸시 알림으로 바꿔 드려요.

- **Datadog 웹훅에 바로 연결** — Datadog Webhooks 연동에 Pocket Alert을 등록하고, 아무 모니터에서나 @webhook-pocketalert로 호출하세요.
- **템플릿 변수 입력, GJSON 출력** — Datadog 템플릿 변수가 JSON 본문을 채우고, Pocket Alert의 GJSON 경로가 이벤트 제목, 메시지, 전환 상태를 알림으로 가져와요.
- **트리거와 복구 구분** — $ALERT_TRANSITION을 매핑하면 트리거된 모니터와 복구 알림을 잠금 화면에서 다르게 읽을 수 있어요.
- **환경별 채널** — 애플리케이션마다 고유한 웹훅 URL이 있어, 인프라, APM, 팀별 모니터를 각각 별도 채널로 관리할 수 있어요.
- **1초 이내 전달** — 임계치 초과 알림이 1초 이내에 휴대폰에 도착하므로, 에스컬레이션 정책이 작동하기 훨씬 전에 확인할 수 있어요.
- **비밀 웹훅 URL** — 웹훅 URL은 HTTPS로 전달되는 애플리케이션 비밀 값이에요. 새 엔드포인트가 필요할 때마다 교체하세요.

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

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

[웹훅](https://pocketalert.app/ko/webhooks) 페이지에서 보낼 Datadog 페이로드를 매핑하는 GJSON `message` 템플릿으로 웹훅을 만드세요. API로도 만들 수 있어요:

```
curl -X POST "https://api.pocketalert.app/v1/webhooks" \
  -H "Token: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Datadog","message":"%event_title% — %alert_transition%\n%body%\n%link%","application_id":"qm47b9pzxzxg"}'
```

`https://p4a.me/wh/1234abcd` 같은 수신 URL이 발급돼요. 위의 GJSON 경로(`%event_title%`, `%alert_transition%`, `%body%`, `%link%`)는 다음 단계에서 Datadog이 POST로 보낼 JSON 키를 읽어요.

### 2. Datadog에 웹훅 등록하기

[Integrations → Webhooks](https://docs.datadoghq.com/integrations/webhooks/)로 이동해 새 웹훅을 추가하세요. 수신 URL을 붙여넣고 Datadog 템플릿 변수로 커스텀 페이로드를 정의하세요:

```
Name:    pocketalert
URL:     https://p4a.me/wh/1234abcd
Payload: {
  "event_title": "$EVENT_TITLE",
  "body": "$TEXT_ONLY_MSG",
  "alert_transition": "$ALERT_TRANSITION",
  "level": "critical",
  "link": "$LINK"
}
```

### 3. 모니터에서 호출하기

모니터 메시지에 `@webhook-pocketalert`를 추가하세요. 모니터가 트리거되면 Datadog이 위의 페이로드를 POST로 보내고, Pocket Alert이 GJSON 템플릿을 렌더링해 푸시를 보내요. 복구되면 `$ALERT_TRANSITION = Recovered`가 전송되어, 같은 알림이 해제될 때 "Recovered"로 표시돼요.

[웹훅 설정 문서](https://info.pocketalert.app/api/webhooks/settings.html)에서 모든 GJSON 경로와 웹훅 옵션을 확인할 수 있어요.

## 자주 묻는 질문

### Datadog 알림을 휴대폰으로 어떻게 보내나요?

Pocket Alert 웹훅을 만들고 수신 URL을 복사한 뒤, Datadog의 Integrations → Webhooks에 등록하세요. 모니터 메시지 아무 곳에나 @webhook-pocketalert를 넣으면 1초 이내에 알림이 휴대폰에 도착해요.

### 필드 매핑은 어떻게 동작하나요?

Datadog 웹훅에서 $EVENT_TITLE, $TEXT_ONLY_MSG, $ALERT_TRANSITION, $LINK 같은 템플릿 변수로 JSON 본문을 정의해요. Pocket Alert은 GJSON 경로로 이 JSON을 읽기 때문에, 메시지 템플릿에서 각 필드를 알림 제목과 본문에 매핑할 수 있어요.

### 알림 전환 상태와 심각도도 표시할 수 있나요?

네. 페이로드에 $ALERT_TRANSITION(Triggered / Recovered)이나 $ALERT_TYPE을 넣고 메시지 템플릿에서 참조하면, 트리거된 모니터와 복구 알림의 문구를 다르게 표시할 수 있어요. 텍스트에 넣고 싶다면 $PRIORITY와 $ALERT_STATUS도 사용할 수 있어요.

### 프로덕션과 스테이징을 분리할 수 있나요?

환경이나 팀마다 웹훅을 하나씩 등록하고, 각 모니터에서 알맞은 웹훅을 참조하세요. 프로덕션과 스테이징은 별도 채널로 전달되어 각각 독립적으로 음소거할 수 있어요.

### 별도의 에이전트가 필요한가요?

필요 없어요. Pocket Alert은 Datadog 모니터 엔진이 보내는 웹훅을 받기 때문에, 이미 실행 중인 Datadog 에이전트 외에 추가 에이전트가 필요 없어요.

### 알림 심각도를 알림 우선순위로 매핑할 수 있나요?

네. 웹훅 페이로드를 직접 정의하므로 $EVENT_TITLE 옆에 "level" 필드를 추가하세요. 값은 silent, low, default, high, critical 중 하나이고, Pocket Alert이 이를 알림 우선순위로 매핑해요. 페이징 모니터에서는 critical을 보내 방해 금지 모드도 뚫고 알림이 도착하게 할 수 있어요. 또는 웹훅에 default_level을 설정하고 필드를 생략해도 돼요. 명시한 level이 항상 우선하며, 잘못된 값은 거부되지 않고 default로 처리돼요.
