# 例外を スマホに届けましょう 。

> Sentry、Rollbar、Bugsnag の例外をプッシュ通知で受け取れます。エラートラッカーの Webhook を Pocket Alert に向けるだけで、新しい問題を 1 秒以内にスマホでキャッチできます。

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

最終更新日:2026-08-11

Sentry、Rollbar、Bugsnag で新しい例外が検出されると、タイトルと重大度が 1 秒以内にスマホへ届きます。ユーザーが報告する前にエラーを検知しましょう。

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

1. **Webhook を作成** — GJSON の message テンプレートを使って Pocket Alert の Webhook を作成し、受信 URL をコピーします。
2. **エラー監視ツールを接続** — Sentry の Internal Integration（または Rollbar / Bugsnag の Webhook）に URL を貼り付け、アラートルールに追加します。
3. **マッピングして配信** — GJSON が data.event.title、culprit、level、web_url をプッシュ通知に割り当てます。次の例外が発生すると、スマホが振動します。

## スタックトレースからロック画面まで

エラー監視ツールはすでに 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 経由のアプリケーションのシークレットです。新しいエンドポイントが必要になったときはいつでも再発行できます。

## エラーアラートをスマホに送信

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

[Webhook](https://pocketalert.app/ja/webhooks) ページで、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](https://docs.sentry.io/organization/integrations/integration-platform/webhooks/issue-alerts/) で、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 設定のドキュメント](https://info.pocketalert.app/api/webhooks/settings.html)をご覧ください。

## よくある質問

### エラーアラートをスマホで受け取るには？

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 として配信されます。即時配信は変わりませんが、おやすみモードの無視はされません。
