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

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

一常用方案与适用场景

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

方案	适用场景	关键优点	注意点
logrotate（系统级）	任意部署方式（systemd、PM2、Docker、裸进程）	系统自带、集中管理、稳定可靠	需确保应用能重新打开日志文件
PM2 内置 pm2-logrotate	使用 PM2 管理进程	配置简单、与 PM2 深度集成	仅适用于 PM2 管理的应用
Node.js 日志库（winston/pino）	需要在应用内精细控制	按大小/时间切分、可异步压缩	需处理文件句柄与进程信号
Docker 日志驱动	容器化部署	与容器运行时集成、无需改代码	依赖容器平台能力

以上方案均为业界常用做法，生产环境优先选用系统级 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）提升可观测性。

0 赞

0 踩