Cron 与定时任务

第一时间 cron 任务失败的那一刻。

Pocket Alert 会在 cron 任务失败的瞬间,向你的手机发送推送通知。在任意定时命令后用 && 或 || 接上一行代码:可在失败、成功时触发,或两者兼有,推送会在任务退出时到达,并附带错误输出。

在 退出码时触发单行命令 · 无需守护进程cron · systemd · K8s更新于
功能

再也不错过失败的任务

导入失败时应立即通知你,早于你打开日志的几个小时。

crontab 中只需一行

在任意 cron 行后用 && 或 || 接上推送。只需一次 curl 调用,无需守护进程。

只在失败时告警

使用 ||,只有命令以非零状态码退出时才会触发告警。

包含错误信息

把 stderr 或退出码通过管道传入消息,推送到达时错误信息已经附在其中。

适用任何调度器

crontab、systemd 定时器、Laravel 调度器、Sidekiq 和 K8s CronJob 都可以使用,因为它们都能运行命令。

成功时发送心跳

每次成功运行后发送心跳。心跳停止到达时,你就知道任务已悄悄停止,可以着手排查。

任务结束即时送达

推送会在任务退出时送达,早于任何人查看日志的时间,可能早好几个小时。

快速开始

cron 失败告警的三个步骤

1

获取 URL 或 CLI

复制应用的 Webhook URL,或安装 Pocket Alert CLI。

2

添加一行

在 cron 行后接上 curl 调用或 pocketalert send,失败用 ||,成功用 &&。

3

收到告警

运行任务。如果失败,你的手机会震动,显示你设置的标题和错误输出。

在 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,它们会静音进入历史记录,记录有了,手机依旧安静。

及时发现悄悄出错的 cron 任务。

在 crontab 中添加一行,任务退出时失败通知会直接推送到你的手机。