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：需要在任務主機崩潰後仍能收到警報的團隊