Log4js-node 日志滚动策略：同时按日期和文件大小分割日志文件

在日志管理系统中，合理的日志分割策略对于维护和排查问题至关重要。Log4js-node作为Node.js生态中广泛使用的日志工具，提供了灵活的日志滚动机制。本文将深入探讨如何实现同时基于日期和文件大小的复合滚动策略。

复合滚动策略的实现原理

Log4js-node从4.x版本开始，dateFile类型的appender可以接收file类型的所有配置参数。这意味着开发者可以同时配置基于时间的滚动模式和基于文件大小的滚动模式，两种策略会协同工作。

核心配置参数

要实现复合滚动策略，需要关注以下关键参数：

1. pattern：定义日期滚动模式，例如'yyyy-MM-dd-hh-mm-ss'表示按秒滚动
2. maxLogSize：定义文件大小阈值（单位：字节），达到该大小即触发滚动
3. compress：是否压缩历史日志文件
4. layout：定义日志输出格式

实际配置示例

const log4js = require('log4js');

function createAppenderConfig() {
  return {
    type: 'dateFile',
    filename: 'application.log',
    pattern: 'yyyy-MM-dd',  // 按天滚动
    maxLogSize: 1048576,    // 1MB大小限制
    compress: true,
    layout: {
      type: 'pattern',
      pattern: '[%d{ISO8601}] [%p] [%c] - %m'
    }
  };
}

log4js.configure({
  appenders: {
    main: createAppenderConfig()
  },
  categories: {
    default: { appenders: ['main'], level: 'info' }
  }
});

const logger = log4js.getLogger();

工作流程说明

1. 初始阶段：日志首先写入主文件（如application.log）
2. 大小触发：当文件达到maxLogSize时，会按日期模式重命名当前文件
3. 时间触发：到达pattern定义的时间间隔时，也会触发滚动
4. 文件命名：滚动后的文件名会同时包含时间戳和序号

最佳实践建议

1. 对于高频日志系统，建议设置较小的maxLogSize（如10MB）配合按天的pattern
2. 对于低频重要系统，可以增大maxLogSize并配合更细粒度的时间pattern
3. 生产环境建议开启compress选项以节省存储空间
4. 注意监控日志目录，避免因配置不当导致磁盘空间耗尽

通过这种复合滚动策略，开发者可以在保证日志可管理性的同时，兼顾了日志查询的便利性和系统资源的合理利用。