Linux系统中Node.js日志如何优化

Linux下Node.js日志优化实战指南

一 核心策略与优先级

• 选择高性能日志库：优先考虑Pino、Winston、Bunyan；HTTP请求日志可用Morgan与业务日志分离。
• 设置合理日志级别：生产以error/warn为主，开发/排障时临时提升到info/debug；必要时支持运行时动态调整。
• 使用结构化日志：统一输出为JSON，便于检索、聚合与可视化分析。
• 控制磁盘I/O：启用异步写入与缓冲/批量，减少同步磁盘操作对事件循环的阻塞。
• 避免日志污染：通过命名空间/前缀区分模块来源，提升可读性与可维护性。
• 安全合规：对密码、令牌、卡号等敏感信息进行脱敏或过滤。

二 日志库与级别配置示例

• 使用Pino（高性能，适合高并发）

  // 生产：JSON 到控制台；开发：美化输出
  const pino = require('pino');
  const logger = pino(
    process.env.NODE_ENV === 'production'
      ? { level: 'warn', transport: { target: 'pino/file', options: { destination: '/var/log/app.log' } } }
      : { transport: { target: 'pino-pretty' } }
  );
  logger.info({ userId: 42 }, 'user login');
  

• 使用Winston（灵活多传输，便于按级别分流）

  // 按级别分流：error 单独文件，其他到 combined
  const winston = require('winston');
  const { combine, timestamp, json } = winston.format;
  
  const logger = winston.createLogger({
    level: 'info',
    format: combine(timestamp(), json()),
    transports: [
      new winston.transports.File({ filename: 'error.log', level: 'error' }),
      new winston.transports.File({ filename: 'combined.log' }),
    ],
  });
  if (process.env.NODE_ENV !== 'production') {
    logger.add(new winston.transports.Console({ format: winston.format.simple() }));
  }
  

• 运行时调整日志级别（示例思路）

  // 通过信号或管理接口动态修改 logger.level
  process.on('SIGUSR2', () => {
    const newLevel = logger.level === 'debug' ? 'info' : 'debug';
    logger.level = newLevel;
    logger.warn({ event: 'log_level_changed', to: newLevel });
  });
  

• HTTP请求日志（Morgan + 业务日志分离）

  const express = require('express');
  const morgan = require('morgan');
  const app = express();
  app.use(morgan('combined')); // 仅请求日志
  

以上示例覆盖了库选型、级别分流、开发/生产差异化输出与动态调级的常见落地方式。

三 文件轮转与存储策略

• 应用内轮转（适合容器/单实例，便于随进程启停）

  // Winston Daily Rotate File
  const DailyRotateFile = require('winston-daily-rotate-file');
  const rotateTransport = new DailyRotateFile({
    filename: '/var/log/app-%DATE%.log',
    datePattern: 'YYYY-MM-DD',
    zippedArchive: true,
    maxSize: '20m',
    maxFiles: '14d',
  });
  logger.add(rotateTransport);
  

• 系统级轮转（适合系统服务/物理机，运维统一策略）
  • 创建配置：/etc/logrotate.d/nodeapp

    /var/log/app*.log {
      daily
      rotate 14
      compress
      missingok
      notifempty
      copytruncate
      su node node
    }
    

  • 说明：选择copytruncate可避免应用重新打开文件句柄；若应用支持SIGHUP重开日志，可改用create策略。
• 分层与保留策略：按业务/级别/模块分文件或目录；保留近7–14天热数据，归档/冷备更久历史。
• 权限与合规：日志目录与文件设置为仅应用用户可读写（如node:node 600/644），避免敏感信息泄露。

四 性能与安全最佳实践

• 降低日志开销：生产默认warn/error；仅在排障时短时开启debug；避免在热路径拼接大对象与堆栈。
• 异步与非阻塞：优先使用异步传输/缓冲；批量写入、减少频繁fs.write；高吞吐场景优选Pino。
• 结构化与可观测性：统一JSON字段（如timestamp、level、msg、traceId、userId）；与ELK/Graylog或Loki集成，配合Prometheus/Grafana做错误率与延迟告警。
• 敏感信息防护：统一脱敏（如正则替换password|token|card），在日志格式化阶段剔除或掩码。
• 监控与容量规划：持续观察磁盘I/O、文件句柄、日志吞吐；设置磁盘阈值告警与自动清理任务。

五 快速检查清单