Linux环境下 Node.js 日志管理最佳实践
一 日志分级与输出策略
- 明确并统一使用日志级别：DEBUG、INFO、WARN、ERROR、FATAL，在开发环境开启更详细的 DEBUG，在生产环境优先输出 WARN/ERROR 以降低 I/O 与存储压力。
- 采用结构化日志：优先使用 JSON 格式，便于检索、聚合与可视化；在控制台开发时可用简洁/美化输出辅助排查。
- 使用高性能日志库：如 winston、pino、bunyan；结合环境或配置动态切换日志级别，避免频繁改动代码。
二 日志轮转与保留策略
- 应用内轮转：在 Node.js 中使用如 winston-daily-rotate-file 或 pino-rotate，按时间/大小切分，并启用压缩与保留天数，示例：
- winston-daily-rotate-file：按天或小时切分，配置 zippedArchive: true、maxSize、maxFiles。
- pino-rotate：配置 period、limit、compress。
- 系统级轮转：使用 logrotate 管理落盘日志，典型配置示例：
- 路径与策略：/path/to/your_app.log { daily、rotate 7、compress、delaycompress、missingok、notifempty、create 640 root adm }
- 测试与生效：使用 logrotate -f /etc/logrotate.d/your_app 验证；通常由 /etc/cron.daily/logrotate 每日自动执行。
- 保留建议：结合合规与故障复盘周期设置保留天数（如 7–14 天），压缩旧日志以节省空间。
三 性能优化与异步写入
- 避免同步写：确保日志写入为异步，防止阻塞事件循环；高并发场景关注日志库的性能与队列行为。
- 批量与缓冲：开启批量写入与缓冲，减少 I/O 次数；根据内存与延迟目标合理设置缓冲区大小。
- 减少冗余：避免高频循环/热点路径中的日志；精简字段，生产以 JSON 为主、控制台以可读格式为辅。
四 集中化与监控告警
- 集中式日志：将日志发送至 ELK Stack（Elasticsearch、Logstash、Kibana）、Graylog 或 Fluentd，统一索引、检索、可视化与仪表盘。
- 错误直达：在 Node.js 中可将错误日志直接写入 Elasticsearch 等存储，缩短故障定位时间。
- 监控与告警：基于 Prometheus + Grafana 监控日志量、磁盘使用、错误率等指标，配置阈值与通知渠道，及时发现异常。
五 安全合规与容量治理
- 最小化敏感信息：避免记录密码、令牌、密钥、PII；必要时对日志做脱敏或加密。
- 文件权限与访问控制：限制日志文件访问权限（如 640 root adm），仅授权运维/安全人员读取。
- 容量治理与应急：
- 定期清理/归档：按保留策略清理旧日志，必要时 rsync 归档至备份存储。
- 日志量突增处置：临时提升日志级别、关闭冗余调试、分析高频来源并优化代码；必要时扩容磁盘或分流。
- 审计与合规：建立访问审计与保留周期策略，满足安全与合规要求。
