Node.js 在 Linux 上的日志管理策略

Node.js 应用在 Linux 上的日志管理通常遵循**“应用层 + 系统层 + 运维层”三层结合的策略。下面从基本原则、常见方案、具体实践**几个层面系统说明。

一、Node.js 日志管理的基本原则

分级输出
- error：异常、崩溃
- warn：可预期但不正常
- info：业务流程
- debug：调试信息（生产环境关闭）

结构化日志（推荐 JSON）

便于 ELK / Loki 解析

示例：

{
  "level": "error",
  "message": "DB connection failed",
  "service": "user-service",
  "time": "2026-01-20T10:01:00.000Z"
}

不要只写 console.log
- 不可控、不可分级、不可轮转
日志与业务解耦
- 日志不应阻塞主流程
- 不写同步磁盘 I/O

二、Node.js 应用层日志方案

1️⃣ 主流日志库

库	特点
Winston	最常用，插件多
Pino	高性能，JSON 友好
Bunyan	JSON 原生，偏老
Morgan	HTTP 请求日志

✅ 推荐组合

HTTP 日志：Morgan
应用日志：Pino 或 Winston

2️⃣ 示例：Pino（生产推荐）

const pino = require('pino');
const logger = pino({
  level: 'info',
  transport: {
    target: 'pino-pretty', // 本地开发
  },
});

logger.info('Server started');
logger.error({ err }, 'DB error');

生产环境：

const logger = pino({
  level: 'info',
});

Pino 输出到 stdout，由 Linux 处理日志写入。

3️⃣ 日志输出到 stdout / stderr

✅ 最佳实践

stdout → info / debug
stderr → error / warn

app stdout → systemd / Docker → log system

三、Linux 系统层日志管理

1️⃣ systemd（最常见）

Node.js 作为 systemd 服务运行：

[Service]
ExecStart=/usr/bin/node /app/server.js
StandardOutput=journal
StandardError=journal

查看日志：

journalctl -u app -f

✅ 优点

自动轮转
与系统日志统一
支持按时间查询

2️⃣ 文件 + logrotate（传统方式）

应用写入文件：

{
  transports: [
    new winston.transports.File({ filename: '/var/log/app/app.log' })
  ]
}

/etc/logrotate.d/app：

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

⚠️ 不推荐用于高并发场景（文件锁、性能）

四、生产环境推荐架构（标准方案）

✅ 方案一：Node → stdout → systemd → journald

Node.js
  ↓ stdout
systemd
  ↓ journald
  ↓
journalctl / 转发到 ELK

✅ 优点

简单
稳定
运维友好

✅ 方案二：Node → stdout → Docker → 日志驱动

Node.js
  ↓ stdout
Docker
  ↓ json-file / syslog / journald

docker logs app

✅ 方案三：集中式日志（中大型系统）

Node.js → stdout
        → Filebeat / Fluent Bit
        → Elasticsearch / Loki
        → Kibana / Grafana

五、日志内容建议

✅ 必须包含

时间戳（ISO 8601）
日志级别
服务名
请求 ID（traceId）
错误信息 + stack

✅ HTTP 日志

GET /api/user 200 32ms

六、常见坑与优化建议

❌ 常见错误

console.log 写满磁盘
日志异步但写本地文件
日志中包含敏感信息（密码、token）

✅ 优化措施

控制日志级别（生产不要 debug）
限制单条日志大小
敏感字段脱敏
使用 traceId 关联请求链路

七、推荐组合总结

✅ 小型项目

Pino + systemd
journalctl 查看

✅ 中型项目

Pino + Docker
json-file / journald

✅ 大型项目

Pino / Winston
stdout
Fluent Bit → ELK / Loki

如果你愿意，我可以：

✅ 给你一个 systemd + Pino 的完整示例
✅ 设计 K8s 下的 Node.js 日志方案
✅ 对比 Winston vs Pino 性能选型

你可以直接告诉我你的部署方式（裸机 / Docker / K8s）。