Ubuntu环境下Node.js日志如何管理

Ubuntu下Node.js日志管理实践

一 核心原则与总体架构

想把Node.js应用的日志管好，其实离不开几个核心原则。首先，结构化日志是基础。别再输出一堆难以解析的纯文本了，优先选择Winston、Pino、Bunyan这类成熟的日志库。它们不仅能帮你轻松控制日志级别（比如error、warn、info、debug），还能统一输出格式，并支持多目标输出——文件、控制台甚至HTTP接口。采用JSON这类结构化格式，后续的检索和分析效率会高得多。

其次，日志轮转与保留是避免“翻车”的关键。日志文件如果不加管理，很容易把磁盘空间撑满。你得按时间或文件大小进行切分，对旧日志压缩归档，并设置明确的保留天数。

再者，对于分布式或正式的生产环境，集中式收集与分析几乎是标配。把各处的日志统一发送到ELK Stack（Elasticsearch, Logstash, Kibana）或Graylog这样的平台，才能实现高效的统一检索、可视化看板以及及时的告警。

最后，运行与监控环节也离不开日志。使用PM2这类进程管理器，不仅能守护你的应用进程，还能统一管理日志输出，方便实时查看、设置自动重启以及配置故障告警，让运维工作事半功倍。

二 应用内日志方案与示例

理论说完了，咱们来看看具体怎么落地。应用内的日志方案，可以根据场景和性能需求来灵活选择。

使用 Winston 记录文件与控制台日志
Winston功能全面，适用性广，能让开发环境和生产环境的日志行为保持一致，便于排错和归档。

• 安装：npm install winston
• 示例：

  const winston = require('winston');
  const logger = winston.createLogger({
    level: process.env.NODE_ENV === 'production' ? 'info' : 'debug',
    format: winston.format.combine(
      winston.format.timestamp({ format: 'YYYY-MM-DD HH:mm:ss' }),
      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()
    }));
  }
  logger.info('应用启动', { pid: process.pid });
  logger.error('发生错误', { err: new Error('boom') });

使用 Pino 记录高性能结构化日志
如果你的应用对性能极其敏感，尤其是在高并发场景下，那么Pino会是更优的选择。它的速度优势非常明显。

• 安装：npm install pino
• 示例：

  const pino = require('pino')();
  pino.info({ service: 'api' }, 'hello pino');

Express 场景结合 HTTP 访问日志
在Web服务中，HTTP访问日志至关重要。结合经典的morgan和Winston，可以轻松实现。

• 安装：npm install morgan winston
• 示例：

  const express = require('express');
  const morgan = require('morgan');
  const logger = require('./logger'); // 引用上面的 winston 实例
  const app = express();
  app.use(morgan('combined', { stream: { write: msg => logger.info(msg.trim()) } }));
  app.get('/', (_, res) => res.send('ok'));
  app.listen(3000);

关于日志级别，这里有个通用建议：开发环境可以放开到debug级别，便于排查；生产环境则收敛到info和error，避免日志量过大。当然，你也可以根据实际需要，细化使用warn或verbose级别。

三 日志轮转与保留策略

日志轮转是生产环境的“必修课”。主要有两种思路：应用内轮转和系统级轮转，你可以根据情况二选一，或者叠加使用以获得更稳妥的保障。

应用内轮转
使用 winston-daily-rotate-file 这类库，可以在Node.js应用内部实现轮转。

• 安装：npm install winston-daily-rotate-file
• 示例：

  const DailyRotateFile = require('winston-daily-rotate-file');
  const rotateTransport = new DailyRotateFile({
    filename: 'logs/application-%DATE%.log',
    datePattern: 'YYYY-MM-DD',
    zippedArchive: true,
    maxSize: '20m',
    maxFiles: '14d'
  });
  logger.add(rotateTransport);

• 说明：这个配置实现了按天切分文件，单个文件超过20MB也会触发切分，保留最近14天的日志，并且会自动将旧文件压缩归档。

系统级轮转
对于生产环境，尤其是多进程、多实例或容器化部署的场景，更推荐使用系统工具logrotate。这种方式与应用解耦，更加稳定和通用。

• 新建配置：sudo nano /etc/logrotate.d/nodejs-app
• 示例配置（实现了按天轮转、保留7天、压缩、延迟压缩、空文件不轮转、自动创建新文件）：

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

• 测试与生效：sudo logrotate -f /etc/logrotate.d/nodejs-app
• 说明：这套方案对应用本身无侵入，由操作系统定时任务执行，管理起来非常省心。

四 运行与集中式日志

当应用跑起来之后，如何高效地查看和管理日志，并把分散的日志收集起来，就成为了新的挑战。

使用 PM2 管理进程与日志
PM2不仅是进程守护工具，其日志管理功能也非常强大。

• 安装：npm install -g pm2
• 常用命令：

  pm2 start app.js --name my-app
  pm2 logs my-app        # 实时查看日志
  pm2 monit              # 资源与日志监控面板
  pm2 flush              # 清理当前日志文件

• 日志轮转（PM2 内置）：PM2自身也提供了日志轮转配置，可以这样设置：

  pm2 set pm2:log-date-format "YYYY-MM-DD HH:mm:ss"
  pm2 set pm2:max-size "20M"
  pm2 set pm2:retain "14d"

集中式日志收集
在微服务或分布式架构中，集中式日志收集是必选项。常见的方案是将日志发送到rsyslog，或者直接对接ELK、Graylog。

• 方案：将日志发送到 rsyslog 或直接到 ELK/Graylog。
• rsyslog 示例（将所有标识为“nodejs”的日志写入单独文件）：

  sudo apt-get install rsyslog
  # 在 /etc/rsyslog.d/50-default.conf 追加：
  if $programname == 'nodejs' then /var/log/nodejs.log
  & stop
  sudo systemctl restart rsyslog

• 后续，你可以在Kibana中为这些日志建立索引模式，从而进行强大的检索、分析和可视化。

五 维护与最佳实践清单

最后，我们来梳理一份维护清单和最佳实践，这能帮你避开很多常见的“坑”。

• 目录与权限：规划好统一的日志目录，比如/var/log/myapp/或项目内的logs/。务必设置合适的文件权限（例如0640），并严格避免将密码、密钥等敏感信息写入日志。
• 保留与清理：根据合规性要求和存储成本，设定明确的日志保留周期（例如7到14天）。结合前面提到的logrotate或应用内轮转策略，实现自动化清理。
• 性能与异步：写日志操作本身不能成为性能瓶颈。避免同步写日志和过于复杂的序列化操作。在高并发场景下，优先考虑Pino或确保使用日志库的异步传输模式。
• 结构化与采样：坚持输出结构化日志（如JSON），并统一关键字段，如timestamp, level, service, trace_id。在异常流量激增时，可以考虑启用采样日志，避免海量日志冲垮存储系统。
• 监控与告警：日志不是用来“存”的，更是用来“用”的。需要对error级别的日志建立监控，并配置告警（例如对接Sentry，或使用Prometheus + Alertmanager），确保问题能被第一时间发现。
• 安全合规：这是红线。必须对日志中的敏感字段（如password、token、身份证号、银&行卡号）进行脱敏处理。同时，严格限制日志文件的访问权限，并定期进行安全审计。