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

Linux下Node.js日志归档管理

一常用方案与适用场景

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

方案	适用场景	关键要点
logrotate（系统自带）	直接写文件的应用、多进程/多实例、需要统一系统级策略	支持按大小/时间轮转、压缩、保留份数、可配合信号或copytruncate让应用继续写入
PM2 内置日志轮转	使用 PM2 部署的 Node.js 服务	插件 pm2-logrotate 配置简单，支持按大小/时间轮转、压缩、保留份数
应用内日志库	需要在代码中灵活控制格式、级别、传输与归档	winston + DailyRotateFile、pino-rotate、log4js 等，支持按天/按大小、压缩与保留策略

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

二使用 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 或云日志服务，长期留存与检索分析；本地仅保留短期热数据。

0 赞

0 踩