Linux Node.js 日志管理怎么做
小樊
38
2026-01-01 02:24:55
Linux 下 Node.js 日志管理实操指南
一 核心原则与选型
- 使用结构化日志：生产环境优先选择 JSON 格式，便于检索、聚合与分析；开发环境可同时输出可读文本到控制台。常用库包括 Winston、Pino、Bunyan、Log4js，其中 Pino 以高性能著称，适合高并发场景。日志级别建议按环境区分：生产设为 info/warn，开发可开启 debug。避免滥用 console，以免影响性能与可控性。
二 快速落地方案
- 使用 Winston 的文件与控制台输出（按级别分流）
- 安装：
npm i 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(‘上线完成’, { version: ‘1.2.3’ });
logger.error(‘异常发生’, { err: err.message, stack: err.stack });
- 使用 Pino（高吞吐、低开销）
- 安装：
npm i pino
- 配置与用法：
- const pino = require(‘pino’);
const logger = pino({ level: process.env.NODE_ENV === ‘production’ ? ‘info’ : ‘debug’ });
logger.info({ path: ‘/health’ }, ‘健康检查通过’);
logger.error({ err: err }, ‘请求处理失败’);
- 使用 PM2 运行与聚合日志
- 启动：
pm2 start app.js -n myapp
- 实时查看：
pm2 logs myapp
- 保存当前进程列表：
pm2 save
- PM2 提供多进程日志聚合与内置轮转能力，适合集群与多实例场景。
三 日志轮换与清理
- 应用内轮换（代码可控、与进程生命周期一致）
- Winston + DailyRotateFile（按天/按大小）
- const { createLogger, format, transports } = require(‘winston’);
const DailyRotateFile = require(‘winston-daily-rotate-file’);
const transport = new DailyRotateFile({
filename: ‘logs/app-%DATE%.log’,
datePattern: ‘YYYY-MM-DD’,
zippedArchive: true,
maxSize: ‘20m’,
maxFiles: ‘14d’,
});
const logger = createLogger({
level: ‘info’,
format: format.combine(format.timestamp(), format.json()),
transports: [transport, new transports.Console({ format: format.simple() })],
});
- Pino 生态：可使用 pino-rotate 等插件实现按周期/大小轮转与压缩。
- 系统级轮换（通用、与 Node 无关，适合容器/多进程）
- logrotate 配置示例（/etc/logrotate.d/nodejs）：
- /path/to/your/nodejs/logs/*.log {
daily
missingok
rotate 7
compress
notifempty
create 0640 root adm
}
- 定时清理（可选）：
0 0 * * * find /path/to/your/nodejs/logs -type f -name "*.log" -mtime +7 -delete
- 选择建议：单进程/容器优先应用内轮换；多实例/物理机混部优先系统级 logrotate，减少依赖与运维复杂度。
四 集中式日志与监控
- 将日志发送到 ELK Stack（Elasticsearch、Logstash、Kibana） 或 Graylog，便于检索、可视化与告警；也可使用 Fluentd 统一采集与转发。
- 示例：Winston 写入 Elasticsearch
- const { createLogger } = require(‘winston’);
const ElasticsearchTransport = require(‘winston-elasticsearch’);
const logger = createLogger({
level: ‘info’,
transports: [
new ElasticsearchTransport({
level: ‘info’,
clientOpts: { node: ‘http://localhost:9200’ },
index: ‘logs-app-%DATE%’,
}),
],
});
- 结合 Prometheus + Grafana 对错误率、延迟等关键指标做可视化与告警，形成“日志 + 指标”的一体化可观测性体系。
五 错误与异常治理
- 统一错误日志：在 try/catch 与 Promise.catch 中记录结构化错误；对未捕获异常与未处理拒绝进行兜底记录并安全退出。
- process.on(‘unhandledRejection’, (reason, promise) => {
logger.error(‘Unhandled Rejection’, { reason, promise });
// 视情况安全退出或降级
});
process.on(‘uncaughtException’, (err) => {
logger.error(‘Uncaught Exception’, { err, stack: err.stack });
// 记录后安全退出，由进程管理器重启
process.exit(1);
});
- 建议始终输出 timestamp、level、message、context（如 requestId、userId），便于追踪与定位。
