Datadog

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

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

1 秒未満でプッシュエージェントの追加不要モニター & APM 更新
機能

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

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 のアラートをスマホで受け取る 3 ステップ

1

Webhook を作成

GJSON の message テンプレートを使って Pocket Alert の Webhook を作成し、受信 URL をコピーします。

2

Webhook を接続

受信 URL を Datadog の Webhooks インテグレーションに登録し、$EVENT_TITLE / $TEXT_ONLY_MSG を使ったカスタムペイロードを設定してから、モニターから呼び出します。

3

割り当てて配信

GJSON がイベントタイトル、メッセージ、遷移状態をプッシュ通知に割り当てます。次の発生でスマホが振動します。

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

1. Pocket Alert の Webhook を作成

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 を開き、新しい 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 設定のドキュメントでは、すべての GJSON パスと Webhook のオプションを説明しています。

FAQ

よくある質問

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 にフォールバックします。

ページが呼び出される前に、閾値超過を捕捉。

アプリケーションを作成して Webhook URL をコピーし、Datadog の Webhook インテグレーションとして登録してください。