如何自动检测漏执行的cron任务深度解析minicron监控引擎的工作原理【免费下载链接】minicron️ Monitor your cron jobs项目地址: https://gitcode.com/gh_mirrors/mi/minicronMinicron是一款开源的轻量级cron 任务监控工具它能自动检测定时任务漏执行与执行失败并通过邮件、短信、Slack、PagerDuty、AWS SNS 五种通道推送告警。本文带你用大白话读懂它的监控引擎一个每分钟巡逻的巡检线程如何判定这个任务本该运行却没跑又如何在任务失败的第一时间发出警报。⏰ 为什么 cron 任务会悄悄失踪写过的crontab -e的人都知道cron 最大的问题是只干活、不说话故障场景传统 cron 的表现脚本执行出错返回非 0 退出码除非配置MAILTO否则无人知晓服务器宕机 / cron 进程死亡任务直接跳过无任何记录有人手动改了 crontab 或注释掉任务任务从此消失没有通知磁盘满、依赖服务挂了静默失败下次运行时才发现问题而 minicron 的思路很巧妙不替换你的 cron而是给每个任务套上一层汇报层让每一次执行都留下数据库记录再由服务端核对该来没来的任务。 整体架构客户端 监控中心Hubminicron 由两部分组成源码仓库只读参考客户端Go 编写client/run/run.go —— 以minicron run 你的命令形式运行负责执行命令并逐行上报输出Hub 服务端Ruby 编写server/lib/minicron/ —— 提供 Web UI、REST API并内置监控引擎。关键一步在 server/lib/minicron/cron.rbHub 会为每台主机自动生成 crontab把原任务mysqldump db包装成minicron run mysqldump db。系统 cron 依旧负责到点触发而minicron run则负责执行时打点汇报。 漏执行检测核心Monitor 巡检线程这就是文章标题的答案所在全部逻辑集中在 server/lib/minicron/monitor.rb 中核心思想是心跳反查第 1 步每分钟一次的巡逻服务器启动后Monitor 开一个独立线程monitor.rb#L30-L51循环 { 遍历数据库中所有调度计划 → 逐个检查 → sleep 59 秒 }注意它不主动去远程探测主机而是检查数据库里有没有心跳记录——这就引出客户端的打点逻辑。第 2 步客户端的心跳——执行记录创建时间当系统 cron 到点触发minicron run时客户端第一步就向 Hub 的/api/1.0/execution/init接口报到client/run/run.go#L63-L75Hub 随即在数据库创建一条Execution执行记录。之后start、output、finish、exit事件陆续更新这条记录executions.rb。所以这条记录是否存在就是任务有没有被触发的证据。第 3 步120 秒期望窗口判定漏执行对每个调度计划monitor.rb#L70-L103Monitor 会做如下计算变量含义expected_at解析 cron 表达式得到的最近一次应执行时刻再前推 30 秒容忍提前触发expected_byexpected_at 120 秒即 30 秒前缓冲 60 秒分钟窗口 30 秒后缓冲判定条件若该窗口内查不到该任务的 Execution 记录 → 判定为miss漏执行前后各留 30 秒缓冲是为了吸收客户端与 Hub 之间的时钟漂移。此外还有两个防误报的边界monitor.rb#L84只检查 Monitor启动之后的应执行时刻避免服务器重启后误报历史欠账若调度计划在窗口结束后又被人工更新过则跳过检查——说明你可能刚改过计划不属于漏执行。判定失败后Monitor 调用Minicron::Alert.send_all(kind: miss, ...)发出漏执行告警。reboot这类特殊计划会被跳过monitor.rb#L40。 另一条告警线任务失败零延迟通知漏执行检测靠巡检而执行失败则走实时通道客户端命令跑完后会把退出码上报到/api/1.0/execution/exitexecutions.rb#L173-L191if body[:exit_status].to_i 0 Minicron::Alert.send_all(kind: fail, ...) end也就是说命令一返回非 0 退出码Hub 立刻发fail告警不用等下一分钟的巡检——两条线互补覆盖了没跑和跑了但错了两类事故。 五种告警通道 防重复轰炸机制告警分发逻辑在 server/lib/minicron/alert.rb支持通道一览通道实现适用场景 Emailalert/email.rbSMTP日常运维 SMSalert/sms.rbTwilio手机即时提醒 PagerDutyalert/pagerduty.rb值班/升级体系☁️ AWS SNSalert/aws_sns.rbAWS 生态 Slackalert/slack.rbWebhook团队群通知每个通道独立开关配置见示例文件 server/config/server.toml。更贴心的细节是去重机制每次发送前都会查alerts表确认这个 miss 事件 这个通道是否已发过alert.rb#L134-L143确保一次漏执行每个通道只收一封告警而不是每分钟巡检都重发一遍。 5 分钟快速上手git clone https://gitcode.com/gh_mirrors/mi/minicron cd minicron仓库提供了 docker-compose.yml 可一键拉起 Hub 服务端服务器默认绑定0.0.0.0:9292启动后访问 Web UI 即可管理任务、查看历史执行输出、配置告警。在目标主机上只需让 cron 按计划触发minicron run mysqldump mydb backup.sql支持--dry-run参数试跑而不上报见 README.md 的 Usage 章节。之后无论任务漏跑还是失败告警都会自动送达你配置的通道。 延伸阅读关键源码地图漏执行判定引擎server/lib/minicron/monitor.rb#L77-L101crontab 自动生成与命令包装server/lib/minicron/cron.rb#L12-L15执行上报 REST APIserver/lib/minicron/hub/controllers/api/executions.rb调度计划格式化cron 五段式拼接server/lib/minicron/hub/models/schedule.rb#L20-L27数据库表结构server/db/schema.rb一句话总结minicron 的精髓在于客户端打心跳 服务端对表——用一个 120 秒的期望时间窗口反查执行记录来发现漏跑用退出码实时上报来捕获失败再配合五种通道的去重告警让 cron 任务从此不再悄悄失踪。【免费下载链接】minicron️ Monitor your cron jobs项目地址: https://gitcode.com/gh_mirrors/mi/minicron创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考