# Grafana のアラートを スマホに届けます 。

> Grafana のアラートをプッシュ通知で受け取れます。Pocket Alert を Webhook のコンタクトポイントとして追加すれば、発火したアラートルールを 1 秒足らずでスマホに通知します。

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

最終更新日:2026-08-11

Grafana のアラートルールが発火すると、アラート名、重要度、ステータスが 1 秒未満でスマホに届きます。ダッシュボードを開いたままにしなくても、問題がダッシュボードが赤くなる前にわかります。

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

1. **Webhook を作成** — GJSON の message テンプレートを持つ Pocket Alert の Webhook を作成し、受信 URL をコピーします。
2. **連絡先を接続** — その URL を Grafana Alerting で Webhook の連絡先として追加し、通知ポリシーに紐付けます。
3. **マッピングして送信** — GJSON が status、alertname、severity、summary をプッシュ通知に変換します。次に発火したアラートでスマホが振動します。

## 発火したパネルからロック画面まで

Grafana はアラートルールが発火すると、すでに Webhook を送信しています。Pocket Alert はそれを見逃せないプッシュ通知に変えます。

- **標準の連絡先** — Grafana の Alerting で Pocket Alert を Webhook の連絡先として追加します。プラグインもエージェントも不要で、Cloud でもセルフホストでも動作します。
- **GJSON でフィールドをマッピング** — GJSON パスを使うと、alertname、status、summary アノテーションを Grafana のペイロードから直接取り出して通知に含められます。
- **重要度とステータスをインライン表示** — 重要度ラベルと firing/resolved のステータスをプッシュ通知内に表示します。重大なアラートと解決の通知を見分けられます。
- **チームごとのチャンネル** — アプリケーションごとに固有の Webhook URL があるため、インフラ、アプリ、チームごとのアラートを別々のチャンネルに保てます。
- **1 秒未満での配信** — 発火したアラートは 1 秒未満でスマホに届くため、誰かがダッシュボードを開くより先に気づけます。
- **秘密の Webhook URL** — Webhook URL は HTTPS 上のアプリケーションの秘密情報です。新しいエンドポイントが必要なときはいつでもローテーションできます。

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

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

[Webhooks](https://pocketalert.app/ja/webhooks) ページで、Grafana のペイロードを読み取る GJSON の `message` テンプレートを持つ Webhook を作成します。Grafana は `status`、`commonLabels` ブロック、`alerts` 配列を送信するため、テンプレートは次のようになります:

```
curl -X POST "https://api.pocketalert.app/v1/webhooks" \
  -H "Token: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Grafana","default_level":"critical","message":"[%status%] %commonLabels.alertname% (%commonLabels.severity%)\n%alerts.0.annotations.summary%","application_id":"qm47b9pzxzxg"}'
```

次のような受信 URL が発行されます: `https://p4a.me/wh/1234abcd`。

### 2. Webhook の連絡先として追加

Grafana で [Alerting → Contact points → Add contact point](https://grafana.com/docs/grafana/latest/alerting/configure-notifications/manage-contact-points/integrations/webhook-notifier/) に進み、Webhook の連携を選択して受信 URL を貼り付けます:

```
Integration: Webhook
URL:    https://p4a.me/wh/1234abcd
Method: POST
```

連絡先を通知ポリシーに紐付けると、該当するアラートがそこにルーティングされます。Grafana は標準の JSON を送信し、上記の GJSON パスが `status`、`commonLabels.alertname`、`commonLabels.severity`、`alerts.0.annotations.summary` を取り出してプッシュ通知に含めます。

### 3. テスト送信

連絡先の Test ボタンを使用します。発火したアラートは `[firing] HighCPU (critical)` として届き、解消されると `status` が `resolved` に変わります。

すべての GJSON パスと Webhook のオプションについては、[Webhook 設定のドキュメント](https://info.pocketalert.app/api/webhooks/settings.html)をご覧ください。

## よくある質問

### Grafana のアラートをスマホに送るにはどうすればよいですか？

Grafana で「Alerting → Contact points」に進み、Webhook の連絡先を追加して Pocket Alert のアプリケーション URL を貼り付けてください。通知ポリシーに紐付ければ、次に発火したアラートが 1 秒未満でスマホに届きます。

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

Grafana は status、commonLabels ブロック、alerts 配列を含む JSON ペイロードを送信します。Pocket Alert は GJSON パスでこれを読み取るため、commonLabels.alertname をタイトルに、alerts.0.annotations.summary を本文に、status を firing または resolved の表示にマッピングします。

### 重要度とステータスを表示できますか？

はい。ペイロードには commonLabels.severity に severity ラベルが、status に firing または resolved の値が含まれます。両方を GJSON のメッセージテンプレートで参照すると、重大な発火アラートと解決済みのアラートで表示を変えられます。

### チームごとにアラートを分けられますか？

Grafana のフォルダーやチームごとにアプリケーションを作成してください。インフラのアラートとアプリのアラートを別々のチャンネルに分けられ、片方を他方に影響させずにミュートできます。

### プラグインは必要ですか？

特別な設定は不要です。Pocket Alert は Grafana のアラートエンジンがすでに送信している Webhook を受け取るため、プラグインやエージェントのインストールは必要ありません。Grafana Cloud にもセルフホストの Grafana にも対応しています。

### アラートの重要度を通知の優先度にマッピングできますか？

はい。すべてのメッセージには level を指定できます（silent、low、default、high、critical）。ペイロードに "level" フィールドを含めるか、Webhook に default_level を設定すると、そこにルーティングされたすべての通知がその優先度で届きます。ペイロード内の明示的な level が優先されます。発火時は critical、解決時は silent に設定するのがおすすめです。発火したアラートはおやすみモードを突破し、解決の通知は履歴に静かに残ります。無効な値は拒否されず default にフォールバックします。
