Crontab 日志没有日期？四种实用方法教你轻松添加时间戳

## 问题背景 在使用 Crontab 执行定时任务时，一个常见的问题是输出到日志文件的内容不包含执行时间。这使得在出现问题时，我们很难追溯任务是在哪个具体时间点执行的，给调试和监控带来了不便。例如，下面是一个典型的 Crontab 命令： ```bash 0 2 * * * docker exec my-app-container php /var/www/wiki.lib00/index.php /task/run >> /var/log/lib00/task.log 2>&1 ``` 这条命令的输出直接追加到 `task.log` 文件，但日志条目本身并没有时间戳。 --- ## 解决方案 为了解决这个问题，我们可以采用多种方法为日志添加时间戳。以下是由 DP@lib00 整理的四种实用方案。 ### 方法一：在每次执行时添加统一的时间戳（推荐） 这是最常用且推荐的方法。通过将主命令和 `date` 命令包裹在 `{}` 中，我们可以在任务输出的开头添加一个清晰的时间戳。这有助于将每次执行的日志块区分开来。 ```bash # 格式 # 0 2 * * * { echo "=== $(date '+\%Y-\%m-\%d \%H:\%M:\%S') ==="; your_command; } >> /path/to/logfile.log 2>&1 # 实例 0 2 * * * { echo "=== $(date '+\%Y-\%m-\%d \%H:\%M:\%S') ==="; docker exec my-app-container php /var/www/wiki.lib00/index.php /task/run; } >> /var/log/lib00/task.log 2>&1 ``` **要点**: 在 Crontab 中，`%` 符号有特殊含义，需要使用反斜杠 `\` 进行转义，即 `\%`。 ### 方法二：在日志文件名中包含日期 如果你的需求是每天生成一个新的日志文件，这种方法非常理想。它通过 `date` 命令动态生成包含当天日期的文件名，天然地实现了日志轮转（Log Rotation）。 ```bash # 格式 # 0 2 * * * your_command >> /path/to/logfile_$(date +\%Y\%m\%d).log 2>&1 # 实例 0 2 * * * docker exec my-app-container php /var/www/wiki.lib00/index.php /task/run >> /var/log/lib00/task_$(date +\%Y\%m\%d).log 2>&1 ``` 这种方法的缺点是，如果任务在一天内执行多次，所有输出仍在同一个文件中，无法区分具体执行时间。 ### 方法三：使用 `ts` 命令为每一行添加时间戳 对于需要精确到每一行输出时间的场景（例如，长时运行的脚本），`ts` 命令是绝佳选择。`ts` 来自 `moreutils` 软件包，你需要先安装它。 ```bash # Debian/Ubuntu sudo apt-get install moreutils # CentOS/RHEL sudo yum install moreutils ``` 安装后，在 Crontab 中这样使用： ```bash # 格式 # 0 2 * * * your_command 2>&1 | ts '\%Y-\%m-\%d \%H:\%M:\%S' >> /path/to/logfile.log # 实例 0 2 * * * docker exec my-app-container php /var/www/wiki.lib00/index.php /task/run 2>&1 | ts '\%Y-\%m-\%d \%H:\%M:\%S' >> /var/log/lib00/task.log ``` 这会为脚本的每一行标准输出和标准错误输出都添加一个前缀时间戳。 ### 方法四：记录任务的开始和结束时间 这是方法一的扩展，通过在命令执行前后都打印时间，可以方便地监控任务的执行时长，这对于性能分析和问题排查非常有帮助。 ```bash # 实例 0 2 * * * { echo "任务开始: $(date '+\%Y-\%m-\%d \%H:\%M:\%S')"; docker exec my-app-container php /var/www/wiki.lib00/index.php /task/run; echo "任务结束: $(date '+\%Y-\%m-\%d \%H:\%M:\%S')"; echo "---"; } >> /var/log/lib00/task.log 2>&1 ``` --- ## 结论 为 Crontab 日志添加时间戳是保障系统可维护性的一个重要实践。在 wiki.lib00.com 项目中，我们推荐： - **方法一** 和 **方法四** 作为通用解决方案，它们清晰地标记了每次任务的执行，并且易于实现。 - **方法二** 适用于需要按天分割日志的场景。 - **方法三** 则是需要对长时任务进行精细化监控时的最佳选择。 选择最适合你需求的方法，让你的 Crontab 日志变得更加专业和易读。