如何配置Ubuntu JS日志记录策略

Ubuntu 上 Node.js 日志策略配置指南

日志管理，听起来像是运维的活儿，但对于一个健壮的Node.js应用来说，它绝对是开发阶段就必须规划好的核心环节。一套清晰的日志策略，能让你在问题发生时，快速定位根因，而不是在茫茫控制台输出里大海捞针。下面，我们就来聊聊在Ubuntu环境下，如何为你的Node.js应用搭建一套既专业又实用的日志体系。

一 核心策略与选型

在动手写代码之前，先明确几个关键策略，这能帮你少走很多弯路。

• 日志库选型：这是第一步，也是决定后续所有体验的基础。如今，结构化日志已成主流，它能让机器更好地解析和分析。Winston功能全面、支持多种传输方式，是许多团队的首选；如果你追求极致的性能，Pino会是更好的选择；而Bunyan则提供了开箱即用的JSON格式和配套的CLI工具，非常方便。如果你的应用基于Express，那么配合Morgan来专门记录HTTP请求日志，是个不错的组合。
• 日志级别：千万别所有信息都一股脑儿记下来。合理的级别划分（如 debug / info / warn / error / fatal）是过滤噪音的关键。一个实用的技巧是：根据环境动态设置级别。开发环境可以放开到debug，便于排查；而生产环境，通常默认设为info或warn，既能捕获关键业务流和异常，又避免了日志量爆炸。
• 输出目标：目标不同，策略也不同。开发期，输出到控制台是最直观的；但到了生产期，将日志写入文件并接入集中式日志系统（如ELK、Graylog），才是可持续的做法。
• 轮转与保留：想象一下，一个日志文件无限增长下去会怎样？不仅是查看困难，磁盘被撑爆也是分分钟的事。所以，一定要按天或按大小进行轮转，并只保留最近一段时间的历史日志。
• 集中化与监控：当你有多个服务实例时，去每台服务器上查日志就太痛苦了。将日志集中发送到ELK Stack（Elasticsearch, Logstash, Kibana）或Graylog，统一搜索和分析。更进一步，可以结合Prometheus收集指标，用Grafana配置看板和告警，实现监控闭环。
• 安全合规：这一点常常被忽略，但后果可能很严重。务必确保日志中不会记录密码、密钥等敏感信息。同时，日志文件的存储权限要设置得当，在传输过程中，必要时进行加密。

二 应用内日志配置示例

理论说完了，来看看具体怎么实现。这里提供几个最常见的配置示例。

• 使用 Winston 的文件轮转（按天/按大小）
  • 首先，安装必要的依赖：npm i winston winston-daily-rotate-file。
  • 接着，创建一个兼顾控制台输出和文件轮转的logger实例：

    const { createLogger, format, transports } = require('winston');
    const DailyRotateFile = require('winston-daily-rotate-file');
    
    const logger = createLogger({
      level: process.env.LOG_LEVEL || 'info',
      format: format.combine(
        format.timestamp({ format: 'YYYY-MM-DD HH:mm:ss' }),
        format.json()
      ),
      defaultMeta: { service: 'my-app' },
      transports: [
        new DailyRotateFile({
          filename: '/var/log/myapp/application-%DATE%.log',
          datePattern: 'YYYY-MM-DD',
          zippedArchive: true,
          maxSize: '20m',
          maxFiles: '14d'
        }),
        new transports.Console({ format: format.simple() })
      ]
    });
    
    // 使用示例
    logger.info('服务启动', { port: 3000 });
    logger.error('数据库不可用', { err: err.message });

    这个配置实现了按日期和大小轮转，自动压缩旧日志，并保留14天。
• Express + Morgan（HTTP 请求日志）
  • 安装Morgan：npm i morgan。
  • 将其配置为将访问日志写入文件：

    const express = require('express');
    const morgan = require('morgan');
    const fs = require('fs');
    const path = require('path');
    
    const app = express();
    const accessLogStream = fs.createWriteStream(
      path.join(__dirname, 'logs', 'access.log'),
      { flags: 'a' }
    );
    app.use(morgan('combined', { stream: accessLogStream }));
    
    app.get('/', (req, res) => res.send('Hello World'));
    app.listen(3000);

