Ubuntu下使用Node.js进行日志管理的完整指南

在Ubuntu系统中，对Node.js应用的日志实施系统化管理，既能从基础的输出控制到企业级的集中分析，每个阶段都有成熟的解决方案。以下将逐步梳理如何高效地做好日志管理工作。

一、基础日志记录：使用内置console模块

console模块是Node.js自带的工具，操作简单直接，特别适合开发阶段调试。借助console.log()、console.error()等方法，可以将不同级别的日志输出到控制台。以Express应用为例：

const express = require('express');
const app = express();

app.get('/', (req, res) => {
  console.log('收到GET请求'); // 信息日志
  res.send('Hello World!');
});

app.listen(3000, () => {
  console.log('服务器运行在 http://localhost:3000'); // 启动日志
});

不过，它的局限性也很显著：日志无法持久化存储，也缺少级别过滤功能。生产环境下，建议借助专业的日志库来满足更复杂的需求。

二、第三方日志库：结构化与高级功能支持

1. Winston（最流行）

Winston支持多种传输目标（控制台、文件、HTTP等）、日志级别（debug/info/warn/error）以及JSON格式化，非常适合复杂应用。安装过程很简单：

npm install winston

配置示例如下：

const winston = require('winston');

const logger = winston.createLogger({
  level: 'info', // 最低日志级别
  format: winston.format.json(), // 结构化日志（便于后续分析）
  transports: [
    new winston.transports.File({ filename: 'error.log', level: 'error' }), // 错误日志单独存储
    new winston.transports.File({ filename: 'combined.log' }), // 所有日志合并
    // 非生产环境输出到控制台（简化格式）
    ...(process.env.NODE_ENV !== 'production'
      ? [new winston.transports.Console({ format: winston.format.simple() })]
      : [])
  ]
});

// 使用示例
logger.info('服务器启动成功');
logger.error('数据库连接失败');

2. Bunyan（JSON格式原生支持）

Bunyan原生输出结构化JSON格式日志，便于与ELK等日志分析工具集成，尤其适合生产环境。安装命令：

npm install bunyan

配置示例如下：

const bunyan = require('bunyan');

const logger = bunyan.createLogger({
  name: 'my-app', // 应用名称（日志标识）
  level: 'info',
  streams: [
    { level: 'info', stream: process.stdout }, // 控制台输出
    { level: 'error', path: 'app-error.log' } // 错误日志写入文件
  ]
});

// 使用示例
logger.info('用户登录成功', { userId: 123 }); // 可附加额外字段
logger.error('订单创建失败', { orderId: 456, error: '库存不足' });

3. Pino（高性能首选）

Pino以极快的日志记录速度著称，适合高并发场景，日志同样采用JSON格式。安装方法：

npm install pino pino-pretty

配置示例如下：

const pino = require('pino');
const pinoPretty = require('pino-pretty');

const logger = pino({ level: 'info' }, pinoPretty({ colorize: true })); // 输出美化

// 使用示例
logger.info('API请求处理完成', { method: 'GET', path: '/api/users' });
logger.error('支付接口超时', { transactionId: 'abc123', timeout: 5000 });

三、日志轮转：防止日志文件过大

日志文件若不加以管理，会快速占用磁盘空间。此时需要引入轮转机制，按照一定规则分割文件并压缩旧日志，从而节省存储空间。常用的工具有两种：

1. Winston-Daily-Rotate-File（Winston扩展）

该插件专为Winston设计，支持按天/小时分割、压缩以及自定义保留天数。安装命令：

npm install winston-daily-rotate-file

配置示例如下：

const winston = require('winston');
const DailyRotateFile = require('winston-daily-rotate-file');

const transport = new DailyRotateFile({
  filename: 'application-%DATE%.log', // 文件名模板（%DATE%为日期占位符）
  datePattern: 'YYYY-MM-DD', // 按天分割
  zippedArchive: true, // 压缩旧日志（.gz格式）
  maxSize: '20m', // 单个文件最大20MB
  maxFiles: '14d' // 保留14天日志
});

const logger = winston.createLogger({
  level: 'info',
  format: winston.format.json(),
  transports: [transport]
});

2. Logrotate（系统级工具）

Ubuntu自带的日志轮转工具，可以管理Node.js及其他应用的日志文件，优点是不需要改动应用代码。配置步骤很清晰：

1. 创建Logrotate配置文件：

   sudo nano /etc/logrotate.d/nodejs

2. 添加以下内容（针对/var/log/nodejs/目录下的所有.log文件）：

   /var/log/nodejs/*.log {
       daily          # 每天轮转
       missingok      # 文件不存在时不报错
       rotate 7       # 保留7天日志
       compress       # 压缩旧日志（.gz格式）
       notifempty     # 日志为空时不轮转
       create 0640 root adm  # 新日志文件权限
   }

3. 测试配置是否生效：

   sudo logrotate -vf /etc/logrotate.d/nodejs

四、集中式日志管理：ELK Stack（可选）

当系统逐渐复杂，尤其是分布式架构下，集中管理日志变得必不可少。ELK Stack（Elasticsearch+Logstash+Kibana）是业界成熟的方案，能够实现集中存储、搜索和可视化分析。

1. 安装ELK组件

# 安装Elasticsearch
wget -qO - https://artifacts.elastic.co/GPG-KEY-elasticsearch | sudo apt-key add -
echo "deb https://artifacts.elastic.co/packages/7.x/apt stable main" | sudo tee /etc/apt/sources.list.d/elastic-7.x.list
sudo apt update && sudo apt install elasticsearch

# 安装Logstash
sudo apt install logstash

# 安装Kibana
sudo apt install kibana

2. 配置Logstash接收Node.js日志

创建Logstash配置文件（/etc/logstash/conf.d/nodejs.conf）：

input {
  file {
    path => "/var/log/nodejs/*.log"
    start_position => "beginning"
    sincedb_path => "/dev/null"
  }
}

filter {
  json {
    source => "message"  # 解析JSON格式日志
  }
}

output {
  elasticsearch {
    hosts => ["localhost:9200"]
    index => "nodejs-logs-%{+YYYY.MM.dd}"
  }
  stdout { codec => rubydebug }  # 控制台输出（调试用）
}

3. 启动ELK服务

sudo systemctl start elasticsearch
sudo systemctl start logstash
sudo systemctl start kibana

访问http://localhost:5601（Kibana）即可查看、分析日志。

五、进程管理工具：PM2（日志管理辅助）

PM2是Node.js进程管理工具，支持自动重启、资源监控，同时也能集中管理日志：包括集中存储、实时查看和日志轮转，一次完成。

1. 安装与启动应用

sudo npm install pm2 -g   # 全局安装
pm2 start app.js --name "my-app"  # 启动应用并命名

2. 日志查看与导出

# 实时查看所有日志（合并stdout和stderr）
pm2 logs my-app

# 查看特定日志文件（默认路径：~/.pm2/logs/）
pm2 logs my-app --lines 100  # 显示最后100行

# 导出日志到文件
pm2 logs my-app > my-app.log

3. 日志轮转配置

PM2内置日志轮转功能，通过pm2 set命令即可开启：

pm2 set pm2:log_rotate true  # 开启轮转
pm2 set pm2:log_size 10M     # 单个文件最大10MB
pm2 set pm2:log_retain 7     # 保留7天日志

从开发调试到生产运维，以上方法可以帮助你在Ubuntu系统中把Node.js日志管理得井井有条。无论是简单的本地记录，还是复杂的集中分析，都有对应的成熟工具和方案，这样才能让日志真正为你的应用保驾护航。