閾値超過のモニターからロック画面まで
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 ステップ
Webhook を作成
GJSON の message テンプレートを使って Pocket Alert の Webhook を作成し、受信 URL をコピーします。
Webhook を接続
受信 URL を Datadog の Webhooks インテグレーションに登録し、$EVENT_TITLE / $TEXT_ONLY_MSG を使ったカスタムペイロードを設定してから、モニターから呼び出します。
割り当てて配信
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 のオプションを説明しています。
よくある質問
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 インテグレーションとして登録してください。