Ubuntu中Node.js日志存储的常见方法及路径
Node.js内置的console模块(console.log()、console.error()等)默认将日志输出到应用程序运行的控制台(终端)。若通过SSH连接服务器,可直接查看实时日志;若将应用放到后台运行(如node app.js &),日志会保留在当前终端会话中,但关闭会话后日志会丢失。
通过Node.js的fs模块或第三方日志库(如winston、bunyan)将日志写入指定文件,实现持久化存储。
fs模块:使用createWriteStream创建可写流,追加日志到文件。const fs = require('fs');
const logFile = fs.createWriteStream('./logs/app.log', { flags: 'a' }); // 'a'表示追加模式
global.console = new console.Console(logFile, logFile); // 重定向console输出到文件
console.log('This log will be saved to app.log');
winston为例):支持多传输方式(文件、控制台、JSON格式等),更灵活。const winston = require('winston');
const logger = winston.createLogger({
level: 'info',
format: winston.format.json(),
transports: [
new winston.transports.File({ filename: './logs/error.log', level: 'error' }), // 错误日志单独存储
new winston.transports.File({ filename: './logs/combined.log' }), // 所有日志合并
new winston.transports.Console() // 同时输出到控制台(开发环境推荐)
]
});
logger.info('Server started on port 3000');
上述配置会将错误日志写入./logs/error.log,所有日志写入./logs/combined.log。通过syslog模块将Node.js日志发送到Ubuntu的系统日志服务(rsyslog),统一管理应用日志。
syslog模块发送日志到系统日志。const syslog = require('syslog');
syslog.openlog('my-node-app', { facility: 'local0' }); // 'local0'为自定义设施(facility)
syslog.syslog('info', 'Application started successfully'); // 发送info级别日志
syslog.closelog();
/etc/rsyslog.d/50-default.conf(或新建.conf文件),添加以下内容捕获local0设施的日志:local0.* /var/log/my-node-app.log // 将local0设施的所有日志写入/var/log/my-node-app.log
重启rsyslog服务使配置生效:sudo systemctl restart rsyslog
日志将存储在/var/log/my-node-app.log中。PM2是Node.js常用的进程管理工具,可自动管理应用日志(包括标准输出、错误输出),支持日志轮转、实时查看等功能。
sudo npm install pm2 -g // 全局安装PM2
pm2 start app.js --name my-app // 启动应用并命名为"my-app"
pm2 logs my-app // 实时查看应用日志(包含stdout和stderr)
pm2 logs my-app --lines 100 // 查看最近100行日志
.pm2/logs/文件夹下,文件名为<app-name>-out.log(标准输出)和<app-name>-err.log(错误输出)。例如:~/.pm2/logs/my-app-out.log
~/.pm2/logs/my-app-err.log
pm2 set pm2:logrotate:max_size 10M设置单个日志文件最大大小(如10MB),超过后会自动压缩并创建新文件。当日志文件过大时,需通过日志轮转工具(如logrotate)压缩、删除旧日志,释放空间。
logrotate:创建/etc/logrotate.d/nodejs文件,添加以下内容:/var/log/nodejs/*.log { // 匹配/var/log/nodejs目录下的所有.log文件
daily // 每天轮转一次
missingok // 若日志文件不存在也不报错
rotate 7 // 保留最近7天的日志
compress // 压缩旧日志(如.gz格式)
notifempty // 若日志为空则不轮转
create 0640 root adm // 创建新日志文件时设置权限和所有者
}
该配置会自动管理/var/log/nodejs/目录下的日志文件,保留7天内的压缩日志。对于需要集中管理、搜索、分析日志的生产环境,可使用ELK Stack(Elasticsearch + Logstash + Kibana):
input配置,监听Node.js应用的日志文件(如/var/log/myapp.log)。winston-logstash等库将日志发送到Logstash。const winston = require('winston');
const winstonLogstash = require('winston-logstash');
const logger = winston.createLogger({
transports: [
new winstonLogstash({
port: 5000, // Logstash监听的端口
host: 'localhost' // Logstash服务器地址
})
]
});
http://localhost:5601,配置索引模式即可搜索、分析日志。