Debian系统Node.js日志记录最佳实践

Debian系统Node.js日志记录最佳实践

1. 选择高性能日志库

   • 推荐 Pino：高性能、低开销，支持JSON格式和异步日志，适合生产环境。
   • 或 Winston：灵活支持多传输（文件、控制台等）、日志级别和格式化，适合复杂场景。

2. 合理配置日志级别

   • 开发环境：使用 DEBUG 级别记录详细信息，便于调试。
   • 生产环境：默认 INFO 或 WARN 级别，减少不必要的I/O开销，关键错误用 ERROR。
   • 通过环境变量动态调整级别，例如：

     const level = process.env.NODE_ENV === 'production' ? 'warn' : 'debug';
     

3. 结构化日志与格式化

   • 采用 JSON格式 记录日志，包含时间戳、日志级别、请求ID等上下文信息，便于分析。
   • 示例（Winston）：

     format: winston.format.combine(
       winston.format.timestamp(),
       winston.format.json()
     )
     

4. 日志轮转与存储

   • 使用 logrotate 工具或库（如 winston-daily-rotate-file）自动切割日志，避免文件过大。
   • 配置示例（logrotate）：

     /var/log/app.log {
       daily
       rotate 7
       compress
       missingok
     }
     

5. 集中式日志管理

   • 集成 ELK Stack（Elasticsearch + Logstash + Kibana）或 Grafana Loki，实现日志的集中存储、搜索和可视化。
   • 通过Winston传输将日志发送至Logstash：

     new winston.transports.Http({ host: 'logstash-server', port: 5044 })
     

6. 性能优化

   • 启用 异步日志记录，避免阻塞主线程（Pino默认异步，Winston需配置）。
   • 生产环境中关闭 敏感信息（如密码、密钥）的日志记录，防止泄露。

7. 异常处理与监控

   • 捕获未处理的异常并记录到独立文件，例如：

     process.on('uncaughtException', (err) => {
       logger.error('Uncaught Exception:', err);
       process.exit(1);
     });
     

   • 结合监控工具（如Prometheus + Grafana）实时分析日志中的错误趋势。