# Datadog のモニターを スマホに届けます 。

> Datadog のモニターアラートをプッシュ通知で受け取れます。Pocket Alert を Webhook として登録すれば、しきい値の超過を 1 秒足らずでスマホにお知らせします。

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

最終更新日:2026-08-11

Datadog のモニターが発生すると、アラートと重大度が 1 秒以内にスマホへ届きます。ページングに発展する前に、インシデントを捕捉してください。

## Datadog のアラートをスマホで受け取る 3 ステップ

1. **Webhook を作成** — GJSON の message テンプレートを使って Pocket Alert の Webhook を作成し、受信 URL をコピーします。
2. **Webhook を接続** — 受信 URL を Datadog の Webhooks インテグレーションに登録し、$EVENT_TITLE / $TEXT_ONLY_MSG を使ったカスタムペイロードを設定してから、モニターから呼び出します。
3. **割り当てて配信** — GJSON がイベントタイトル、メッセージ、遷移状態をプッシュ通知に割り当てます。次の発生でスマホが振動します。

## 閾値超過のモニターからロック画面まで

Datadog はモニターが閾値を超えると既に Webhook を送信しています。Pocket Alert はそれを見逃せないプッシュ通知に変えます。

- **Datadog の Webhook に対応** — Datadog の Webhooks インテグレーションに Pocket Alert を登録し、任意のモニターから @webhook-pocketalert で呼び出します。
- **テンプレート変数を入力し、GJSON で出力** — Datadog のテンプレート変数で JSON ボディを埋めます。Pocket Alert の GJSON パスがイベントタイトル、メッセージ、遷移状態を取り出し、通知に反映します。
- **発生と復旧を区別** — $ALERT_TRANSITION を割り当てると、発生時と復旧時の表示を変えられます。ロック画面でそのまま確認できます。
- **環境ごとのチャンネル** — アプリケーションごとに Webhook URL が割り当てられるため、インフラ、APM、チーム別のモニターを別々のチャンネルで管理できます。
- **1 秒以内に配信** — 閾値超過は 1 秒以内にスマホへ届くため、エスカレーションポリシーが動く前に気づけます。
- **秘密にすべき Webhook URL** — Webhook URL は HTTPS 上のアプリケーションの秘密情報として扱ってください。新しいエンドポイントが必要になったら、いつでもローテーションできます。

## Datadog のアラートをスマホに送る

### 1. Pocket Alert の Webhook を作成

[Webhooks](https://pocketalert.app/ja/webhooks) ページで Webhook を作成します。送信される 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 に Webhook を登録

[インテグレーション → Webhooks](https://docs.datadoghq.com/integrations/webhooks/) を開き、新しい Webhook を追加します。受信 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" と表示されます。

[Webhook 設定のドキュメント](https://info.pocketalert.app/api/webhooks/settings.html)では、すべての GJSON パスと Webhook のオプションを説明しています。

## よくある質問

### Datadog のアラートをスマホに送るには？

Pocket Alert で Webhook を作成し、受信 URL をコピーします。次に Datadog の「インテグレーション → Webhooks」で登録します。モニターのメッセージに @webhook-pocketalert を含めると、1 秒以内にスマホへ通知が届きます。

### フィールドのマッピングはどのように機能しますか？

Datadog の Webhook では、$EVENT_TITLE、$TEXT_ONLY_MSG、$ALERT_TRANSITION、$LINK などのテンプレート変数を使って JSON ボディを定義します。Pocket Alert はその JSON を GJSON のパスで読み取るため、メッセージテンプレートでそれらのフィールドを通知のタイトルと本文に割り当てられます。

### アラートの遷移や重大度を表示できますか？

はい。ペイロードに $ALERT_TRANSITION（Triggered / Recovered）または $ALERT_TYPE を含め、メッセージテンプレートで参照すると、発生時と復旧時で表示内容を変えられます。本文に含めたい場合は $PRIORITY と $ALERT_STATUS も利用できます。

### 本番とステージングを分けられますか？

環境やチームごとに Webhook を 1 つずつ登録し、各モニターから適切なものを参照してください。本番とステージングは別のチャンネルに届くため、それぞれ個別にミュートできます。

### 別のエージェントは必要ですか？

ホストへの追加は不要です。Pocket Alert は Datadog のモニターエンジンが送信する Webhook を受信するだけなので、既に運用している Datadog Agent 以外に追加のエージェントは必要ありません。

### アラートの重大度をプッシュ通知の優先度に対応付けられますか？

はい。Webhook のペイロードは自分で定義するため、$EVENT_TITLE の隣に "level" フィールドを追加できます。値は silent、low、default、high、critical のいずれかで、Pocket Alert がこれをプッシュ通知の優先度に変換します。ページングを行うモニターからは critical を送ると、おやすみモードでも通知が届きます。フィールドを省略する場合は Webhook に default_level を設定してください。明示的な level は常に優先されます。無効な値は拒否されず、default にフォールバックします。
