Linux下Node.js日志如何归档管理

Linux下Node.js日志归档管理

一 常用方案与适用场景

• 下表概览常见方案、适用场景与关键要点：

以上方案均为生产常用做法，可按你的部署方式与运维习惯选择或组合使用。

二 使用 logrotate 进行系统级归档

• 安装与放置配置
  • 大多数发行版默认自带 logrotate；若未安装，可用包管理器安装（如 apt/yum）。
  • 在 /etc/logrotate.d/ 下为你的应用新建配置，例如 /etc/logrotate.d/nodejs-app。
• 最小可用配置示例（按天轮转，保留 7 天，压缩旧日志）

  /var/log/node-app/*.log {
      daily
      rotate 7
      compress
      delaycompress
      missingok
      notifempty
      create 0640 root adm
      sharedscripts
      postrotate
          # 若应用支持USR1重开日志，优先使用；否则用copytruncate
          killall -USR1 node 2>/dev/null || true
      endscript
  }
  

  • 关键点说明：
    • daily/rotate/compress/delaycompress/missingok/notifempty/create：按天轮转、保留份数、压缩、延迟压缩、忽略缺失、空文件不轮转、轮转后重建文件并设定权限属主。
    • postrotate：通知应用重新打开日志文件。若应用不支持信号，可改用 copytruncate（见下文）。
• 测试与强制执行
  • 语法检查：sudo logrotate -d /etc/logrotate.d/nodejs-app
  • 强制执行：sudo logrotate -f /etc/logrotate.d/nodejs-app
• 重要提示
  • 若应用不支持日志重开信号，使用 copytruncate 可在轮转后继续写入原文件（但存在极小概率丢日志的风险，建议优先选择支持信号重开的日志库或进程管理方案）。

三 使用 PM2 内置日志轮转

• 安装插件：pm2 install pm2-logrotate
• 常用配置（可按需调整）

  pm2 set pm2-logrotate:max_size 10M     # 达到10MB轮转
  pm2 set pm2-logrotate:retain 7         # 保留7个历史文件
  pm2 set pm2-logrotate:compress true    # 压缩旧日志
  pm2 set pm2-logrotate:rotateInterval "0 0 * * *"  # 每天00:00轮转
  

• 重启生效：pm2 restart all
• 说明：PM2 会将应用日志写入 ~/.pm2/logs/，并按上述策略自动轮转与压缩。

四 应用内日志库归档示例

• 使用 winston + DailyRotateFile（按天/按大小、压缩、保留）

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

• 使用 pino-rotate（高性能场景）

  const pino = require('pino');
  const { createLogger } = require('pino-rotate');
  
  const logger = createLogger({
    level: 'info',
    transport: {
      target: 'pino-pretty',
      options: { colorize: true, translateTime: 'SYS:standard' }
    },
    interval: '1d',         // 按天
    path: 'application.log',
    maxsize: '20m',         // 达到20MB也轮转
    gzip: true,             // 压缩
    retainDays: 14          // 保留14天
  });
  

• 说明：应用内方案便于结构化日志、按级别分流与灵活保留策略，适合容器化与云原生部署。

五 策略与运维建议

• 切割维度
  • 按时间：如 daily/每周/每月，便于对齐业务与审计周期。
  • 按大小：如 10MB/100MB，防止单文件过大影响性能与检索。
  • 按数量：只保留 N 个最新归档，控制磁盘占用。
• 保留与压缩
  • 结合业务与合规设置保留天数（如 7/14/30 天），并开启 compress/delaycompress 节省空间。
• 命名与可读性
  • 启用 dateext 在归档文件名中附加日期，便于排序与定位。
• 信号与重开
  • 优先让应用处理 USR1/SIGUSR1 信号以重新打开日志文件，避免 copytruncate 的潜在丢日志风险。
• 权限与安全
  • 归档目录与日志文件设置合适的 权限/属主（如 0640 root adm），避免敏感信息泄露。
• 集中化与长期留存
  • 对关键业务建议接入 ELK/EFK 或云日志服务，长期留存与检索分析；本地仅保留短期热数据。