# 推送 匹配的日志行 到你的手机。

> 日志匹配到特定模式时，立即收到推送通知。将 Loki、ELK stack 或 Graylog 接入 Pocket Alert 的 Webhook，匹配到的错误日志会在一秒内送达你的手机。

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

最后更新：2026-08-11

Loki、ELK 技术栈、Graylog 或 tail | grep 脚本已经能发现错误激增和登录失败的爆发。匹配的日志行会在一秒内到达你的手机，让关键的日志条目随身可见。

## 从日志行到推送，三步完成

1. **定义匹配模式** — 添加一条 Loki ruler 规则、Elastic Watcher 或 grep 模式，在有日志行匹配时触发。
2. **完成对接** — 从 tail | grep 脚本调用消息 API 的 curl，或将 Alertmanager 指向带 GJSON 模板的 Pocket Alert Webhook 接收 URL。
3. **拆分频道** — 为每个服务或环境分别创建一个应用，让生产和测试环境的日志保持在不同频道。

## 从日志行到锁屏

你的日志管道已经能找出问题行，Pocket Alert 负责把它们送到你的手机。

- **兼容你的技术栈** — Loki ruler、Elastic Watcher、Graylog 或 tail | grep 脚本都可以发送到同一个 Webhook。
- **基于模式匹配的告警** — LogQL 规则、Watcher 条件或 grep 模式决定何时发送推送。
- **字段映射** — GJSON 路径可以直接从告警 JSON 中提取告警名称、匹配的行和命中次数。
- **CLI 或 Webhook** — tail | grep 脚本可以直接用 curl 调用消息 API，无需任何监控平台。
- **按应用划分频道** — 每个服务或环境对应一个 Pocket Alert 应用，让生产和测试环境的日志分开显示。
- **亚秒级送达** — Webhook 触发后，推送在一秒内送达，足以实时捕捉 OOMKilled 的 Pod。

## 日志模式匹配时发送推送

### 1. 从 tail | grep 脚本直接调用 curl（CLI）

安装 CLI，登录一次，然后监听日志并推送每一条匹配的行。

```
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
```

也可以直接 POST 到消息 API，而不使用 CLI。

```
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. 或通过 Webhook 转发 Loki / Alertmanager

在 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/zh/webhooks) 页面创建一个 Webhook，并配置 GJSON 模板来映射 Alertmanager 的 payload，然后将 `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 Notification 事件定义，同样可以 POST 到该接收 URL。[文档](https://info.pocketalert.app/api/webhooks/settings.html)涵盖了 GJSON 映射和按应用路由。

## 常见问题

### 如何在日志模式匹配时收到推送？

设置一个 Loki ruler 告警、Elastic Watcher 或 Graylog 事件定义，让它触发 Webhook 并指向你的 Pocket Alert 应用 URL。匹配的日志行和计数会通过 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，让该管道的每条告警都以相同优先级送达；对于信息量大的信息流，可将级别设为 silent，即无声音、无振动，但仍会保留在历史记录中。免费套餐会将 critical 作为 high 发送：即时送达，但无法绕过勿扰模式。
