ログ監視

ログ内の 一致したログ行をスマホへプッシュ通知。

Loki、ELK スタック、Graylog、tail | grep スクリプトは、すでにエラー急増やログイン失敗の連続を検知しています。一致したログ行は 1 秒未満でスマホに届くので、重要なログはいつでもポケットの中にあります。

1 秒未満で配信Loki · ELK · Graylog追加のエージェントは不要 更新
機能

ログ行から、ロック画面まで

ログパイプラインは、問題のある行をすでに見つけています。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 ステップ

1

パターンを定義する

行が一致したときに発火する Loki ruler のルール、Elastic Watcher、または grep パターンを追加します。

2

接続する

tail | grep スクリプトからメッセージ API を curl するか、GJSON テンプレートを使って Alertmanager を Pocket Alert の Webhook 受信 URL に向けます。

3

チャンネルを分ける

サービスや環境ごとに個別のアプリケーションを作成し、本番とステージングのログを別々のチャンネルに保ちます。

ログパターンが一致したときにプッシュ通知を送る

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 マッピングとアプリケーションごとのルーティングについては、ドキュメントをご覧ください。

FAQ

よくある質問

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 として配信されます。すぐに届きますが、おやすみモードは通過しません。

重要なエラー行を、ポケットの中に。

ログパイプラインの送信先を Webhook に設定すれば、次のエラー急増をスマホで受け取れます。