Node.js 日志优化与 Debian 系统实践

一 策略总览

• 选择合适的日志库：优先使用高性能、可扩展的库，如 Winston、Pino、Bunyan；HTTP 请求日志可配合 Morgan。
• 合理设置日志级别：开发环境用 debug，生产环境用 warn/error，避免过量日志影响性能。
• 使用结构化日志：统一采用 JSON，便于检索、分析与聚合。
• 避免阻塞：采用异步写入或批量写入策略，降低对主线程影响。
• 控制输出目标：区分 error 与 combined 等多目标输出，便于排错与审计。
• 实施日志轮换与压缩：防止单文件过大，控制磁盘占用。
• 集中式日志与监控：对接 ELK/Graylog 或 Elasticsearch Transport，结合 Prometheus/Grafana 做告警。
• 安全性：避免记录 密码、密钥、令牌 等敏感信息。

二 系统层日志轮换与保留

• 使用 logrotate 管理 Node.js 日志文件（适合 systemd 或 pm2 写入的文件）：

  1. 安装：sudo apt-get install logrotate
  2. 新建配置：/etc/logrotate.d/nodejs

  /var/log/nodejs/*.log {
      daily
      rotate 7
      compress
      missingok
      notifempty
      create 0644 node node
      copytruncate
  }
  

  3. 调试与强制执行：
     sudo logrotate -d /etc/logrotate.conf
     sudo logrotate -f /etc/logrotate.d/nodejs

• 若使用 PM2，可安装 pm2-logrotate 插件统一治理 PM2 输出：
  pm2 install pm2-logrotate

  建议设置：max_size=10M，retain=7，compress=true，dateFormat=YYYY-MM-DD

三 应用层日志配置示例

• 使用 Winston 按级别分流、按时间轮转并压缩归档：

  const winston = require('winston');
  const DailyRotateFile = require('winston-daily-rotate-file');
  
  const transport = new DailyRotateFile({
    filename: '/var/log/nodejs/app-%DATE%.log',
    datePattern: 'YYYY-MM-DD',
    zippedArchive: true,
    maxSize: '20m',
    maxFiles: '14d'
  });
  
  const logger = winston.createLogger({
    level: process.env.NODE_ENV === 'production' ? 'warn' : 'debug',
    format: winston.format.combine(
      winston.format.timestamp(),
      winston.format.json()
    ),
    transports: [
      new winston.transports.File({ filename: '/var/log/nodejs/error.log', level: 'error' }),
      transport
    ]
  });
  
  logger.info({ event: 'startup', pid: process.pid });
  logger.error('Unhandled error', { error: new Error('boom') });
  

• 使用 Pino 的高性能 JSON 日志（开发期可接入 pino-pretty 便于阅读）：

  const pino = require('pino');
  
  const logger = pino({
    level: process.env.NODE_ENV === 'production' ? 'warn' : 'debug',
    transport: process.env.NODE_ENV !== 'production'
      ? { target: 'pino-pretty', options: { colorize: true } }
      : undefined
  });
  
  logger.info({ event: 'request', method: 'GET', url: '/' });
  logger.error({ err: new Error('fail') }, 'Request failed');
  

• 使用 Log4js 按日切分并自动清理：

  const log4js = require('log4js');
  
  log4js.configure({
    appenders: {
      out: { type: 'stdout' },
      app: {
        type: 'file',
        filename: '/var/log/nodejs/app.log',
        pattern: 'yyyy-MM-dd',
        alwaysIncludePattern: true,
        daysToKeep: 90,
        compress: true
      }
    },
    categories: { default: { appenders: ['out', 'app'], level: 'info' } }
  });
  
  const logger = log4js.getLogger();
  logger.info('Hello, Log4js');
  

• 将日志发送到 Elasticsearch（便于集中检索与可视化）：

  const { ElasticsearchTransport } = require('winston-elasticsearch');
  
  const esTransport = new ElasticsearchTransport({
    client: new require('@elastic/elasticsearch').Client({ node: 'http://localhost:9200' }),
    index: 'nodejs-logs-%DATE%'
  });
  
  const logger = winston.createLogger({
    level: 'info',
    format: winston.format.json(),
    transports: [esTransport]
  });
  

四 性能与安全最佳实践

• 控制日志级别与采样：生产以 warn/error 为主；对高频 debug/trace 采用采样或动态降级。
• 减少阻塞：优先异步写入；必要时使用批量/缓冲与 backpressure 策略。
• 统一结构化格式：始终输出 timestamp、level、msg、service/app、trace_id 等关键字段，便于聚合。
• 异常与未捕获处理：注册 uncaughtException、unhandledRejection，在退出前确保关键日志落盘。
• 敏感信息脱敏：日志中屏蔽 password、token、credit_card 等字段。
• 资源与保留策略：按业务重要性设置 maxSize、maxFiles、daysToKeep，并定期清理归档。
• 集中式治理与告警：对接 ELK/Graylog，结合 Prometheus/Grafana 对错误率、延迟、磁盘占用设阈值告警。

五 快速检查清单