Node.js 日志在 Debian 上的最佳实践
一 基础选型与环境策略
- 选择日志库：优先使用成熟的日志库，如 Winston（功能全面、可多传输）、Pino（高性能、低开销，适合高并发）、Bunyan（默认结构化 JSON）、Log4js（功能丰富、支持多种 Appender）。
- 结构化与元数据：生产环境建议使用 JSON 格式，并统一携带 timestamp、level、request_id、user_id 等元数据，便于检索与分析。
- 日志级别与环境：通过环境变量控制级别，开发环境用 debug/verbose，生产环境用 info/warn/error，避免冗余输出影响性能。
- 避免仅用 console：内置 console 缺少级别、轮转与格式化，生产环境应使用日志库或将输出交由进程管理器/系统日志处理。
二 本地落盘与轮转配置
- 推荐目录与权限：将日志写入 /var/log/node-app/ 等专用目录，设置属主为运行用户（如 nodeuser:nodegroup），权限 640，避免其他用户读取；必要时使用 logrotate 的 create 0640 root adm 策略。
- 系统级轮转 logrotate（推荐）：在 /etc/logrotate.d/nodejs 中配置按日轮转、压缩与保留天数，示例：
/var/log/node-app/*.log {
daily
rotate 7
compress
delaycompress
missingok
notifempty
create 0640 root adm
}
测试与强制执行：logrotate -d /etc/logrotate.d/nodejs（干跑），logrotate -f /etc/logrotate.d/nodejs（强制）。
- 应用内轮转：使用 winston-daily-rotate-file 等插件按天/大小分割，示例：
new DailyRotateFile({ filename: ‘application-%DATE%.log’, datePattern: ‘YYYY-MM-DD’, zippedArchive: true, maxSize: ‘20m’, maxFiles: ‘14d’ })。
三 进程管理与实时查看
- 使用 PM2 管理进程与日志：
- 启动命令：pm2 start app.js --name “my-app” --error ./logs/error.log --output ./logs/output.log --log-date-format “YYYY-MM-DD HH:mm Z”
- 配置文件（ecosystem.config.js）：设置 error_file、out_file、log_date_format
- 常用命令：pm2 logs（实时查看）、pm2 logs my-app（指定应用）、pm2 flush（清空日志）
- 开发/调试：结合 tail -f app.log、grep 过滤关键字（如 error）快速定位问题。
四 集中式日志与可视化
- 方案选型：将日志发送到 ELK Stack（Elasticsearch+Logstash+Kibana）、Graylog 或 Fluentd，实现统一存储、检索、分析与告警。
- Winston 示例（发送至 Logstash）：
const LogstashTransport = require(‘winston-logstash’).Logstash;
new LogstashTransport({ host: ‘logstash.example.com’, port: 5000, node_name: ‘node-app’ });
- 错误跟踪：结合 Sentry 等平台做异常聚合与告警，缩短 MTTR。
五 安全、性能与运维要点
- 敏感信息防护：在日志前对 密码、密钥、信用卡号 等字段进行脱敏或排除；确保日志文件权限最小化（如 640），防止未授权访问。
- 性能与异步：避免同步写日志阻塞事件循环；在高并发场景优先 Pino 或开启异步传输；必要时减少过度日志与堆栈打印。
- 监控与告警：结合 PM2 监控进程资源，使用 Grafana + Loki 或 Kibana 做可视化；对 error 级别日志设置告警策略。
