スタックトレースからロック画面まで
エラー監視ツールはすでに Webhook を送信しています。Pocket Alert がそれを、見逃せないプッシュ通知に変えます。
主要なエラー監視ツールに対応
Sentry、Rollbar、Bugsnag、Honeybadger、Airbrake はいずれも新しい issue で送信 Webhook を発火します。送信先に Pocket Alert を指定するだけで設定は完了です。
GJSON でフィールドをマッピング
GJSON パスを使うと、data.event.title、data.event.culprit、data.event.level をペイロードから直接取り出して通知に含められます。
レベルとルールをその場で表示
発火したエラーレベルとルールをプッシュ通知の中に表示します。fatal の例外と warning を通知の時点で見分けられます。
環境ごとにチャンネルを分離
アプリケーションごとに固有の Webhook URL が発行されるため、本番、検証、特定のサービスの通知を別々のチャンネルで管理できます。
1 秒以内に配信
例外は 1 秒以内にスマホへ届きます。メールのダイジェストより前に気づけます。
シークレットの Webhook URL
Webhook URL は HTTPS 経由のアプリケーションのシークレットです。新しいエンドポイントが必要になったときはいつでも再発行できます。
スマホでエラーアラートを受け取る 3 つのステップ
Webhook を作成
GJSON の message テンプレートを使って Pocket Alert の Webhook を作成し、受信 URL をコピーします。
エラー監視ツールを接続
Sentry の Internal Integration(または Rollbar / Bugsnag の Webhook)に URL を貼り付け、アラートルールに追加します。
マッピングして配信
GJSON が data.event.title、culprit、level、web_url をプッシュ通知に割り当てます。次の例外が発生すると、スマホが振動します。
エラーアラートをスマホに送信
1. Pocket Alert の Webhook を作成
Webhook ページで、Sentry の issue-alert ペイロードを読み取る GJSON の message テンプレートを指定して Webhook を作成します(すべてのデータは data.event の下にネストされています)。
curl -X POST "https://api.pocketalert.app/v1/webhooks" \
-H "Token: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"name":"Sentry","default_level":"critical","message":"[%data.event.level%] %data.event.title%\n%data.event.culprit%\n%data.event.web_url%","application_id":"qm47b9pzxzxg"}'
受信 URL は https://p4a.me/wh/1234abcd のような形式で発行されます。
2. Sentry で受信 URL を設定
設定 → Developer Settings → Internal Integration で、Webhook URL に受信 URL を設定し、Alert Rule Action を有効にします。次に issue alert ルールを作成し、そのアクションとして連携を追加します。
Webhook URL: https://p4a.me/wh/1234abcd
Permissions: Issue & Event (Read)
Action: Alert Rule Action — enabled
Alerts → Create Alert → When a new issue is created
→ Then send a notification via [your integration]
Sentry は {"action":"triggered","data":{"event":{"title":...,"culprit":...,"level":...,"web_url":...}}} を POST します。上記の GJSON パスがこれらのフィールドをプッシュ通知に取り込みます。
3. 他のエラー監視ツール(Rollbar、Bugsnag)
Rollbar(設定 → Notifications → Webhook)と Bugsnag(Integrations → Generic webhook)は、よりフラットなペイロードを送信します。テンプレートをそれぞれのフィールドに合わせて調整してください。例えば Rollbar では %data.item.title%、Bugsnag では %error.exceptionClass% を使います。受信 URL は同じものを貼り付けてください。
すべての GJSON パスと Webhook の設定オプションについては、Webhook 設定のドキュメントをご覧ください。
よくある質問
Sentry で、Webhook URL に Pocket Alert の受信 URL を設定し、Alert Rule Action を有効にした Internal Integration を作成してください。そのうえで issue alert ルールに追加します。ルールが発火すると Sentry が issue を POST し、1 秒以内にスマホへ通知が届きます。
Sentry の issue-alert Webhook はデータを data.event の下にネストして送信します。Pocket Alert は GJSON パスでこれを読み取るため、data.event.title を通知のタイトルに、data.event.culprit または web_url を本文にマッピングします。これにより、どの issue が発火したかを通知で正確に把握できます。
ペイロードには data.event.level(warning、error、fatal)と、data.triggered_rule にルール名が含まれます。GJSON のメッセージテンプレートで両方を参照すると、fatal の例外と warning の通知を見分けられます。
環境ごとに個別のアプリケーションを作成してください。本番用と検証用の Webhook はそれぞれ別のチャンネルに届くため、本番に影響を与えずに検証環境の通知だけをミュートできます。
不要です。Pocket Alert は、エラー監視ツールがすでに送信している Webhook を受信するだけなので、エージェントや SDK のインストールは必要ありません。Sentry、Rollbar、Bugsnag、Honeybadger、Airbrake はいずれも送信 Webhook に対応しています。
はい。メッセージに "level":"critical" を追加すると、Android では専用の通知チャンネルに投稿され、おやすみモードを無視して届きます。おやすみモードへのアクセスは一度許可するだけで済みます。iPhone では high と critical が、集中モードを突破する時間重視の通知として届きます。すべてのメッセージは silent から critical までのレベルを指定できるため、検証環境の warning は静かに届けつつ、本番の fatal だけは確実に通知できます。無料プランでは critical は high として配信されます。即時配信は変わりませんが、おやすみモードの無視はされません。