• 环境变量控制日志级别
  • 这是实现“环境差异化配置”最优雅的方式。启动应用时直接指定：LOG_LEVEL=debug node app.js。
  • 在代码中，像上面Winston示例那样读取即可：level: process.env.LOG_LEVEL || ‘info’。

三 运行方式与系统日志集成

应用写好了，怎么运行它，也决定了日志的去向和管理方式。

• 使用 PM2 管理进程与日志
  • 全局安装PM2：npm i -g pm2。
  • 启动应用并查看日志变得非常简单： pm2 start app.js --name my-app 启动服务。 pm2 logs my-app 可以实时查看、追踪日志，并且支持按服务名过滤，管理多应用时特别方便。
• 使用 systemd 托管并写入系统日志
  • 对于追求标准化和与系统深度集成的场景，systemd是更正统的选择。创建一个服务单元文件 /etc/systemd/system/myapp.service：

    [Unit]
    Description=My Node.js App
    After=network.target
    
    [Service]
    Type=simple
    User=www-data
    WorkingDirectory=/opt/myapp
    ExecStart=/usr/bin/node /opt/myapp/app.js
    Restart=always
    StandardOutput=journal
    StandardError=journal
    SyslogIdentifier=myapp
    
    [Install]
    WantedBy=multi-user.target

  • 之后，就可以使用 journalctl -u myapp.service -f 来跟随查看系统日志中你的应用输出了，所有日志由systemd统一管理。

四 日志轮转与自动清理

即使应用内配置了轮转，结合系统工具再做一层保障，是生产环境的常见做法。

• 使用 logrotate 管理应用日志文件
  • 这是Linux系统的原生利器。在 /etc/logrotate.d/ 下为你的应用创建一个配置文件，比如 nodejs-app：

    /var/log/myapp/*.log {
        daily
        missingok
        rotate 7
        compress
        notifempty
        create 0640 www-data adm
        copytruncate
    }

  • 简单解释一下：daily 表示每天轮转；rotate 7 保留7份旧日志；compress 用gzip压缩；create 设置新日志文件的权限和属主；copytruncate 这个参数很重要，它先复制文件再清空原文件，适用于那些不支持接收信号重新打开日志句柄的应用。
  • 可以手动测试配置是否正确：sudo logrotate -f /etc/logrotate.d/nodejs-app。
• 使用 systemd 定时器清理旧日志（可选）
  • 对于更复杂的清理逻辑（比如清理特定格式的压缩包），可以写一个脚本，并用systemd定时器驱动。例如，清理7天前的.gz文件：

    #!/usr/bin/env bash
    LOG_DIR="/var/log/myapp"
    find "$LOG_DIR" -type f -name "*.gz" -mtime +7 -delete

  • 然后配置一个 .timer 单元和对应的 .service 单元，设置 OnCalendar=daily 并启用，就能实现每日自动清理了。

五 集中化与监控实践

最后，让我们把视角拔高，看看如何让日志产生更大的价值。

• 将日志发送到 ELK：你可以在Winston中直接添加Elasticsearch传输插件，或者更常见的，在服务器上部署Filebeat或Logstash来收集日志文件，然后发送到Elasticsearch。之后，在Kibana中建立索引模式，制作可视化仪表盘，实现日志的全局搜索和趋势分析。
• 使用 PM2 内置日志聚合与查看：如果你使用PM2管理多个实例，pm2 logs 命令会自动聚合所有实例的日志输出，并支持高亮和过滤，对于快速故障排查非常高效。
• 监控与告警：日志用于事后分析，监控则用于事前预警。可以结合Prometheus（用于收集应用暴露的指标，如错误计数、请求延迟）和Grafana（用于制作监控看板和配置告警规则）。当错误日志突然增多或接口响应时间超过阈值时，告警能第一时间通知到你。

说到底，日志不是记下来就完了。从规范记录，到妥善存储，再到集中分析和监控告警，形成一个完整的闭环，这才是现代应用日志管理的正确姿势。希望这份指南能帮助你，在Ubuntu上为Node.js应用构建起坚实的可观测性基础。