阅读量:4
1. 选择合适的日志库
Node.js生态中有多个成熟的日志库，可根据需求选择：
- Winston：功能全面，支持多传输（文件、控制台、HTTP等）、灵活格式化（JSON、文本）及日志级别控制，是通用场景的首选；
- Pino：以高性能著称，适合对日志写入速度要求高的场景（如实时应用）；
- Bunyan：专注结构化JSON日志输出，便于后续自动化处理（如日志分析）；
- Log4js：提供日志轮换、压缩等内置功能，适合需要简化配置的场景。
示例（Winston基础配置）：
const winston = require('winston');
const logger = winston.createLogger({
level: 'info',
format: winston.format.json(), // 结构化日志
transports: [
new winston.transports.Console(), // 控制台输出
new winston.transports.File({ filename: 'error.log', level: 'error' }), // 错误日志单独存储
new winston.transports.File({ filename: 'combined.log' }) // 所有日志合并
]
});
2. 配置合理的日志级别
根据环境调整日志级别，避免无关日志占用资源：
- 开发环境：使用
debug或trace级别，记录详细信息（如请求参数、数据库查询），便于调试； - 生产环境：使用
error或warn级别，仅记录错误和警告信息，减少日志体积。
示例（通过环境变量动态设置）：
const logger = winston.createLogger({
level: process.env.NODE_ENV === 'production' ? 'error' : 'debug', // 生产环境仅记录error
// ...其他配置
});
3. 实现日志轮转与压缩
防止日志文件过大导致磁盘空间耗尽，推荐使用winston-daily-rotate-file库或Ubuntu系统工具logrotate：
- Winston内置轮转：
const { DailyRotateFile } = require('winston-daily-rotate-file');
const logger = winston.createLogger({
transports: [
new DailyRotateFile({
filename: 'application-%DATE%.log', // 按日期命名（如application-2025-11-04.log）
datePattern: 'YYYY-MM-DD', // 日期格式
zippedArchive: true, // 自动压缩旧日志（.gz格式）
maxSize: '20m', // 单个日志文件最大20MB
maxFiles: '14d' // 保留14天内的日志
})
]
});
- Logrotate配置（系统级工具）：
创建/etc/logrotate.d/nodejs文件，添加以下内容：
/var/log/nodejs/*.log {
daily # 每天轮转
rotate 7 # 保留7天
compress # 压缩旧日志
missingok # 文件不存在时不报错
notifempty # 日志为空时不轮转
create 0640 root adm # 新日志文件权限
}
4. 集中式日志管理
将日志发送到集中式系统（如ELK Stack、Graylog），便于统一存储、搜索和分析：
- ELK Stack配置示例（Winston发送日志到Elasticsearch）：
const { ElasticsearchTransport } = require('winston-elasticsearch');
const logger = winston.createLogger({
transports: [
new ElasticsearchTransport({
client: {
host: 'http://localhost:9200', // Elasticsearch地址
logLevel: 'info'
}
})
]
});
- PM2集成：使用PM2管理Node.js进程，其内置日志聚合功能可通过
pm2 logs命令实时查看所有应用的日志。
5. 异步日志记录
避免同步日志写入阻塞主线程，影响应用性能。大多数日志库（如Winston、Pino）默认支持异步，无需额外配置。示例（Winston异步写入）：
const logger = winston.createLogger({
transports: [
new winston.transports.File({ filename: 'async.log' }) // 默认异步
]
});
6. 结构化日志格式
使用JSON格式记录日志，便于后续通过工具（如ELK、Grafana）解析和分析。示例（Winston JSON格式化）：
const logger = winston.createLogger({
format: winston.format.combine(
winston.format.timestamp(), // 添加时间戳
winston.format.json() // 转换为JSON格式
),
transports: [
new winston.transports.File({ filename: 'structured.log' })
]
});
// 输出示例：{"timestamp":"2025-11-04T12:00:00.000Z","level":"info","message":"Server started"}
7. 监控与报警
结合监控工具（如Prometheus+Grafana、ELK Alerts）实时监控日志，设置报警阈值（如错误日志数量超过10条/分钟时触发邮件报警）。示例（Prometheus监控Node.js指标）：
const promClient = require('prom-client');
const httpRequestDurationMicroseconds = new promClient.Histogram({
name: 'http_request_duration_ms',
help: 'Duration of HTTP requests in ms',
buckets: [0.1, 5, 15, 50, 100, 200, 500] // 桶边界
});
// 在路由中记录指标
app.use((req, res, next) => {
const start = Date.now();
res.on('finish', () => {
httpRequestDurationMicroseconds.observe({
method: req.method,
path: req.path,
status: res.statusCode
}, Date.now() - start);
});
next();
});
8. 安全性保障
- 敏感信息过滤：避免在日志中记录密码、密钥等敏感信息，可使用
winston-deny库过滤特定字段； - 日志文件权限：设置合理的文件权限（如
0640），仅允许必要用户访问日志文件； - 加密存储：对敏感日志（如用户操作日志）进行加密，防止泄露。
以上就是关于“Node.js在Ubuntu上的日志记录最佳实践”的相关介绍，筋斗云是国内较早的云主机应用的服务商，拥有10余年行业经验，提供丰富的云服务器、租用服务器等相关产品服务。云服务器资源弹性伸缩，主机vCPU、内存性能强悍、超高I/O速度、故障秒级恢复；电子化备案，提交快速，专业团队7×24小时服务支持！
简单好用、高性价比云服务器租用链接：https://www.jindouyun.cn/product/cvm