Cron Doctor

🩺 定时任务故障诊断专家

自动化诊断定时任务故障,识别错误模式、按优先级分级并生成健康报告,适合 DevOps 和 SRE 日常运维。

收藏
7.9k
安装
2.2k
版本
1.0.1
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用法

Cron Doctor 是一款专为诊断和分类 cron 定时任务故障设计的系统运维技能。它通过标准化的诊断流程,帮助用户快速定位定时任务失败的根本原因。

核心诊断流程:
1. 任务枚举:扫描用户级和系统级 crontab,列出所有定时任务

2. 日志分析:根据操作系统类型(Debian/Ubuntu、RHEL/CentOS、macOS)定位并解析 cron 日志

3. 错误识别:自动识别 7 类常见错误模式——命令不存在、权限拒绝、路径错误、超时、网络连接失败、API 限流、以及完全无输出(任务未执行)

4. 优先级分级:按业务影响将任务分为四级——🔴 关键级(交易、备份、安全)、🟠 高级(面向用户)、🟡 中级(监控、研究)、🟢 低级

5. 报告生成:输出结构化 Markdown 健康报告至 ~/workspace/reports/cron-health-YYYY-MM-DD.md

显著优点

  • 开箱即用:内置多平台日志路径和命令适配,无需手动查询系统差异
  • 结构化输出:强制要求填写错误信息、上次成功时间、优先级、修复建议,避免诊断流于表面
  • 升级机制:3 个以上关键任务失败时自动触发告警,防止漏掉高影响故障
  • 调试指南完整:提供环境模拟、手动验证、daemon 状态检查等实用技巧

潜在缺点与局限性

  • 权限依赖:部分诊断步骤需要 sudo 权限才能访问系统级 crontab 和日志
  • 平台覆盖有限:主要覆盖主流 Linux 发行版和 macOS,Windows 计划任务不支持
  • 被动响应:依赖用户触发或任务失败后的诊断,缺乏实时监控能力
  • 无自动修复:仅提供修复建议,不执行实际修复操作

适合人群

  • DevOps 工程师、SRE、系统管理员
  • 需要维护大量定时任务的后端开发者
  • 缺乏 cron 排查经验的初级运维人员

常规风险

  • 日志解析依赖系统时间配置,时区错误可能导致误判执行时间
  • 敏感信息(如 API 密钥)可能存在于 cron 命令或日志中,报告生成时需注意脱敏
  • 频繁执行 crontab -l 和日志查询在大型系统上可能产生轻微 IO 负载

Cron Doctor 内容

手动下载zip · 3.9 kB
README.mdtext/markdown
请选择文件