Node.js在Ubuntu中的日志输出方式

Node.js 在 Ubuntu 的日志输出方式

一 内置方式与简单场景

先说一个最直接的办法：直接用 console.log 或 console.error。这种方式简单粗暴，输出直接打到标准输出（stdout）或标准错误（stderr），非常适合开发调试阶段。

不过，一旦你把应用部署到 Ubuntu 服务器上，情况就有点不同了。如果只是在前台直接运行，日志会打印在当前终端里；但生产环境通常需要后台运行，这时候日志去哪了？这就得依赖下文要讲的 systemd 或进程管理器来帮你收集和持久化日志了。所以，内置的 console 方法更像是一个起点，真正的生产级日志管理，还得看后面的组合拳。

二 使用日志库结构化输出

想让日志更规整、更易于管理？是时候引入专业的日志库了。这不仅能实现多目标输出，还能进行精细的级别管理，让日志从“杂乱的信息”变成“可分析的数据”。

1. 使用 winston 实现核心日志管理
Winston 是 Node.js 生态里的日志库“老炮儿”。它的核心优势在于，可以轻松地将日志同时输出到控制台、文件甚至远程服务，并且能根据日志级别（如 debug, info, error）进行过滤。一个常见的实践是：根据运行环境（开发或生产）动态切换日志格式和级别。比如开发环境你可能想看更详细的 debug 信息，而生产环境则只关心 warn 和 error。

2. 在 Express 中配合 morgan 管理 HTTP 日志
对于 Web 应用，访问日志和业务日志最好分开处理，职责清晰，后续分析也方便。通常的做法是，用 morgan 这个中间件专门处理 HTTP 请求日志，并将其写入独立的访问日志文件；而应用自身的业务逻辑、错误信息等，则交给 winston 来统一管理。

3. 实战代码示例（winston + morgan，按环境配置）
光说不练假把式，来看一个具体的配置例子：

• 安装依赖：npm install winston morgan
• 代码示例：

  const winston = require('winston');
  const express = require('express');
  const morgan = require('morgan');
  const fs = require('fs');
  const path = require('path');
  
  // 配置 winston 日志器
  const logger = winston.createLogger({
    level: process.env.LOG_LEVEL || 'info', // 通过环境变量控制级别
    format: winston.format.combine(
      winston.format.timestamp(),
      winston.format.json() // 生产环境推荐结构化 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()
    }));
  }
  
  const app = express();
  
  // 配置 morgan，将 HTTP 访问日志写入独立文件
  const accessLogStream = fs.createWriteStream(
    path.join(__dirname, 'logs', 'access.log'),
    { flags: 'a' } // 追加模式
  );
  app.use(morgan('combined', { stream: accessLogStream }));
  
  // 示例路由
  app.get('/', (req, res) => {
    logger.info('访问了首页'); // 业务日志使用 winston
    res.send('Hello World');
  });
  
  app.listen(3000, () => logger.info('服务器已在 3000 端口启动'));
  

• 如何运行：启动时通过环境变量指定日志级别，例如 LOG_LEVEL=debug node app.js，这样在开发环境就能看到更详细的调试信息。

三 使用进程管理器与 systemd 管理日志

应用跑起来之后，如何方便地查看和管理它的日志？这就需要借助进程管理工具或系统服务了。

1. 使用 PM2：专为 Node.js 而生
PM2 对开发者非常友好，它提供了开箱即用的日志管理功能，包括自动聚合日志、按应用查看、以及按时间过滤等。几个常用命令就能搞定：

• 启动应用：pm2 start app.js --name my-app
• 查看日志：pm2 logs my-app
• 实时跟踪（带时间戳）：pm2 logs my-app --raw --timestamp

对于大多数中小型应用，PM2 的方案已经足够省心。

2. 使用 systemd：集成到系统服务
如果你希望应用以系统服务的方式运行，并集成到 Ubuntu 标准的日志系统（journald/syslog）中，那么 systemd 是更正统的选择。关键配置在服务的单元文件（.service）里：

[Service]
...
StandardOutput=syslog
StandardError=syslog
SyslogIdentifier=yourapp

配置好后，就可以通过系统的 journalctl 命令来查看日志了：journalctl -u yourapp.service -f。这种方式特别适合需要系统级托管、或者计划进行集中化日志采集的场景。

四 日志轮转与运维要点

日志管理不是配置完就一劳永逸了，生产环境还有几个必须关注的运维要点。

1. 日志轮转：别让单个文件撑爆磁盘
日志文件会不断增长，必须实施轮转策略。你可以使用 Linux 系统自带的 logrotate 工具，也可以在 Node.js 层用 winston-daily-rotate-file 这样的库来实现。后者配置起来更直观，比如可以按日期或文件大小进行切割和归档：

const DailyRotateFile = require('winston-daily-rotate-file');
const transport = new DailyRotateFile({
  filename: 'application-%DATE%.log',
  datePattern: 'YYYY-MM-DD-HH',
  zippedArchive: true, // 自动压缩旧日志
  maxSize: '20m',      // 单个文件最大 20MB
  maxFiles: '14d'      // 保留最近 14 天的日志
});
const logger = winston.createLogger({
  level: 'info',
  format: winston.format.combine(
    winston.format.timestamp({ format: 'YYYY-MM-DD HH:mm:ss' }),
    winston.format.json()
  ),
  transports: [transport, new transports.Console({ format: format.simple() })]
});

2. 级别与环境：动态控制输出粒度
务必通过环境变量（如 LOG_LEVEL）来控制日志级别。开发时可以设为 debug 以便排查，生产环境则收紧到 info、warn 或 error，避免输出过多无关信息同时保护敏感数据。

3. 分析与集中：从日志中获取洞察
对于小规模部署，可以用 Logwatch、Analog 等工具生成简单的日志日报。一旦业务规模增长，日志量变大，就需要更强大的方案了。这时可以考虑接入 ELK Stack（Elasticsearch, Logstash, Kibana）或 Graylog 这类集中式日志平台。它们能实现日志的实时检索、可视化分析甚至设置告警，真正让日志产生业务价值。