# サーバーが落ちた サーバーダウンの瞬間 を、その場で。

> サーバーダウンをプッシュ通知で即座にお知らせ。Grafana、Prometheus、UptimeRobot を Webhook でつなぐだけで、1 秒足らずでスマホにアラートが届きます。

<!-- source: https://pocketalert.app/ja/use-cases/server-monitoring -->

最終更新日:2026-08-11

Pocket Alert は、サーバー監視のアラートを iPhone や Android のプッシュ通知に変換します。Grafana、Prometheus、UptimeRobot、または単純な cron のヘルスチェックを 1 つの Webhook URL につなぐだけで、サーバーにエージェントを入れず、メールの要約を探す手間もなく、アラートが 1 秒以内にスマホへ届きます。

## 最初のサーバーアラートまで 3 ステップ

1. **Pocket Alert をセットアップ** — pocketalert CLI をインストールして pocketalert auth YOUR_API_KEY を実行するか、転送用の Webhook を作成します。
2. **監視ツールを接続** — cron によるヘルスチェック、Netdata の custom_sender、または受信 URL を指定した Alertmanager の webhook_config を追加します。
3. **通知を受け取る** — テスト用のアラートを発火させると、少しあとにスマホが振動します。フィールドのマッピングで内容を細かく調整できます。

## メトリクスの急上昇から、スマホのプッシュ通知まで

監視ツールの Webhook URL を 1 つ指定するだけで、すべてのアラートが 1 秒以内にスマホへ届きます。

- **お使いのスタックにそのまま対応** — Grafana、Prometheus、UptimeRobot、Datadog、Zabbix は、Webhook を発火するとそのままスマホに届きます。
- **1 秒以内の配信** — プッシュ通知は 1 秒以内に届くため、ユーザーからの最初の問い合わせより先に気づけます。
- **フィールドのマッピング（GJSON）** — JSON ペイロードのフィールドをタイトルとメッセージに割り当てられます。アラート名と重大度は通知にそのまま反映されます。
- **スクリプトまたは Webhook** — cron によるヘルスチェックも、転送された Alertmanager のアラートも、同じ方法でスマホに届きます。
- **アプリごとのチャネル** — 本番、ステージング、ホームラボにそれぞれ専用のチャネルを用意できます。
- **エージェント不要** — Pocket Alert は監視ツールがすでに出力している Webhook を受け取るため、監視対象のマシンで追加のプロセスは動きません。

## 監視ツールを接続する

### 1. cron で bash のヘルスチェックを実行する

CLI をインストールして一度認証したあと、サービスに疎通確認を行い、応答がなければプッシュ通知を送ります。

```
sudo mv pocketalert /usr/local/bin/ && chmod +x /usr/local/bin/pocketalert
pocketalert auth YOUR_API_KEY
```

```
#!/usr/bin/env bash
URL=https://api.example.com/health
if ! curl -fsS --max-time 10 "$URL" >/dev/null; then
  pocketalert send -t "API DOWN on $(hostname)" -m "$URL did not respond"
fi
```

cron で 1 分ごとに実行します。

```
* * * * * /usr/local/bin/check-health.sh
```

### 2. または Netdata のアラームフックを使う

`custom_sender()` に `health_alarm_notify.conf` を追加し（編集は `sudo ./edit-config health_alarm_notify.conf` で行います）、Netdata のアラームがすべてメッセージ API に送信されるようにします。

```
custom_sender() {
  curl -X POST 'https://api.pocketalert.app/v1/messages' \
    -H 'Token: YOUR_API_KEY' \
    -H 'Content-Type: application/json' \
    -d "{\"title\":\"${name} is ${status} on ${host}\",\"message\":\"${chart}.${family}: ${value_string}\",\"level\":\"critical\"}"
}
```

### 3. または Webhook 経由で Alertmanager を転送する

[Webhook](https://pocketalert.app/ja/webhooks) ページで GJSON テンプレートを使って Webhook を作成し、その受信 URL を Prometheus Alertmanager の `webhook_config` に追加します。

```
curl -X POST 'https://api.pocketalert.app/v1/webhooks' \
  -H 'Token: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"name":"Alertmanager","application_id":"qm47b9pzxzxg","message":"%status%: %alerts.0.labels.alertname% — %alerts.0.annotations.summary%"}'
```

```
receivers:
  - name: pocketalert
    webhook_configs:
      - url: 'https://p4a.me/wh/1234abcd'
        send_resolved: true
```

GJSON のパスは[ドキュメント](https://info.pocketalert.app/api/webhooks/settings.html)に掲載しています。

## よくある質問

### サーバー監視アラートはどのように動作しますか？

Pocket Alert は、アプリケーションごとに受信用の Webhook URL を発行します。Grafana、Prometheus Alertmanager、UptimeRobot、Datadog、Zabbix などの監視ツールからこの URL に送るように設定すると、発火したアラートが 1 秒以内にスマホのプッシュ通知になります。

### アラートの内容をカスタマイズできますか？

はい。GJSON のパスで受信した JSON のフィールドを指定すると、通知のタイトルとメッセージを設定できます。Alertmanager のアラートは、名前、ステータス、重大度がそのまま保たれます。

### 対応している監視ツールは何ですか？

アラート発火時に HTTP リクエストを送れるツールなら、どれでも使えます。Grafana、Prometheus Alertmanager、UptimeRobot、Datadog、Zabbix、Netdata、Uptime Kuma、独自のヘルスチェックスクリプトなどです。

### アラート疲れを避けるにはどうすればよいですか？

サーバーが停止したときと復旧したときに、それぞれプッシュ通知を送れます。アプリケーションごとにチャネルを分けると、本番環境、ステージング環境、個人のインフラを区別でき、緊急のアラートがノイズの多い通知に埋もれません。

### サーバーにエージェントをインストールする必要はありますか？

エージェントのインストールは不要です。Pocket Alert は監視ツールがすでに送信している Webhook を受け取るため、監視対象のサーバーで追加のプロセスが動くことはありません。

### 夜間でもサーバー停止のアラートがおやすみモードを貫通しますか？

はい。level: critical を指定してアラートを送ると、Android ではおやすみモードを貫通し、iPhone では時間に敏感な通知として集中モードを突破します。復旧通知はデフォルトまたはサイレントのままにしておけば、障害そのものだけが通知音を鳴らします。レベルはサイレント (-2) から critical (2) まであり、API、Webhook のペイロード、Webhook ごとのデフォルト設定で指定できます。
