Node.js在CentOS上如何日志管理

Node.js 在 CentOS 的日志管理实践

一套清晰、高效的日志管理方案，是保障Node.js应用在Linux服务器上稳定运行、快速排障的基石。今天，我们就来聊聊在CentOS环境下，如何从采集、轮转、清理到集中化，构建一个既专业又易于维护的日志体系。

一 日志采集与结构化

好的开始是成功的一半，日志管理也不例外。第一步，就是在应用内部做好日志的规范输出。

• 在应用内使用成熟的日志库，优先选择结构化输出（如 JSON），便于后续的检索与分析。这已经是业内的最佳实践。常见的库选择有 Winston、Pino、Bunyan、Log4js 等。
• 这里以 Winston 配合按天轮转为例，展示一个典型的配置：
  • 安装依赖：npm i winston winston-daily-rotate-file
  • 核心配置示例：

    const winston = require(‘winston’);
    const { createLogger, format, transports } = winston;
    const DailyRotateFile = require(‘winston-daily-rotate-file’);
    
    const logger = createLogger({
      level: ‘info’,
      format: format.combine(
        format.timestamp({ format: ‘YYYY-MM-DD HH:mm:ss’ }),
        format.json()
      ),
      transports: [
        new DailyRotateFile({
          filename: ‘/var/log/myapp/application-%DATE%.log’,
          datePattern: ‘YYYY-MM-DD’,
          zippedArchive: true,
          maxSize: ‘20m’,
          maxFiles: ‘14d’
        }),
        new transports.Console()
      ]
    });
    
    logger.info(‘hello world’, { route: ‘/health’ });

• 当然，如果你的应用进程是由 PM2 托管的，那么直接利用其内置的日志能力也是一个非常便捷的选择，具体我们会在下一节展开。

二 日志轮转与清理

日志文件如果放任不管，很快就会撑满磁盘。因此，自动化的轮转与清理策略必不可少。

• 使用系统自带的 logrotate：这是 CentOS 等 Linux 发行版的“标准配置”，通常已预装，稳定可靠。
  • 新建一个专属配置文件：sudo vim /etc/logrotate.d/node-app
  • 写入如下配置（实现了按天轮转、保留7天、自动压缩、空文件不轮转、并在轮转后创建具有指定权限的新文件）：

    /var/log/myapp/*.log {
      daily
      rotate 7
      compress
      missingok
      notifempty
      create 0640 myapp myapp
    }

  • 配置完成后，可以手动测试一下效果：sudo logrotate -f /etc/logrotate.d/node-app
• 使用 PM2 内置日志轮转：对于 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 时的轻量替代方案：cron + find 命令组合，简单直接。
  • 示例（通过cron任务，每天0点删除7天前的 .log 文件）：0 0 * * * find /var/log/myapp -type f -name “*.log” -mtime +7 -delete
• 选择建议：使用 PM2 时优先用其内置轮转；裸进程或无侵入需求时优先用 logrotate；极简环境或特殊需求下，cron脚本也不失为一种灵活选择。

三 集中式日志与可视化

当服务器数量增多，或者需要深度分析、实时告警时，分散在各处的日志文件就显得力不从心了。这时，集中式日志平台的价值就凸显出来。

• 将日志汇聚到集中式平台，便于实现统一检索、智能告警与丰富可视化：
  • ELK Stack（Elasticsearch + Logstash + Kibana）：这套组合提供了强大的全文检索与可视化能力，非常适合构建复杂的业务分析仪表盘。
  • Graylog：企业级的集中式日志管理方案，部署和配置相对简单直接。
  • Splunk：功能完备的商业方案，生态成熟，开箱即用。
  • Grafana Loki：与 Grafana 监控栈深度集成，设计上更注重成本效益，特别适合云原生与微服务架构。
• 另外提一句，如果你的服务是通过 systemd 托管的，那么结合 journalctl 命令来统一查看服务的标准输出和错误输出，可以作为系统层面一个非常有力的补充视角。

四 落地配置示例

理论说再多，不如一个完整的例子来得直观。下面我们以一个“Node.js + PM2 + logrotate + ELK”的混合场景为例，串联起上述所有环节。

• 场景：Node.js + PM2 + logrotate + ELK
  • 应用层（Winston）：输出结构化JSON日志，方便后续Logstash解析。
    • 安装：npm i winston winston-daily-rotate-file
    • 配置要点：将日志输出到 /var/log/myapp/app.log 与 error.log，并配置按天轮转、压缩、保留14天；同时保持控制台输出，便于本地快速排查。
  • 进程管理层（PM2）：
    • 启动应用：pm2 start app.js -n myapp
    • 配置日志轮转：
      • pm2 install pm2-logrotate；
      • 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 * * *”
  • 系统层（logrotate）：作为兜底策略，确保日志文件的统一清理和权限管理。
    • 配置：/var/log/myapp/*.log { daily; rotate 7; compress; missingok; notifempty; create 0640 myapp myapp }
  • 集中化层（ELK Stack）：
    • 数据流：Filebeat 采集 /var/log/myapp/*.log → 发送至 Logstash（进行JSON解析、补充业务字段）→ 存储到 Elasticsearch（提供高速检索）→ 最终在 Kibana 中构建仪表盘与设置告警规则。