# データベースが 応答しなくなったときに すぐに気づく。

> データベースの障害をプッシュ通知でお知らせ。Postgres、MySQL、Redis の接続断、レプリケーションの遅延、ディスクの空き容量不足を 1 秒未満でスマホに届けます。

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

最終更新日:2026-08-11

ヘルスチェックの失敗、遅れているレプリカ、満杯に近づくディスク。監視ツールが Pocket Alert に Webhook を送信すると、1 秒以内にスマホへ通知が届きます。Postgres、MySQL、Redis、MongoDB に対応し、データベースのホストにエージェントをインストールする必要はありません。

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

1. **Webhook またはキーを作成** — cron スクリプト用に API キーを作成するか、Webhook を作成して受信用 URL をコピーします。
2. **監視ツールの送信先に設定** — 受信用 URL を Grafana、Alertmanager、pgwatch に追加するか、cron のヘルスチェックから messages API に curl で送信します。
3. **通知を受け取る** — チェックが失敗するとアラートが送信され、1 秒以内にスマホが振動します。プライマリとレプリカには別々の Webhook を使ってください。

## アラートマネージャーからポケットへ

データベースの異常は、すでに監視ツールが検知しています。Pocket Alert はそれをスマホに届けます。

- **あらゆる障害パターンに対応** — 接続拒否、しきい値を超えたレプリケーション遅延、WAL の蓄積、ディスクの逼迫。監視ツールが実行するチェックはどれでもプッシュ通知を送信できます。
- **既存のスタックにそのまま連携** — Grafana、Prometheus Alertmanager、pgwatch、Datadog、Zabbix は、他のアラートにすでに設定している Webhook URL に POST します。
- **タイトルで重大度がわかる** — プライマリの停止とレプリカ遅延の警告は、別々のアラートとして届きます。GJSON マッピングにより、ペイロードの重大度をタイトルに反映できます。
- **データベースごとのチャンネル** — データベースごとに別のアプリケーションを作成できるため、本番、ステージング、分析用レプリカが同じチャンネルを共有することはありません。
- **1 秒以内の配信** — プッシュ通知は 1 秒以内に届くため、コネクションプールが枯渇する前にフェイルオーバーを開始できます。
- **エージェント不要** — DB ホストにインストールするものはありません。すでに運用している監視ツールがそのまま通知を送ります。

## データベース監視をスマホに接続する

### 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 時にプライマリが停止しても確実に気づけます。レベルの仕組みについては、[重要なアラート](https://pocketalert.app/ja/use-cases/critical-alerts)のページをご覧ください。

```
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 設定のドキュメント](https://info.pocketalert.app/api/webhooks/settings.html)では、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 として届きます。即時に届きますが、おやすみモードは無視されません。
