ログ行から、ロック画面まで
ログパイプラインは、問題のある行をすでに見つけています。Pocket Alert がそれをスマホまで届けます。
既存のスタックと連携
Loki ruler、Elastic Watcher、Graylog、tail | grep スクリプトのいずれも、ひとつの Webhook に送信できます。
パターン一致によるアラート
LogQL ルール、Watcher の条件、grep パターンのいずれかが、プッシュ通知を送るタイミングを決めます。
フィールドマッピング
GJSON パスで、アラート JSON からアラート名、一致した行、ヒット件数をそのまま取り出せます。
CLI または Webhook
tail | grep スクリプトから、監視プラットフォームを使わずに、メッセージ API へ直接 curl できます。
アプリケーションごとのチャンネル
サービスや環境ごとに 1 つの Pocket Alert アプリケーションを使うと、本番とステージングのログを別々のチャンネルで管理できます。
1 秒未満の配信
Webhook が発火すると、1 秒未満でプッシュ通知が届きます。OOMKilled の Pod をリアルタイムで捉えられる速さです。
ログ行からプッシュ通知まで、3 ステップ
パターンを定義する
行が一致したときに発火する Loki ruler のルール、Elastic Watcher、または grep パターンを追加します。
接続する
tail | grep スクリプトからメッセージ API を curl するか、GJSON テンプレートを使って Alertmanager を Pocket Alert の Webhook 受信 URL に向けます。
チャンネルを分ける
サービスや環境ごとに個別のアプリケーションを作成し、本番とステージングのログを別々のチャンネルに保ちます。
ログパターンが一致したときにプッシュ通知を送る
1. tail | grep スクリプトから直接 curl(CLI)
CLI をインストールして一度認証し、ログを tail しながら一致する行をすべてプッシュ通知で送信します。
sudo mv pocketalert /usr/local/bin/ && chmod +x /usr/local/bin/pocketalert
pocketalert auth YOUR_API_KEY
tail -Fn0 /var/log/app.log | grep --line-buffered "OutOfMemory" | while read -r line; do
pocketalert send -t "OOM on $(hostname)" -m "$line"
done
CLI を使わず、メッセージ API に直接 POST することもできます。
tail -Fn0 /var/log/app.log | grep --line-buffered "ERROR" | while read -r line; do
curl -X POST 'https://api.pocketalert.app/v1/messages' \
-H 'Token: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d "{\"title\":\"Log error\",\"level\":\"critical\",\"message\":\"${line//\"/\\\"}\"}"
done
2. または Loki / Alertmanager を Webhook 経由で転送
Loki ruler で、一致数がしきい値を超えたときに発火する LogQL アラートルールを定義します。
groups:
- name: app-errors
rules:
- alert: HighErrorRate
expr: sum(count_over_time({app="api"} |= "ERROR" [5m])) > 20
for: 1m
labels:
severity: critical
annotations:
summary: "{{ $value }} ERROR lines in the last 5m"
ruler は Alertmanager(alertmanager_url)にルーティングし、そこから Pocket Alert に転送されます。Webhooks ページで、Alertmanager のペイロードをマッピングする GJSON テンプレート付きの Webhook を作成し、webhook_config の送信先を受信 URL に設定します。
curl -X POST 'https://api.pocketalert.app/v1/webhooks' \
-H 'Token: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{"name":"Loki Alerts","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
Elastic Watcher の webhook アクションや Graylog の HTTP 通知イベント定義からも、同じ受信 URL に POST できます。GJSON マッピングとアプリケーションごとのルーティングについては、ドキュメントをご覧ください。
よくある質問
Loki ruler のアラート、Elastic Watcher、または Graylog のイベント定義を設定し、Pocket Alert アプリケーションの URL に Webhook を発火させます。一致したログ行と件数は JSON ボディに含まれて届きます。
サーバーに追加で何かを動かす必要はありません。Pocket Alert は既存のパイプラインの末端に入るだけです。Loki、Elastic、Graylog、cron の tail スクリプトがマッチングを行い、結果を送信するだけです。
GJSON のフィールドマッピングで、アラートペイロード内の任意のパスを読み取れます。たとえば %alerts.0.labels.alertname% をタイトルに、%alerts.0.annotations.summary% をメッセージに入れるといった設定ができます。
サービスや環境ごとに個別の Pocket Alert アプリケーションを作成すると、本番の 500 エラーの急増は、ステージングの軽微なパーサー警告とは別のチャンネルに届きます。静かなフィードも、すぐに気づくべきフィードとは分けておけます。
サービスや環境ごとに個別の Pocket Alert アプリケーションを作成してください。そうすれば、本番の認証失敗とステージングのジョブログが、ひとつのノイジーなフィードにまとめられず、別々のチャンネルに届きます。
はい。POST に "level":"critical" を追加すると、Android では専用の通知チャンネルで配信され、おやすみモードを通過します。おやすみモードへのアクセスは一度許可するだけで済みます。iPhone では high と critical が、集中モードを突破する時間重視の通知として届きます。また Webhook に default_level を設定すると、そのパイプラインのすべてのアラートを同じ優先度で届けられます。頻繁に届くフィードは level を silent にすれば、音もバイブレーションもなく、履歴には残ります。無料プランでは critical は high として配信されます。すぐに届きますが、おやすみモードは通過しません。