Ubuntu Node.js日志文件如何管理

Ubuntu 上 Node.js 日志管理实操指南

管理好日志，是保障Node.js应用稳定运行和高效排查问题的基本功。今天，我们就来梳理一套在Ubuntu环境下，从应用到系统再到集中管理的完整日志方案。

一 核心原则与总体架构

在动手配置之前，先明确几个核心原则，这能让后续工作事半功倍。

• 应用层标准化：在应用内部，务必使用成熟的日志库（如 Winston、Pino、Bunyan、Log4js）。统一设定日志级别（例如 error、warn、info、debug），并优先输出结构化的JSON日志。这可不是为了好看，而是为了后续的检索与分析能更高效。
• 生命周期管理：日志文件不能放任自流。必须采用“轮转 + 压缩 + 保留策略”的组合拳来控制磁盘占用。这既可以在应用内实现，也可以交给系统级的工具来管理。
• 走向集中化：对于生产环境，强烈建议将日志接入集中式系统（如 ELK Stack、Graylog）。这样一来，搜索、告警和可视化图表就都有了统一的平台，告别在各个服务器间手动翻找的窘境。
• 善用管理工具：使用进程管理工具（如 PM2）能极大简化应用的运行和日志采集。如果选择使用 systemd，则可以将其输出对接至 journald 或 syslog，实现系统级的统一采集。

二 应用内日志与轮转实践

理论说完了，我们直接看代码。先从应用内部如何生成和管理日志开始。

• 基础配置：使用 Winston
  一个典型的Winston配置，会将不同级别的日志输出到不同文件，同时在开发环境保留控制台输出，方便调试。

// logger.js
const winston = require('winston');
const logger = winston.createLogger({
  level: 'info',
  format: winston.format.json(),
  transports: [
    new winston.transports.File({ filename: 'logs/error.log', level: 'error' }),
    new winston.transports.File({ filename: 'logs/combined.log' }),
  ],
});
if (process.env.NODE_ENV !== 'production') {
  logger.add(new winston.transports.Console({ format: winston.format.simple() }));
}
module.exports = logger;

• 自动轮转：按时间或大小切割
  单一日志文件无限增长是灾难。使用 `winston-daily-rotate-file` 可以轻松实现按日期或文件大小自动轮转，并自动压缩旧文件。

// logger-rotate.js
const winston = require('winston');
const DailyRotateFile = require('winston-daily-rotate-file');
const transport = new DailyRotateFile({
  filename: 'logs/application-%DATE%.log',
  datePattern: 'YYYY-MM-DD',
  zippedArchive: true,
  maxSize: '20m',
  maxFiles: '14d',
});
const logger = winston.createLogger({
  level: 'info',
  format: winston.format.json(),
  transports: [transport],
});
module.exports = logger;

另外，对于Express应用，别忘了可以用 `morgan` 中间件将HTTP访问日志无缝接入到Winston（或其他日志库）中，保持日志流的统一。

三 系统级与进程管理方案

应用层做好了，我们来看看系统层面有哪些工具可以帮我们更好地管理这些日志文件。

• 系统管家：logrotate
  对于任何直接写入文件的日志，`logrotate` 都是Linux系统上经久不衰的守护者。它的配置非常直观。
  1. 创建一个专属配置文件，例如 `/etc/logrotate.d/nodejs-app`：

/path/to/your/nodejs/app/logs/*.log {
  daily
  missingok
  rotate 7
  compress
  notifempty
  create 0640 root adm
}

2. 配置好后，可以手动测试一下，然后它就会按计划自动运行：

sudo logrotate -f /etc/logrotate.d/nodejs-app

• 进程管理器：PM2 的内置方案
  如果你用PM2来管理Node.js进程，那日志管理就简单多了。它内置了强大的日志功能，几条命令就能搞定。
  • 常用命令一览：

pm2 start app.js --name my-app
pm2 set pm2:log-date-format "YYYY-MM-DD HH:mm:ss"
pm2 set pm2:max-size "20M"
pm2 set pm2:retain "14d"
pm2 logs my-app

PM2的日志默认存放在 `~/.pm2/logs/` 目录下，会自动为每个应用生成 `.log`（标准输出）和 `.err.log`（错误输出）文件，并自动进行轮转。

• 系统服务集成：systemd + journald
  对于通过systemd管理的服务，可以将其输出直接接入journald或syslog，实现与系统日志的统一。
  • 在服务单元文件（.service）中添加如下配置片段：

[Service]
ExecStart=/usr/bin/node /path/to/app.js
StandardOutput=syslog
StandardError=syslog
SyslogIdentifier=yourapp

之后，就可以用熟悉的 `journalctl` 命令来查看应用日志了：

journalctl -u yourapp -f

• 进阶转发：对接 rsyslog
  如果需要将日志发送到更专业的中央日志服务器，可以通过rsyslog来转发。
  • 一个简单的匹配规则示例（可放在 `/etc/rsyslog.d/50-default.conf`）：

if $programname == 'nodejs' then /var/log/nodejs.log
& stop

记得配置完成后重启rsyslog服务使其生效：`sudo systemctl restart rsyslog`。

四 集中式日志与监控分析

当应用规模上去，服务器数量增多时，分散的日志就成了运维的痛点。这时，集中式日志管理方案就该登场了。

• 经典组合：ELK Stack 或 Graylog。将日志统一发送到 Elasticsearch 或 Graylog，再利用 Kibana 等工具进行可视化。这意味着，你可以在一个界面上，跨服务器、跨应用进行搜索、聚合分析，并设置灵活的告警规则。
• 轻量级采集：rsyslog 或 fluentd。如果觉得ELK全家桶有点重，可以用rsyslog或fluentd作为轻量级的日志采集和转发袋里，将数据推送到指定的存储或分析系统。
• 分析与告警。日志集中后，价值才真正体现。利用 Kibana 制作业务报表，监控错误趋势；或者使用 Logwatch、Analog 等工具进行常规分析。像PM2这类工具也提供了实时的日志查看和基础监控功能，适合快速排查问题。

五 最佳实践与维护清单

最后，我们来总结一份可对照执行的维护清单，确保日志管理始终处于健康状态。

• 规范先行：在团队内明确日志级别、输出目标（生产环境以文件为主）和格式（首选结构化JSON）。
• 容量管控：制定清晰的保留策略，例如“保留7-14天，单文件不超过20MB”，并务必开启压缩功能。
• 安全红线：绝对避免在日志中记录密码、API密钥、令牌等敏感信息。必要时，必须在输出前进行脱敏处理。
• 主动监控：建立对日志系统本身的监控，包括磁盘使用率、错误日志数量的异常激增等，并设置告警。定期审计和清理旧日志也应成为例行工作。
• 团队协作：统一日志字段规范，比如包含 `timestamp`、`level`、`service`、`trace_id` 等关键字段。这对于后续实现跨服务的请求链路追踪至关重要。