从日志行到锁屏
你的日志管道已经能找出问题行,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。
从日志行到推送,三步完成
定义匹配模式
添加一条 Loki ruler 规则、Elastic Watcher 或 grep 模式,在有日志行匹配时触发。
完成对接
从 tail | grep 脚本调用消息 API 的 curl,或将 Alertmanager 指向带 GJSON 模板的 Pocket Alert Webhook 接收 URL。
拆分频道
为每个服务或环境分别创建一个应用,让生产和测试环境的日志保持在不同频道。
日志模式匹配时发送推送
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 页面创建一个 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。文档涵盖了 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%。
为每个服务或环境分别创建一个 Pocket Alert 应用,这样生产环境大量的 500 错误会进入与测试环境偶发解析警告不同的频道。不重要的信息流与需要唤醒你的信息流分开。
为每个服务或环境分别创建一个 Pocket Alert 应用。这样生产环境的认证失败和测试环境的任务日志会进入不同的频道,而不是混在一个嘈杂的信息流里。
可以。在 POST 中添加 "level":"critical",Android 会通过专用通知频道发送,并绕过勿扰模式,你只需授予一次勿扰权限。在 iPhone 上,high 和 critical 级别会以时效性通知的形式送达,可以突破专注模式。你还可以在 Webhook 上设置 default_level,让该管道的每条告警都以相同优先级送达;对于信息量大的信息流,可将级别设为 silent,即无声音、无振动,但仍会保留在历史记录中。免费套餐会将 critical 作为 high 发送:即时送达,但无法绕过勿扰模式。