任务失败无人知晓minicron 5种告警通道Email/SMS/Slack/PagerDuty/SNS配置详解【免费下载链接】minicron️ Monitor your cron jobs项目地址: https://gitcode.com/gh_mirrors/mi/minicronminicron 是一款开源的cron 任务监控工具它让计划任务在服务器上可靠执行并自动记录每次运行结果。一旦任务执行失败或错过调度时间minicron 会通过 Email、SMS、Slack、PagerDuty、AWS SNS 这 5 种告警通道第一时间通知你。本文将带你完整看懂每种告警通道的配置方法与适用场景让每一次任务失败都逃不过你的眼睛 为什么你的 cron 任务需要告警 ⏰原生 cron 有个经典痛点任务静默运行失败无人知晓。凌晨的备份脚本悄悄挂了等第二天发现数据缺失时已经晚了任务错过执行时间比如机器重启、锁冲突时cron 不会留下任何提醒多个服务器、几十个任务靠人工检查crontab日志根本不现实。minicron 的解决思路在目标服务器上安装 minicron客户端cron 通过它运行命令执行结果实时上报到 minicron服务器端Web 管理界面服务器端内置监控器自动判定fail执行失败与miss超时未执行两种异常并向所有已启用的告警通道发送通知。告警架构一览2 种触发条件1 处统一配置 ️所有告警的调度逻辑集中在 server/lib/minicron/alert.rb 中send_all遍历配置文件里每个通道只向enabled true的通道发送内置去重机制sent?同一种告警只发一次避免同一任务失败时你收到五条相同消息每种通道对应一个独立实现文件职责清晰通道实现文件Emailserver/lib/minicron/alert/email.rbSMSserver/lib/minicron/alert/sms.rbSlackserver/lib/minicron/alert/slack.rbPagerDutyserver/lib/minicron/alert/pagerduty.rbAWS SNSserver/lib/minicron/alert/aws_sns.rb所有配置项都写在一份 TOML 配置文件中参考模板见 server/config/server.toml。下面逐个通道讲解配置方法。通道一Email 邮件告警推荐首选Email 是最通用、零成本的告警通道基于标准 SMTP 协议几乎所有邮件服务Gmail、QQ 邮箱、自建 Postfix都可用。在配置文件的[alerts.email]段中填入发件人、收件人和 SMTP 服务器参数[alerts.email] enabled true from opsyour-domain.com to oncallyour-domain.com [alerts.email.smtp] address smtp.gmail.com # 你的 SMTP 服务器 port 587 domain your-domain.com user_name opsyour-domain.com password your-password authentication plain enable_starttls_auto trueSMTP 客户端的初始化逻辑见 server/lib/minicron/alert/email.rb。收到的邮件主题类似minicron alert for job backup db!正文会说明是哪种任务、哪一次执行出了什么问题。通道二SMS 短信告警Twilio需要 7×24 小时确保有人被唤醒时短信是最直接的方式。minicron 通过 Twilio 发送短信只需两步在 Twilio 控制台获取Account SID和Auth Token填入配置[alerts.sms] enabled true from 8613800000000 # Twilio 虚拟号 to 8613900000000 # 你的手机号 [alerts.sms.twilio] account_sid YOUR_TWILIO_ACCOUNT_SID auth_token YOUR_TWILIO_AUTH_TOKEN短信内容会直接标注任务编号与失败/错过原因例如minicron alert - job failed! Execution #123 of Job #5 failed手机上扫一眼即可定位问题。通道三Slack 群聊告警 如果团队日常都在 Slack 里协作把告警推到值班频道是最自然的方案。minicron 使用 Slack 的Incoming Webhook无需创建 Bot 应用配置最轻量[alerts.slack] enabled true webhook_url https://hooks.slack.com/services/XXXX/XXXX/XXXX channel #oncall实现见 server/lib/minicron/alert/slack.rb消息会以minicron的身份发送到指定频道包含任务名称、任务 ID 和失败详情团队成员可在群里直接 责任人处理。通道四PagerDuty 值班呼叫 生产环境的“最后一道防线”。PagerDuty 支持短信、电话呼叫、App 推送多种升级策略适合必须有人响应的核心任务如支付对账、数据同步。只需一个服务级 API 密钥[alerts.pagerduty] enabled true service_key YOUR_PAGERDUTY_SERVICE_KEY实现非常简洁server/lib/minicron/alert/pagerduty.rb 中直接调用 PagerDuty 的trigger接口创建事件失败事件标题为Job failed!错过事件为Job missed!方便在 PagerDuty 面板中快速区分。通道五AWS SNS 主题通知 ☁️如果你的基础设施跑在 AWS 上SNS 是天然的选择把 minicron 告警发布到 SNS Topic 后可以一对多分发给邮件列表、SQS 队列、Lambda 甚至短信后续扩展告警下游几乎零成本[alerts.aws_sns] enabled true access_key_id YOUR_ACCESS_KEY_ID secret_access_key YOUR_SECRET_ACCESS_KEY region us-east-1 topic_arn arn:aws:sns:us-east-1:123456789:minicron-alerts客户端初始化逻辑见 server/lib/minicron/alert/aws_sns.rb。安全提示建议为 minicron 创建一个仅有该 Topic 发布权限的 IAM 用户避免使用长期主账号密钥。告警触发机制fail 与 miss 是怎么判定的⚙️fail执行失败客户端上报的执行记录中出现错误结果时触发miss超时未执行由服务器端的监控线程负责约每分钟巡检一次所有调度计划逻辑在 server/lib/minicron/monitor.rb。判定的细节很讲究监控器用 cron 表达式算出任务最近一次应执行时间并叠加「前 30 秒缓冲 60 秒等待 后 30 秒缓冲」的窗口容忍客户端与服务端之间的时钟偏差。只有窗口彻底过去仍查不到执行记录才会触发miss告警最大限度避免误报。在哪里查看已发送的告警每条成功发出的告警都会被记录进数据库通道、类型、任务、发送时间并保存在 server/lib/minicron/hub/models/alert.rb 对应的表中。登录 Web 管理界面的/alerts页面即可查看全部历史路由实现在 server/lib/minicron/hub/controllers/alerts.rb。排查“为什么没收到告警”时这里是第一站。选型速查表该开哪个通道✅通道适用场景接入成本Email 日常非紧急任务零成本兜底极低SMS 需要立即触达个人手机低Twilio 按条计费Slack 团队协作值班群内响应极低PagerDuty 生产核心任务需电话升级中订阅制AWS SNS ☁️AWS 生态一对多分发中minicron 支持多通道并行开启——例如「Email Slack」作为日常双保险核心任务再叠加 PagerDuty一套配置覆盖所有异常场景。小结 ️所有告警配置集中在 server/config/server.toml 的[alerts]段enabled true即开启5 种通道Email / SMS / Slack / PagerDuty / SNS按需组合fail 与 miss 两种异常全覆盖内置去重机制防止重复轰炸Web 界面可追溯每一条已发送告警。把告警配置好之后你的 cron 任务就真正做到了「失败必有人知错过必有提醒」——这才是一个可以安心睡着的自动化体系 【免费下载链接】minicron️ Monitor your cron jobs项目地址: https://gitcode.com/gh_mirrors/mi/minicron创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考