从指标飙升到你的手机
将监控指向一个 Webhook URL,每条告警都会在一秒内送达你的手机。
兼容你现有的技术栈
Grafana、Prometheus、UptimeRobot、Datadog 和 Zabbix 一旦触发 Webhook,就能送达你的手机。
亚秒级送达
推送在一秒内到达,比第一个用户投诉还快。
字段映射(GJSON)
将 JSON 负载字段映射到标题和内容。告警名称和严重级别会一并体现在通知中。
脚本或 Webhook
无论是 cron 健康检查,还是转发过来的 Alertmanager 告警,都以相同的方式送达你的手机。
按应用划分通道
为 prod、staging 和 homelab 分别设置独立的通道。
无需代理
Pocket Alert 直接接收你的监控系统已经发出的 Webhook,被监控的机器无需运行任何额外程序。
三步收到你的第一条服务器告警
设置 Pocket Alert
安装 pocketalert CLI 并运行 pocketalert auth YOUR_API_KEY,或创建一个用于转发的 Webhook。
接入监控
添加 cron 健康检查、Netdata custom_sender,或将 Alertmanager 的 webhook_config 指向接收 URL。
接收告警
触发一条测试告警,稍后你的手机就会震动。通过字段映射微调通知内容。
配置你的监控
1. 通过 cron 运行的 bash 健康检查
安装 CLI,登录一次,然后请求服务。如果服务没有响应,就发送推送。
sudo mv pocketalert /usr/local/bin/ && chmod +x /usr/local/bin/pocketalert
pocketalert auth YOUR_API_KEY
#!/usr/bin/env bash
URL=https://api.example.com/health
if ! curl -fsS --max-time 10 "$URL" >/dev/null; then
pocketalert send -t "API DOWN on $(hostname)" -m "$URL did not respond"
fi
通过 cron 每分钟运行一次。
* * * * * /usr/local/bin/check-health.sh
2. 或使用 Netdata 告警钩子
在 custom_sender() 中添加 health_alarm_notify.conf(通过 sudo ./edit-config health_alarm_notify.conf 编辑),让每条 Netdata 告警都发送到消息 API。
custom_sender() {
curl -X POST 'https://api.pocketalert.app/v1/messages' \
-H 'Token: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d "{\"title\":\"${name} is ${status} on ${host}\",\"message\":\"${chart}.${family}: ${value_string}\",\"level\":\"critical\"}"
}
3. 或通过 Webhook 转发 Alertmanager
在 Webhook 页面创建一个带 GJSON 模板的 Webhook,然后将接收 URL 添加到 Prometheus Alertmanager 的 webhook_config 中。
curl -X POST 'https://api.pocketalert.app/v1/webhooks' \
-H 'Token: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{"name":"Alertmanager","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
GJSON 路径列在文档中。
常见问题解答
Pocket Alert 为每个应用提供一个接收 Webhook 的 URL。把 Grafana、Prometheus Alertmanager、UptimeRobot、Datadog 或 Zabbix 等监控工具指向这个 URL,它触发的告警会在一秒内变成你手机上的推送通知。
可以。用 GJSON 路径映射传入 JSON 中的字段,即可设置通知的标题和内容。Alertmanager 告警的名称、状态和严重级别会完整保留。
只要工具会在告警时发出 HTTP 请求就可以使用,包括 Grafana、Prometheus Alertmanager、UptimeRobot、Datadog、Zabbix、Netdata、Uptime Kuma,以及自定义的健康检查脚本。
服务器宕机时发一条推送,恢复时再发一条。按应用划分的通道可以把 prod、staging 和个人基础设施分开,让紧急告警不被大量普通消息淹没。
无需安装任何代理。Pocket Alert 接收你的监控系统本来就会发出的 Webhook,被监控的服务器上不需要额外运行任何程序。
可以。发送告警时设置 level: critical,Android 上它会绕过勿扰模式,iPhone 上则会以时效性通知的形式穿透专注模式。恢复消息保持默认或静默,这样只有故障本身会发出提醒。级别从静默(-2)到关键(2),可在 API、Webhook 负载中使用,也可以作为每个 Webhook 的默认设置。