再也不错过失败的任务
导入失败时应立即通知你,早于你打开日志的几个小时。
crontab 中只需一行
在任意 cron 行后用 && 或 || 接上推送。只需一次 curl 调用,无需守护进程。
只在失败时告警
使用 ||,只有命令以非零状态码退出时才会触发告警。
包含错误信息
把 stderr 或退出码通过管道传入消息,推送到达时错误信息已经附在其中。
适用任何调度器
crontab、systemd 定时器、Laravel 调度器、Sidekiq 和 K8s CronJob 都可以使用,因为它们都能运行命令。
成功时发送心跳
每次成功运行后发送心跳。心跳停止到达时,你就知道任务已悄悄停止,可以着手排查。
任务结束即时送达
推送会在任务退出时送达,早于任何人查看日志的时间,可能早好几个小时。
cron 失败告警的三个步骤
获取 URL 或 CLI
复制应用的 Webhook URL,或安装 Pocket Alert CLI。
添加一行
在 cron 行后接上 curl 调用或 pocketalert send,失败用 ||,成功用 &&。
收到告警
运行任务。如果失败,你的手机会震动,显示你设置的标题和错误输出。
在 cron 任务中接入告警
安装并认证 CLI
sudo mv pocketalert /usr/local/bin/ && chmod +x /usr/local/bin/pocketalert
pocketalert auth YOUR_API_KEY
仅在任务失败时告警
使用 || 串联告警,使其只在退出码非零时触发:
0 3 * * * /usr/local/bin/mybackup.sh || pocketalert send \
-t "Cron failed: mybackup" -m "Exited non-zero at $(date)"
附带错误输出
0 3 * * * /usr/local/bin/mybackup.sh 2>/tmp/cron.err || pocketalert send \
-t "Cron failed: mybackup" -m "$(tail -n 3 /tmp/cron.err)"
成功时发送心跳
成功运行后用 && 添加一次心跳推送。心跳停止到达时,说明任务已悄悄停止:
0 3 * * * /usr/local/bin/mybackup.sh && pocketalert send "Cron OK: mybackup" "Finished cleanly"
没有 CLI?用 curl 调用 API
0 3 * * * /usr/local/bin/mybackup.sh || curl -X POST "https://api.pocketalert.app/v1/messages" \
-H "Token: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"title":"Cron failed: mybackup","message":"Exited non-zero","level":"high"}'
文档介绍了目标设置和各应用的渠道配置。
常见问题解答
在 shell 中把通知接在 cron 命令后面。`&&` 在成功运行后触发,`||` 在失败后触发,任务退出时 Pocket Alert 会发送推送通知。
使用 `||`,这样只有命令以非零状态码退出时才会触发告警:`mybackup.sh || curl ...`。出错的任务会通知你,其余的保持安静。
可以。捕获退出码或输出,放进消息正文即可。Pocket Alert CLI 可以把 stderr 直接通过管道传入通知。
可以,任何调度器都行:crontab、systemd 定时器、Laravel 调度器、Rails 或 Sidekiq 的 cron、Windows 任务计划程序、Kubernetes CronJob。只要能运行命令,就能在后面接上告警。
每次成功运行后用 `&&` 发送一次完成心跳。心跳一旦停止到达,你就知道任务已经不再运行,无需额外工具。
在失败告警中加上 level=critical,它会在 Android 上突破勿扰模式,在 iPhone 上穿透专注模式。心跳推送则使用 level=silent,它们会静音进入历史记录,记录有了,手机依旧安静。