発火したパネルからロック画面まで
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 のアラートを受け取る 3 ステップ
Webhook を作成
GJSON の message テンプレートを持つ Pocket Alert の Webhook を作成し、受信 URL をコピーします。
連絡先を接続
その URL を Grafana Alerting で Webhook の連絡先として追加し、通知ポリシーに紐付けます。
マッピングして送信
GJSON が status、alertname、severity、summary をプッシュ通知に変換します。次に発火したアラートでスマホが振動します。
Grafana のアラートをスマホに送る
1. Pocket Alert の Webhook を作成
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 に進み、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 設定のドキュメントをご覧ください。
よくある質問
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 にフォールバックします。
ダッシュボードが赤くなる前に、アラートをスマホで確認。
アプリケーションを作成し、その Webhook URL をコピーして Grafana の連絡先として追加してください。