Node.js在Ubuntu上如何优化日志

Node.js 在 Ubuntu 上的日志优化实践

一核心优化策略

使用成熟的日志库：优先选择 winston、pino、morgan，支持多级别、结构化输出与多目标传输，便于后续检索与分析。
合理设置日志级别：按环境区分，生产以 error/warn 为主，开发可开启 debug/verbose，避免产生过多日志。
统一日志格式：包含 timestamp、level、message、module/requestId 等关键字段；控制台输出可加颜色便于排查，文件输出建议 JSON 便于解析。
控制输出目标：区分 Console（开发/排障）与 File（持久化），避免重复打点与无效输出。
异步与非阻塞：确保日志写入不阻塞主线程，减少请求延迟与抖动。
监控与告警：结合 Prometheus + Grafana 或日志平台建立错误率、延迟等关键指标告警。
集中式日志：将日志汇聚到 ELK/Graylog/Fluentd，统一检索、可视化与长期留存。
定期清理与容量规划：通过轮转与保留策略控制磁盘占用，避免磁盘被日志打满。

二日志轮转与保留

应用内轮转（代码可控、进程内生效）：
- winston + winston-daily-rotate-file：按时间/大小切分，支持压缩与保留天数。
- pino-rotate：轻量方案，适合按天/大小归档。
系统级轮转（推荐用于系统服务与长期运行进程）：
- logrotate 管理 Node.js 应用日志文件，支持按日/大小切分、压缩、保留、延迟压缩、按日期后缀等。
- 若日志写入 syslog，需同步配置 /etc/logrotate.d/rsyslog，可设置按大小触发轮转（如 200M）并指定运行身份（如 su root syslog）。
进程管理工具：
- 使用 PM2 时，可安装 pm2-logrotate 插件，配置 max_size、retain、compress、rotateInterval 等策略，简化运维。
容器场景：
- Docker 使用 json-file 日志驱动并配置 max-size / max-file，避免容器日志无限增长。

三系统日志集成与查看

将 Node.js 日志发送到 syslog（便于与系统日志统一管理与审计）：
- 使用 winston 的 SyslogTransport，指定 syslogHost、facility、tag 等参数。
查看与分析：
- 使用 journalctl 检索与过滤日志，例如按服务名或关键字筛选错误。
- 结合 grep/awk 做快速统计与时段过滤，定位高峰与异常。

四集中式日志与可视化

搭建 ELK Stack（Elasticsearch + Logstash + Kibana） 或 Graylog/Fluentd，集中采集、解析与存储日志：
- Logstash 配置输入（如 file 或 syslog）、过滤器（如 grok 解析）、输出到 Elasticsearch；
- Kibana 建立索引模式与可视化面板，支持按字段快速检索与聚合分析。
适用场景：多实例/微服务架构、跨主机统一观测、长期留存与合规审计。

五落地配置示例

应用内 winston + 按日轮转（适合直接运行 Node.js 进程）

npm i winston winston-daily-rotate-file

const winston = require('winston');
const { DailyRotateFile } = require('winston-daily-rotate-file');

const transport = new DailyRotateFile({
  filename: '/var/log/myapp/application-%DATE%.log',
  datePattern: 'YYYY-MM-DD-HH',
  zippedArchive: true,
  maxSize: '20m',
  maxFiles: '14d',
});

const logger = winston.createLogger({
  level: process.env.NODE_ENV === 'production' ? 'error' : 'debug',
  format: winston.format.combine(
    winston.format.timestamp(),
    winston.format.json()
  ),
  transports: [
    new winston.transports.File({ filename: '/var/log/myapp/error.log', level: 'error' }),
    transport,
    ...(process.env.NODE_ENV !== 'production'
      ? [new winston.transports.Console({ format: winston.format.simple() })]
      : []),
  ],
});

logger.info('应用启动', { service: 'myapp', pid: process.pid });

系统级 logrotate（适合 systemd 服务）

创建配置：/etc/logrotate.d/myapp

/var/log/myapp/*.log {
  daily
  rotate 14
  compress
  delaycompress
  missingok
  notifempty
  create 0640 myapp myapp
  sharedscripts
  postrotate
    systemctl reload myapp.service >/dev/null 2>&1 || true
  endscript
}

手动测试与生效：

sudo logrotate -vf /etc/logrotate.d/myapp

PM2 日志轮转（适合 PM2 托管）

pm2 install pm2-logrotate
pm2 set pm2-logrotate:max_size 10M
pm2 set pm2-logrotate:retain 7
pm2 set pm2-logrotate:compress true
pm2 set pm2-logrotate:rotateInterval "0 0 * * *"
pm2 restart all

写入 syslog（可选）

npm i winston @winston/syslog

const { Syslog } = require('@winston/syslog');
logger.add(new Syslog({ host: 'localhost', facility: 'local0', tag: 'myapp' }));
logger.error('通过 syslog 记录的错误', { meta: 'data' });

最新问答

相关标签