如何设置Ubuntu Node.js日志记录策略

如何设置Ubuntu Node.js日志记录策略

在Ubuntu系统上为Node.js应用设置日志记录策略，需围绕日志库选择、日志级别控制、日志轮转、结构化日志、异步记录及监控等核心环节展开，以下是具体步骤：

1. 选择合适的日志库

Node.js生态中有多个成熟的日志库，可根据需求选择：

• Winston：功能全面，支持多传输方式（控制台、文件、HTTP等），适合需要高度自定义的场景；
• Pino：以高性能著称，输出JSON格式日志，适合高并发生产环境；
• Bunyan：结构化日志支持好，日志格式规范，便于后续分析；
• Morgan：专为Express应用设计，用于记录HTTP请求日志。
  示例（安装Winston）：

npm install winston

2. 配置日志级别

根据环境（开发/生产）设置不同日志级别，避免记录无关信息影响性能：

• 开发环境：使用debug或verbose，输出详细信息便于调试；
• 生产环境：使用warn或error，仅记录关键问题。
  可通过环境变量、配置文件或代码设置：
• 环境变量（推荐）：

  const logLevel = process.env.LOG_LEVEL || 'info';
   // 默认info
  const logger = winston.createLogger({
   level: logLevel }
      );
  
  

  启动应用时指定环境变量：

  export LOG_LEVEL=debug
  node app.js
  

• 配置文件（如config.json）：

  {
   "logLevel": "debug" }
      
  

  代码中读取：

  const config = require('./config.json');
  
  const logger = winston.createLogger({
   level: config.logLevel }
      );
  
  

3. 实现日志轮转

防止日志文件过大占用磁盘空间，可使用Winston插件或Ubuntu系统工具：

• Winston-daily-rotate-file（推荐）：按天分割日志文件，支持压缩和保留天数设置。
  安装：

  npm install winston-daily-rotate-file
  

  配置：

  const {
   createLogger, format, transports }
       = require('winston');
      
  const DailyRotateFile = require('winston-daily-rotate-file');
  
  
  const logger = createLogger({
  
    level: 'info',
    format: format.combine(format.timestamp(), format.json()),
    transports: [
      new DailyRotateFile({
  
        filename: '/var/log/nodejs/app-%DATE%.log', // 日志路径（带日期后缀）
        datePattern: 'YYYY-MM-DD', // 按天分割
        zippedArchive: true, // 压缩旧日志
        maxSize: '20m', // 单个文件最大20MB
        maxFiles: '14d' // 保留14天
      }
  ),
      new DailyRotateFile({
  
        filename: '/var/log/nodejs/app-error-%DATE%.log',
        datePattern: 'YYYY-MM-DD',
        level: 'error', // 仅记录error级别日志
        zippedArchive: true,
        maxFiles: '30d'
      }
  )
    ]
  }
      );
  
  

• Ubuntu Logrotate：系统级日志轮转工具，适用于所有日志文件。
  创建配置文件/etc/logrotate.d/nodejs：

  /var/log/nodejs/*.log {
  
    daily
    rotate 7
    missingok
    notifempty
    compress
    delaycompress
    sharedscripts
    postrotate
      systemctl restart your-node-app.service # 可选：重启应用以释放文件句柄
    endscript
  }
  
  

4. 结构化日志输出

采用JSON格式记录日志，便于后续用ELK（Elasticsearch+Logstash+Kibana）、Graylog等工具分析。
Winston示例：

const logger = winston.createLogger({

  format: format.combine(
    format.timestamp({
 format: 'YYYY-MM-DD HH:mm:ss' }
), // 添加时间戳
    format.json() // 输出JSON
  ),
  transports: [new transports.Console(), new transports.File({
 filename: 'combined.log' }
)]
}
    );

日志输出示例：

{

  "timestamp": "2025-10-09 10:00:00",
  "level": "info",
  "message": "Application started"
}

5. 异步日志记录

确保日志记录不阻塞主线程，提升应用性能。Winston、Pino等库均默认支持异步，无需额外配置。

6. 集成进程管理工具（如PM2）

使用PM2管理Node.js进程时，可借助其内置日志功能：

• 自动管理日志：PM2会自动聚合多进程日志，支持日志轮转；
• 配置日志级别：通过ecosystem.config.js设置：

  module.exports = {
  
    apps: [{
  
      name: 'my-app',
      script: 'app.js',
      env: {
  
        NODE_ENV: 'production',
        LOG_LEVEL: 'info'
      }
  ,
      log_date_format: 'YYYY-MM-DD HH:mm Z', // 日志时间格式
      merge_logs: true // 合并多进程日志
    }
  ]
  }
      ;
      
  

  启动应用：

  pm2 start ecosystem.config.js --env production
  

7. 监控与警报

集成监控工具实时分析日志，设置警报规则：

• Prometheus+Grafana：通过日志采集器（如Loki）收集日志，可视化日志指标（如错误率）；
• Sentry：捕获应用异常日志，发送邮件/Slack警报；
• 自定义脚本：用cron定时分析日志文件，如统计错误次数超过阈值时发送邮件。

8. 日志安全与权限管理

• 限制日志文件权限：确保只有授权用户可访问日志文件：

  sudo chown -R root:adm /var/log/nodejs/
  sudo chmod -R 640 /var/log/nodejs/*.log
  

• 避免敏感信息泄露：代码中不要记录密码、密钥等敏感信息，可使用winston-mask等库自动屏蔽敏感字段。

通过以上步骤，可在Ubuntu系统上为Node.js应用构建一个高效、可维护、安全的日志记录策略，满足不同环境的监控与分析需求。

声明：本文内容由网友自发贡献，本站不承担相应法律责任。对本内容有异议或投诉，请联系2913721942#qq.com核实处理，我们将尽快回复您，谢谢合作！