アラートマネージャーからポケットへ
データベースの異常は、すでに監視ツールが検知しています。Pocket Alert はそれをスマホに届けます。
あらゆる障害パターンに対応
接続拒否、しきい値を超えたレプリケーション遅延、WAL の蓄積、ディスクの逼迫。監視ツールが実行するチェックはどれでもプッシュ通知を送信できます。
既存のスタックにそのまま連携
Grafana、Prometheus Alertmanager、pgwatch、Datadog、Zabbix は、他のアラートにすでに設定している Webhook URL に POST します。
タイトルで重大度がわかる
プライマリの停止とレプリカ遅延の警告は、別々のアラートとして届きます。GJSON マッピングにより、ペイロードの重大度をタイトルに反映できます。
データベースごとのチャンネル
データベースごとに別のアプリケーションを作成できるため、本番、ステージング、分析用レプリカが同じチャンネルを共有することはありません。
1 秒以内の配信
プッシュ通知は 1 秒以内に届くため、コネクションプールが枯渇する前にフェイルオーバーを開始できます。
エージェント不要
DB ホストにインストールするものはありません。すでに運用している監視ツールがそのまま通知を送ります。
データベースのアラートをスマホで受け取る 3 ステップ
Webhook またはキーを作成
cron スクリプト用に API キーを作成するか、Webhook を作成して受信用 URL をコピーします。
監視ツールの送信先に設定
受信用 URL を Grafana、Alertmanager、pgwatch に追加するか、cron のヘルスチェックから messages API に curl で送信します。
通知を受け取る
チェックが失敗するとアラートが送信され、1 秒以内にスマホが振動します。プライマリとレプリカには別々の Webhook を使ってください。
データベース監視をスマホに接続する
1. ヘルスチェックスクリプトから直接 POST
cron スクリプト内の pg_isready チェックや、スロークエリ・接続数のクエリから、Token ヘッダーに API キーを指定して messages API に curl で送信できます:
#!/usr/bin/env bash
# /usr/local/bin/pg-health.sh (run from cron)
if ! pg_isready -h prod-db -p 5432 -q; then
curl -X POST "https://api.pocketalert.app/v1/messages" \
-H "Token: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"title":"Postgres down","message":"prod-db: connection refused on 5432","level":"critical"}'
fi
"level":"critical" を指定すると、このプッシュ通知はおやすみモードを突破します。そのため、午前 3 時にプライマリが停止しても確実に気づけます。レベルの仕組みについては、重要なアラートのページをご覧ください。
LAG=$(psql -tA -c "SELECT EXTRACT(EPOCH FROM (now() - pg_last_xact_replay_timestamp()))::int")
[ "$LAG" -gt 120 ] && curl -X POST "https://api.pocketalert.app/v1/messages" \
-H "Token: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d "{\"title\":\"Replication lag\",\"message\":\"replica-1 is ${LAG}s behind primary\"}"
2. またはアラートマネージャー用の Webhook を作成
監視ツールのペイロードをマッピングする GJSON の message テンプレートを使って Webhook を作成します。Grafana、Alertmanager、pgwatch、Datadog、Zabbix は、それぞれ独自の JSON を POST します:
curl -X POST "https://api.pocketalert.app/v1/webhooks" \
-H "Token: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"name":"Alertmanager","message":"%alerts.0.labels.alertname%: %alerts.0.annotations.summary%","application_id":"qm47b9pzxzxg"}'
受信用 URL https://p4a.me/wh/1234abcd を、Alertmanager の Webhook レシーバーに設定してください。cron のチェックからも、同じ受信用 URL にプレーンな JSON を POST できます。
Webhook 設定のドキュメントでは、GJSON のフィールドマッピングとアプリケーションごとのルーティングを解説しています。
よくある質問
チェックが失敗したときに、監視スタックから Pocket Alert の Webhook URL へ POST するように設定してください。Grafana、Prometheus Alertmanager、pgwatch、Datadog、Zabbix はいずれも送信 Webhook に対応しています。cron のヘルスチェックスクリプトからも、同じ URL に curl で送信できます。
Postgres、MySQL、Redis、MongoDB のいずれにも対応しています。Pocket Alert は監視ツールが送信する JSON を読み取るため、データベースの種類は関係ありません。Webhook の送信やチェックスクリプトの実行ができれば、スマホに通知を届けられます。
プライマリとレプリカにそれぞれ別の Webhook を設定するか、ペイロードから重大度を取り出してタイトルに入れる GJSON テンプレートを使ってください。そうすれば、プライマリの障害とレプリカ遅延の警告は、届いた時点で違いがわかります。
データベースごとに別のアプリケーションと Webhook URL を用意してください。本番、ステージング、分析用レプリカの通知はそれぞれ別のチャンネルに届くため、ステージング環境の大量の通知で本番の重大な障害が埋もれることはありません。
いいえ。Pocket Alert はデータベースのホストにエージェントをインストールしません。既存の監視ツールやヘルスチェックスクリプトが Webhook を送信すれば十分で、通知は 1 秒以内に届きます。
はい。level=critical を付けて送信するか、Webhook の default_level を critical に設定すると、受信するすべての通知が強調されます。Android では、おやすみモードへのアクセスを許可すると、critical 通知は専用チャンネルからおやすみモードを無視して届き、画面を占有することもあります。iPhone では、集中モードを突破する時間回避型の通知として届きます。無料プランでは critical は high として届きます。即時に届きますが、おやすみモードは無視されません。
ユーザーより先に障害に気づけます。
DB の監視ツールから Pocket Alert の Webhook に送信するように設定すれば、ダッシュボードを何度も確認する必要がなくなります。