在Debian系统中,Node.js应用日志持续增长可能导致磁盘空间耗尽,影响系统稳定性和运维效率。以下是针对性强、易操作的解决方法,覆盖预防、自动化管理与应急处理:
logrotate是Debian自带的日志管理工具,可自动完成日志分割、压缩、删除,无需修改应用代码,适合大多数场景。
sudo apt-get update && sudo apt-get install logrotate -y
/etc/logrotate.d/
下新建文件(如nodejs
),添加以下内容(根据实际日志路径调整):/var/www/your-node-app/logs/*.log {
daily # 每日轮转(也可改为weekly/monthly)
rotate 7 # 保留最近7天的日志
compress # 压缩旧日志(节省空间)
delaycompress # 延迟1天压缩(避免影响最新日志读取)
missingok # 日志文件不存在时不报错
notifempty # 日志为空时不轮转
create 0640 www-data www-data # 新日志文件权限与属主(根据应用用户调整)
sharedscripts # 所有日志轮转完成后执行postrotate
postrotate
# 若使用PM2管理进程,需通知其重新打开日志
if [ -f /var/run/pm2.pid ]; then
pm2 reload logs
fi
endscript
}
sudo logrotate -d /etc/logrotate.d/nodejs
sudo logrotate -f /etc/logrotate.d/nodejs
app.log
会被切割为app.log.1.gz
(压缩)、app.log.2.gz
等,保留最近7天的压缩日志。若用PM2管理Node.js进程,可使用pm2-logrotate
插件,无需依赖系统logrotate,配置更灵活。
pm2 install pm2-logrotate
pm2 set pm2-logrotate:compress true # 启用压缩
pm2 set pm2-logrotate:rotateInterval '0 0 * * *' # 每天凌晨轮转(cron语法)
pm2 set pm2-logrotate:max_days 7 # 保留7天旧日志
pm2 set pm2-logrotate:max_size 1G # 单个日志文件最大1GB(可选)
配置后,PM2会自动处理日志轮转,无需额外操作。若需更细粒度的日志管理(如按大小、级别分割),可使用winston
或bunyan
等日志库,内置轮转功能。
winston
及winston-daily-rotate-file
插件:npm install winston winston-daily-rotate-file
配置日志轮转(单个文件最大10MB,保留7个):const winston = require('winston');
const { combine, timestamp, printf } = winston.format;
const logger = winston.createLogger({
level: 'info',
format: combine(
timestamp({ format: 'YYYY-MM-DD HH:mm:ss' }),
printf(({ timestamp, level, message }) => `${timestamp} [${level}]: ${message}`)
),
transports: [
new winston.transports.DailyRotateFile({
filename: '/var/www/your-node-app/logs/combined.log',
datePattern: 'YYYY-MM-DD', // 按日期分割
zippedArchive: true, // 压缩旧日志
maxSize: '10m', // 单个文件最大10MB
maxFiles: '7d', // 保留7天
createSymlink: true // 创建符号链接(方便访问最新日志)
}),
new winston.transports.Console() // 同时输出到控制台(开发环境有用)
]
});
logger.info('This is a log message with size-based rotation.');
这种方式适合需要自定义日志格式、级别或存储路径的场景。生产环境中,降低日志级别可大幅减少日志量(如从debug
改为info
或warn
)。
const logger = winston.createLogger({
level: process.env.NODE_ENV === 'production' ? 'warn' : 'debug', // 生产环境仅记录warn及以上
// ...其他配置
});
通过NODE_ENV
环境变量区分环境,避免生产环境输出大量无用调试日志。若日志已占用大量空间,可通过cron
定时任务定期删除旧日志(如30天前)。
crontab -e
0 2 * * * find /var/www/your-node-app/logs -type f -name "*.log" -mtime +30 -exec rm -f {} \;
此命令会删除logs
目录下30天前的.log
文件,释放磁盘空间。对于分布式或大型应用,建议使用ELK Stack(Elasticsearch+Logstash+Kibana)或Graylog等集中式日志系统,将日志发送至远程服务器存储、分析。
winston-elasticsearch
插件:npm install winston-elasticsearch
配置日志发送至Elasticsearch:const winston = require('winston');
const Elasticsearch = require('winston-elasticsearch');
const logger = winston.createLogger({
transports: [
new Elasticsearch({
level: 'info',
clientOpts: { node: 'http://your-elasticsearch-server:9200' }
})
]
});
集中式日志管理可实现日志聚合、实时分析、报警,适合团队协作和大规模应用。以上方法可根据应用规模、运维习惯选择组合使用(如logrotate+日志级别控制为基础方案,PM2插件适合PM2管理场景,集中式日志适合大型系统)。通过合理配置,可有效解决Debian下Node.js日志过大的问题。