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('服务器运行在 https://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及其他应用的日志文件，优点是不需要改动应用代码。配置步骤很清晰：
- 创建Logrotate配置文件：
sudo nano /etc/logrotate.d/nodejs - 添加以下内容（针对
/var/log/nodejs/目录下的所有.log文件）：/var/log/nodejs/*.log { daily # 每天轮转 missingok # 文件不存在时不报错 rotate 7 # 保留7天日志 compress # 压缩旧日志（.gz格式） notifempty # 日志为空时不轮转 create 0640 root adm # 新日志文件权限 } - 测试配置是否生效：
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 kibana2. 配置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访问https://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.log3. 日志轮转配置
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日志管理得井井有条。无论是简单的本地记录，还是复杂的集中分析，都有对应的成熟工具和方案，这样才能让日志真正为你的应用保驾护航。
