Node.js 在 Linux 中如何进行日志管理

在 Linux 系统中管理 Node.js 应用程序日志的几种方式

对于在 Linux 环境下运行的 Node.js 应用来说，一套清晰、可靠的日志管理方案，是保障应用可观测性和稳定性的基石。那么，具体有哪些行之有效的方法呢？

1. 使用内置的 console 模块

最直接、最轻量的方式，莫过于 Node.js 自带的 console 模块。在开发和调试阶段，它无疑是快速查看应用状态的利器。只需几行简单的代码，就能将信息输出到控制台。

console.log('This is a log message');
console.error('This is an error message');

当然，这种方式更适合前期开发。一旦应用进入生产环境，其功能上的局限性就会显现出来，比如缺乏日志分级、持久化策略等，这时就需要更专业的工具了。

2. 借助功能强大的第三方日志库

当应用复杂度提升，对日志的需求也会水涨船高。此时，社区中成熟的第三方日志库就成了不二之选。像 winston 和 bunyan 这类库，它们提供了日志级别控制、格式化输出、多传输通道等丰富功能，让日志管理变得井井有条。

先来看看 Winston 的典型用法：

const winston = require('winston');
const logger = winston.createLogger({
  level: 'info',
  format: winston.format.json(),
  transports: [
    new winston.transports.File({ filename: 'error.log', level: 'error' }),
    new winston.transports.File({ filename: 'combined.log' })
  ]
});
logger.info('This is an info message');
logger.error('This is an error message');

再看 Bunyan，它以结构化的 JSON 日志输出而闻名，非常适合后续的日志分析：

const bunyan = require('bunyan');
const logger = bunyan.createLogger({
  name: 'my-app',
  streams: [
    { level: 'info', stream: process.stdout },
    { level: 'error', path: 'error.log' },
    { level: 'info', path: 'combined.log' }
  ]
});
logger.info('This is an info message');
logger.error('This is an error message');

选择哪一个？这取决于团队偏好和具体需求。Winston 的配置非常灵活，而 Bunyan 在生成机器可读日志方面更胜一筹。

3. 实施日志轮转策略

日志文件不会自己管理自己。如果不加控制，单个日志文件体积可能膨胀到数GB，不仅占用磁盘空间，排查问题时打开文件都成了一种折磨。因此，日志轮转是生产环境中的必备环节。

在 Linux 生态里，主要有两种主流方案：

方案一：使用系统工具 logrotate
这是 Linux 系统的老牌守护者。你可以在 /etc/logrotate.d/ 目录下为你的应用创建一个专属配置文件，比如叫做 my-node-app：

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

这段配置意味着：日志文件将按天轮转，保留最近7份，旧文件会被自动压缩，并且当文件不存在或为空时也不会报错。一套组合拳下来，日志管理就自动化了。

方案二：借助进程管理器 PM2 的内置功能
如果你使用 PM2 来守护 Node.js 进程，那么日志轮转可以更简单地集成。PM2 提供了直接的命令来设置轮转策略：

npm install pm2 -g
pm2 start app.js --name my-node-app
pm2 set pm2:logrotate:max_size 10M
pm2 set pm2:logrotate:retain 7

这里设定了单个日志文件最大为 10MB，并且同样保留最近7天的日志。对于追求部署简洁性的团队，这种方式尤其方便。

说到底，有效的日志管理并非单一方法就能解决，它往往是一个组合策略：在代码层面使用专业的日志库进行记录和分级，在系统层面通过轮转工具来维护日志文件的健康度。将这几招结合起来，你在 Linux 上为 Node.js 应用构建的日志系统，才算真正具备了生产级的可靠性。