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

聊到Node.js日志归档，其实是个挺常见的话题。线上跑的服务，日志只会越积越多，如果不加管控，磁盘很快就会被撑爆。更棘手的是，很多问题需要回溯日志才能定位，如果日志文件混乱、不全，排查起来简直像大海捞针。

那么，到底该怎么管？市面上其实有不少成熟的方案，关键是找到适合你团队部署方式和运维习惯的那一款。

常用方案与适用场景

先不急着谈论具体怎么配，咱们先捋一捋常见的几种方式，看看它们分别擅长解决什么问题：

以上方案各有侧重，完全可以按需组合使用。

使用 logrotate 进行系统级归档

logrotate 几乎是Linux服务器工程师最熟悉的工具了。大多数发行版默认自带，即便没装，一行命令就能搞定。

配置起来也很直接：在 /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 是常规保护，日志文件不存在或为空时不会报错；postrotate 脚本则是用来通知应用重新打开日志文件，如果应用不支持信号，可以改用 copytruncate 选项。

配置好后，一定要测试一下：sudo logrotate -d /etc/logrotate.d/nodejs-app 检查语法，sudo logrotate -f /etc/logrotate.d/nodejs-app 强制执行看看效果。

需要警惕的一个小陷阱：如果应用不支持日志重开的信号，使用 copytruncate 虽然能继续写入，但理论上存在极小概率的丢日志风险。因此，优先选择支持信号重开的日志库或进程管理方案会更稳妥。

使用 PM2 内置日志轮转

如果你的Node.js服务是通过 PM2 部署的，那事情就更简单了。PM2 自带了一个日志轮转插件 pm2-logrotate，装上去就能用。

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），防止单文件过大影响性能；按数量保留，控制磁盘空间。
• 保留与压缩：根据业务合规要求设定保留天数（7/14/30天），同时开启 compress 或 delaycompress，能有效节省磁盘空间。
• 命名与可读性：启用 dateext，在归档文件名里加上日期，排序和定位都方便很多。
• 信号与重开：优先让应用处理 USR1 信号以重新打开日志文件，这比 copytruncate 安全得多。
• 权限与安全：归档目录和日志文件的权限、属主一定要设置妥当（比如 0640 root adm），避免敏感信息泄露。
• 集中化与长期留存：对于关键业务，建议接入 ELK/EFK 或云日志服务，做长期留存与检索分析，本地只保留短期热数据。