日志监控

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

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

推送延迟 <1sLoki · ELK · Graylog无需额外代理更新于
功能

从日志行到锁屏

你的日志管道已经能找出问题行,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

定义匹配模式

添加一条 Loki ruler 规则、Elastic Watcher 或 grep 模式,在有日志行匹配时触发。

2

完成对接

从 tail | grep 脚本调用消息 API 的 curl,或将 Alertmanager 指向带 GJSON 模板的 Pocket Alert Webhook 接收 URL。

3

拆分频道

为每个服务或环境分别创建一个应用,让生产和测试环境的日志保持在不同频道。

日志模式匹配时发送推送

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 发送:即时送达,但无法绕过勿扰模式。

关键的那行错误日志,装进你的口袋。

将日志管道指向一个 Webhook,下一次错误激增就能直接推送到你的手机。