Grafana

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

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

1 秒未満でプッシュインストールするプラグインは不要Cloud & セルフホスト対応 更新
機能

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

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 ステップ

1

Webhook を作成

GJSON の message テンプレートを持つ Pocket Alert の Webhook を作成し、受信 URL をコピーします。

2

連絡先を接続

その URL を Grafana Alerting で Webhook の連絡先として追加し、通知ポリシーに紐付けます。

3

マッピングして送信

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 設定のドキュメントをご覧ください。

FAQ

よくある質問

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 の連絡先として追加してください。