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

> ログがパターンに一致したらプッシュ通知でお知らせ。Loki、ELK スタック、Graylog を Pocket Alert の Webhook につなぐだけで、一致したエラー行が 1 秒でスマホに届きます。

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

最終更新日:2026-08-11

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

## ログ行からプッシュ通知まで、3 ステップ

1. **パターンを定義する** — 行が一致したときに発火する Loki ruler のルール、Elastic Watcher、または grep パターンを追加します。
2. **接続する** — tail | grep スクリプトからメッセージ API を curl するか、GJSON テンプレートを使って Alertmanager を Pocket Alert の Webhook 受信 URL に向けます。
3. **チャンネルを分ける** — サービスや環境ごとに個別のアプリケーションを作成し、本番とステージングのログを別々のチャンネルに保ちます。

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

ログパイプラインは、問題のある行をすでに見つけています。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 をリアルタイムで捉えられる速さです。

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

### 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](https://pocketalert.app/ja/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 マッピングとアプリケーションごとのルーティングについては、[ドキュメント](https://info.pocketalert.app/api/webhooks/settings.html)をご覧ください。

## よくある質問

### ログパターンが一致したときにプッシュ通知を受け取るには？

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% をメッセージに入れるといった設定ができます。

### 500 エラーの急増を、軽微な警告と分けておくことはできますか？

サービスや環境ごとに個別の Pocket Alert アプリケーションを作成すると、本番の 500 エラーの急増は、ステージングの軽微なパーサー警告とは別のチャンネルに届きます。静かなフィードも、すぐに気づくべきフィードとは分けておけます。

### サービスや環境ごとに分けるにはどうすればよいですか？

サービスや環境ごとに個別の Pocket Alert アプリケーションを作成してください。そうすれば、本番の認証失敗とステージングのジョブログが、ひとつのノイジーなフィードにまとめられず、別々のチャンネルに届きます。

### 夜間でもエラー急増をおやすみモードの中で通知させることはできますか？

はい。POST に "level":"critical" を追加すると、Android では専用の通知チャンネルで配信され、おやすみモードを通過します。おやすみモードへのアクセスは一度許可するだけで済みます。iPhone では high と critical が、集中モードを突破する時間重視の通知として届きます。また Webhook に default_level を設定すると、そのパイプラインのすべてのアラートを同じ優先度で届けられます。頻繁に届くフィードは level を silent にすれば、音もバイブレーションもなく、履歴には残ります。無料プランでは critical は high として配信されます。すぐに届きますが、おやすみモードは通過しません。
