メトリクスの急上昇から、スマホのプッシュ通知まで
監視ツールの Webhook URL を 1 つ指定するだけで、すべてのアラートが 1 秒以内にスマホへ届きます。
お使いのスタックにそのまま対応
Grafana、Prometheus、UptimeRobot、Datadog、Zabbix は、Webhook を発火するとそのままスマホに届きます。
1 秒以内の配信
プッシュ通知は 1 秒以内に届くため、ユーザーからの最初の問い合わせより先に気づけます。
フィールドのマッピング(GJSON)
JSON ペイロードのフィールドをタイトルとメッセージに割り当てられます。アラート名と重大度は通知にそのまま反映されます。
スクリプトまたは Webhook
cron によるヘルスチェックも、転送された Alertmanager のアラートも、同じ方法でスマホに届きます。
アプリごとのチャネル
本番、ステージング、ホームラボにそれぞれ専用のチャネルを用意できます。
エージェント不要
Pocket Alert は監視ツールがすでに出力している Webhook を受け取るため、監視対象のマシンで追加のプロセスは動きません。
最初のサーバーアラートまで 3 ステップ
Pocket Alert をセットアップ
pocketalert CLI をインストールして pocketalert auth YOUR_API_KEY を実行するか、転送用の Webhook を作成します。
監視ツールを接続
cron によるヘルスチェック、Netdata の custom_sender、または受信 URL を指定した Alertmanager の webhook_config を追加します。
通知を受け取る
テスト用のアラートを発火させると、少しあとにスマホが振動します。フィールドのマッピングで内容を細かく調整できます。
監視ツールを接続する
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 ページで 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 のパスはドキュメントに掲載しています。
よくある質問
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 ごとのデフォルト設定で指定できます。