从告警管理器直达你的口袋
你的监控早已知道数据库何时不健康。Pocket Alert 把这份信息送到你的手机上。
覆盖所有故障场景
连接被拒绝、复制延迟超过阈值、WAL 堆积、磁盘接近写满。监控系统运行的任何检查都可以触发推送。
兼容你现有的技术栈
Grafana、Prometheus Alertmanager、pgwatch、Datadog 和 Zabbix 会向你已配置好的 Webhook URL 发送 POST 请求。
严重级别直接显示在标题中
主库宕机和从库延迟警告会作为不同的告警到达。GJSON 映射可以把负载中的严重级别读取到标题里。
按数据库分频道
每个数据库拥有独立的应用,生产库、测试库和分析从库互不共用频道。
亚秒级送达
推送通常在一秒内送达,足够快,能在连接池耗尽前启动故障切换。
无需代理
数据库主机上无需安装任何软件。你现有的监控负责通信。
三步让数据库告警推送到你的手机
创建 Webhook 或密钥
为 cron 脚本创建 API 密钥,或创建一个 Webhook 并复制其接收 URL。
将监控指向它
将接收 URL 添加到 Grafana、Alertmanager 或 pgwatch 中,或在 cron 健康检查中用 curl 调用消息 API。
及时收到通知
检查失败时触发告警,你的手机会在一秒内震动。为主库和从库分别使用独立的 Webhook。
将数据库监控连接到你的手机
1. 从健康检查脚本直接发送 POST 请求
cron 脚本中的 pg_isready 检查,或慢查询、连接数查询,可以在 Token 请求头中带上你的 API 密钥,用 curl 调用消息 API:
#!/usr/bin/env bash
# /usr/local/bin/pg-health.sh (run from cron)
if ! pg_isready -h prod-db -p 5432 -q; then
curl -X POST "https://api.pocketalert.app/v1/messages" \
-H "Token: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"title":"Postgres down","message":"prod-db: connection refused on 5432","level":"critical"}'
fi
"level":"critical" 字段会让这条推送突破勿扰模式,因此主库凌晨 3 点宕机时,你确实能收到通知。关键告警页面介绍了各个级别的工作方式。
复制延迟或数据卷写满,也可以用同样的方式处理:
LAG=$(psql -tA -c "SELECT EXTRACT(EPOCH FROM (now() - pg_last_xact_replay_timestamp()))::int")
[ "$LAG" -gt 120 ] && curl -X POST "https://api.pocketalert.app/v1/messages" \
-H "Token: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d "{\"title\":\"Replication lag\",\"message\":\"replica-1 is ${LAG}s behind primary\"}"
2. 或为告警管理器创建 Webhook
创建一个带 GJSON message 模板的 Webhook,用来映射你的工具负载。Grafana、Alertmanager、pgwatch、Datadog 和 Zabbix 都会发送各自的 JSON:
curl -X POST "https://api.pocketalert.app/v1/webhooks" \
-H "Token: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"name":"Alertmanager","message":"%alerts.0.labels.alertname%: %alerts.0.annotations.summary%","application_id":"qm47b9pzxzxg"}'
将接收 URL https://p4a.me/wh/1234abcd 填入告警管理器的 Webhook 接收器。cron 检查也可以向同一个接收 URL 发送普通 JSON。
Webhook 设置文档介绍了 GJSON 字段映射和按应用路由。
常见问题解答
当检查触发时,让监控系统向 Pocket Alert 的 Webhook 发送 POST 请求即可。Grafana、Prometheus Alertmanager、pgwatch、Datadog 和 Zabbix 都支持出站 Webhook,cron 健康检查脚本也可以用 curl 请求同一个 URL。
Postgres、MySQL、Redis 和 MongoDB 均可使用。Pocket Alert 读取你的工具发送的 JSON,因此与数据库引擎无关。只要能触发 Webhook 或运行检查脚本,就能把通知送到你的手机。
为主库和从库分别设置 Webhook,或使用 GJSON 模板,把负载中的严重级别提取到标题里。这样,主库宕机和从库延迟警告一到达,就能立刻区分。
为每个数据库分配独立的应用和 Webhook URL。生产库、测试库和分析从库的告警会进入各自的频道,测试环境的噪声不会淹没真正的生产事故。
不需要。Pocket Alert 不会在数据库主机上运行任何代理。你现有的监控或健康检查脚本负责触发 Webhook,推送通常在一秒内送达。
可以。发送时带上 level=critical,或在 Webhook 上将 default_level 设为 critical,这样它接收的所有通知都会高优先级提醒。在 Android 上,授予勿扰模式权限后,critical 通知会进入专用频道,绕过勿扰模式,并可能占满屏幕;在 iPhone 上,它会以时效性通知的形式到达,并突破专注模式。免费套餐会将 critical 按 high 发送,仍然即时送达,只是不会绕过勿扰模式。