如何设置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应用构建一个高效、可维护、安全的日志记录策略，满足不同环境的监控与分析需求。

0 赞

0 踩