log4js-node日志滚动策略解析：从daysToKeep到numBackups的演进

在Node.js日志管理领域，log4js-node作为主流日志框架，其文件滚动策略的配置方式经历了重要演变。本文将深入剖析dateFile appender的日志保留机制，帮助开发者正确配置日志滚动策略。

配置属性的历史变迁

早期版本中，log4js-node采用daysToKeep属性来控制日志文件的保留数量。这个属性名称容易让人误解为"按天数保留"，实际上它控制的是保留的日志文件数量。从6.4.0版本开始，框架将其更名为numBackups，使语义更加明确。

滚动策略的工作原理

log4js-node的dateFile appender采用双重滚动机制：

1. 时间维度滚动：由pattern参数决定，如yyyy-MM-dd.log表示按天滚动
2. 大小维度滚动：由maxLogSize参数控制单个文件最大尺寸

当启用maxLogSize时，系统会在文件达到指定大小时创建新文件，同时按照numBackups设置保留最近的文件版本。

典型配置示例分析

考虑以下常见配置：

{
  type: 'dateFile',
  filename: '/var/log/app/log',
  pattern: 'yyyy-MM-dd.log',
  maxLogSize: 10485760, // 10MB
  numBackups: 7
}

这种配置会产生以下行为：

• 每天生成一个新日志文件（如app-2024-01-19.log）
• 当单日日志超过10MB时，会滚动生成app-2024-01-19.log.1等文件
• 系统保留最近的7个滚动文件（不包括当前活跃文件）

日志保留的深层机制

需要特别注意，numBackups控制的是文件数量而非天数。例如：

• 某日产生95MB日志，将生成9个10MB文件
• 设置numBackups:7时，系统会保留最近的7个文件（app.log.1到app.log.7）
• 较早的app.log.8和app.log.9会被删除

产品化思考与最佳实践

从产品角度考虑这种设计：

1. 可靠性优先：防止单个日志文件过大导致操作困难
2. 存储保护：避免日志无限增长耗尽磁盘空间
3. 灵活性：支持按小时、日、月等多种时间维度配置

对于需要严格按天数保留日志的场景，建议：

1. 禁用maxLogSize，确保每日日志完整保存在单个文件中
2. 配合外部脚本定期清理过期日志文件
3. 或者设置足够大的numBackups值，确保覆盖所需天数

总结

理解log4js-node的滚动策略对于构建可靠的日志系统至关重要。开发者应当根据实际需求，合理配置pattern、maxLogSize和numBackups的组合，在日志完整性和存储效率之间取得平衡。