Crontinel

简介

Crontinel 是开源的后台任务结果监控工具，将进程退出码与业务成果分开跟踪。任务可以 exit 0 但处理零记录，Crontinel 将此标记为失败并发送邮件警报。

什么是 Crontinel？

Crontinel 是专为后台任务设计的结果监控系统。传统监控只检查进程是否完成（exit 0），但无法验证工作是否真正执行。Crontinel 要求任务发送 HTTP 回执，包含 processed_records 等业务指标。当调度器停止、worker 崩溃或任务处理零记录时，系统立即开启事件并通知团队。支持 curl、Node、Python、Sidekiq、GitHub Actions，Laravel 包可自动附加队列深度和 Horizon 状态。

核心功能

• 双重状态跟踪：进程状态（completed/failed）与业务结果（passed/failed）分开记录
• HTTP 回执：任何运行环境发送相同 JSON 格式，包含 exit_code、processed_records、started_at
• 零记录检测：规则要求最少记录数，实际为零时标记为失败
• 调度器监控：检测 cron 条目丢失，即使网站响应 200
• Worker 状态：每个 worker 类型的队列深度、最旧任务、失败率趋势
• 离线警报：邮件通知不依赖应用程序模型，任务主机崩溃后仍能发送
• Laravel 深度集成：Composer 包自动从调度器和 Horizon 收集快照

优点

• Exit 0 不再掩盖问题：完成状态与工作结果分离，零处理量立即可见
• 单一回执格式：curl、Node、Python、Sidekiq、GitHub Actions 使用相同 JSON 主体
• 无需第二个 SDK：直接 POST 到 ingest endpoint，不依赖语言特定客户端
• 助理可读：Cursor、Claude Code 可解析事件包，了解零记录不等于健康
• 免费开始：单一应用程序免费，无需信用卡

定位与适用场景

Crontinel 专为依赖后台任务处理关键业务逻辑的团队设计：计费系统、报表生成、数据同步、通知发送。当 uptime 监控显示全绿但实际工作静默停止时，Crontinel 填补这个空白。

• SaaS 平台：计费 webhook、发票生成、dunning 提醒需要确保每次执行都处理记录
• 数据工程团队：ETL pipeline、分析汇总要求验证处理行数而非仅检查退出码
• Laravel 应用程序：使用 Horizon 的团队可自动收集队列深度和 supervisor 状态
• DevOps 与 SRE：需要在任务主机崩溃后仍能收到警报的团队