Linux Node.js日志轮转配置指南

Linux Node.js 日志轮转配置指南

一 常用方案与适用场景

• 下表对比了常见的日志轮转实现方式，便于按场景选择：

以上方案均为业界常用做法，生产环境优先选用系统级 logrotate 或与进程管理器配套的轮转方案。

二 方案一 logrotate 系统级配置

• 安装与准备
  • 大多数发行版默认自带 logrotate；如未安装：
    • Debian/Ubuntu：sudo apt-get install logrotate
    • CentOS/RHEL：sudo yum install logrotate
  • 建议将应用日志写入如 /var/log/yourapp/ 或 /opt/yourapp/logs/，并确保运行用户对目录有写权限。
• 创建配置文件
  • 新建：/etc/logrotate.d/yourapp
  • 示例（按天轮转，保留 7 天，压缩，延迟压缩，空文件不轮转，缺失不报错，轮转后重建文件）：

    /var/log/yourapp/*.log {
        daily
        rotate 7
        compress
        delaycompress
        missingok
        notifempty
        create 0640 yourapp yourapp
        postrotate
            # 可选：通知应用重新打开日志（如支持 SIGUSR1/SIGUSR2 或自定义 reload 脚本）
            # kill -USR1 $(cat /var/run/yourapp.pid) 2>/dev/null || true
        endscript
    }
    

• 关键参数说明
  • daily：按天轮转；可改为 hourly/weekly/monthly。
  • rotate N：保留 N 个历史副本。
  • compress / delaycompress：压缩旧日志；延迟压缩常用于避免影响最新日志的读取。
  • missingok / notifempty：文件缺失或为空时不报错/不轮转。
  • create MODE OWNER GROUP：轮转后新建日志文件的权限与属主。
  • postrotate … endscript：轮转后执行的钩子，常用于通知应用重开日志文件句柄。
• 测试与验证
  • 语法检查：sudo logrotate -d /etc/logrotate.d/yourapp
  • 强制执行：sudo logrotate -f /etc/logrotate.d/yourapp
  • 观察是否生成如 app.log.1.gz、app.log.2.gz 等归档文件，并确认新日志正常写入。
• 不中断写入的两种方式
  • 使用 copytruncate：复制当前日志后截断原文件，避免信号通知；适合无法发送信号的应用。

    /var/log/yourapp/*.log {
        daily
        rotate 7
        compress
        copytruncate
        missingok
        notifempty
    }
    

  • 使用 postrotate 发送信号（如 SIGUSR1）让应用重新打开日志文件（需应用支持）。

三 方案二 PM2 内置日志轮转

• 安装插件：pm2 install pm2-logrotate
• 常用配置（示例为每天轮转、保留 7 天、压缩）：

  pm2 set pm2-logrotate:max_size 10M
  pm2 set pm2-logrotate:retain 7
  pm2 set pm2-logrotate:compress true
  pm2 set pm2-logrotate:rotateInterval "0 0 * * *"
  

• 验证与生效：pm2 restart all，日志默认位于 ~/.pm2/logs/。
• 适用说明：仅当应用由 PM2 管理时推荐此方案，配置简单、运维成本低。

四 方案三 应用内轮转（winston/pino）

• 使用 winston + winston-daily-rotate-file

  const winston = require('winston');
  const DailyRotateFile = require('winston-daily-rotate-file');
  
  const transport = new DailyRotateFile({
    filename: 'application-%DATE%.log',
    datePattern: 'YYYY-MM-DD',
    zippedArchive: true,
    maxSize: '20m',
    maxFiles: '14d'
  });
  
  const logger = winston.createLogger({
    level: 'info',
    format: winston.format.json(),
    transports: [transport]
  });
  
  logger.info('Hello, world!');
  

• 使用 pino（示例）

  const pino = require('pino');
  const rotate = require('pino-rotate');
  
  const logger = pino({
    level: 'info'
  });
  
  rotate({
    period: '1d',
    path: 'application.log',
    size: '20m',
    compress: true,
    rotate: true
  });
  
  logger.info('Hello, world!');
  

• 适用说明：适合需要在应用内按大小/时间切分、并做结构化日志与异步压缩的场景；注意文件句柄与进程信号的处理。

五 容器与集中式日志实践

• Docker 日志驱动
  • 使用 local 驱动并配置最大大小与保留文件数，避免容器日志无限增长：

    docker run -d \
      --name my_app \
      --log-driver local \
      --log-opt max-size=10m \
      --log-opt max-file=3 \
      my_image
    

• 集中式日志管理
  • 大规模或需要检索分析时，建议接入 ELK Stack（Elasticsearch、Logstash、Kibana） 或 Graylog，配合结构化日志（如 JSON）提升可观测性。