Linux Node.js如何配置日志系统

在Linux系统中为Node.js应用配置日志系统：从基础到进阶

为运行在Linux环境下的Node.js应用程序搭建一套得心应手的日志系统，是保障应用可观测性和稳定性的关键一步。面对不同的场景和需求，开发者有多种路径可以选择。接下来，我们就系统地梳理一下这些常见的配置方法。

1. 使用内置的console模块：快速起步

对于快速原型或简单的脚本，Node.js自带的console模块无疑是最直接的选择。它开箱即用，无需额外安装。不过，其功能相对基础，缺乏日志分级、格式化输出和持久化到文件等高级特性，因此通常不建议用于严肃的生产环境。

const console = require('console');
console.log('This is an info message');
console.error('This is an error message');

2. 拥抱第三方日志库：专业之选

当应用复杂度提升，一个功能强大的第三方日志库就显得至关重要。它们提供了丰富的特性，比如多传输方式、结构化日志和灵活的级别控制。下面介绍两个社区中的佼佼者。

a. winston：功能全面的多面手

winston以其高度的可配置性和丰富的生态系统著称。你可以轻松地将日志同时输出到控制台、文件，甚至远程服务。其核心在于创建Logger实例并配置不同的transports（传输器）。

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' }),
    new winston.transports.Console({
      format: winston.format.simple()
    })
  ]
});
logger.info('This is an info message');
logger.error('This is an error message');

b. pino：追求极致的性能派

如果你的应用对性能有极致要求，尤其是在高吞吐量场景下，pino是一个绝佳的选择。它的设计哲学就是极简与高速，默认生成JSON格式的结构化日志，非常便于后续的日志收集与分析。

const pino = require('pino');
const logger = pino();
logger.info('This is an info message');
logger.error('This is an error message');

3. 配置日志轮转：应对文件膨胀

生产环境的日志文件会随时间不断增长，如果不加管理，很快就会占满磁盘空间。这时，日志轮转（Log Rotation）就派上用场了。利用winston-daily-rotate-file这类库，可以按时间或文件大小自动分割、归档甚至压缩旧日志。

const winston = require('winston');
const DailyRotateFile = require('winston-daily-rotate-file');
const transport = new DailyRotateFile({
  filename: 'application-%DATE%.log',
  datePattern: 'YYYY-MM-DD-HH',
  zippedArchive: true,
  maxSize: '20m',
  maxFiles: '14d'
});
const logger = winston.createLogger({
  level: 'info',
  format: winston.format.json(),
  transports: [
    transport,
    new winston.transports.Console({
      format: winston.format.simple()
    })
  ]
});
logger.info('This is an info message');
logger.error('This is an error message');

4. 使用环境变量配置日志级别：实现动态控制

不同环境对日志详细程度的需求不同：开发时需要debug级别的详尽信息，而生产环境可能只关心warn和error。通过环境变量来动态设置日志级别，是一种非常优雅的实践。

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

5. 集成到系统日志：融入运维体系

对于部署在服务器上的应用，将其日志接入Linux系统自带的日志服务（如syslog或journald），能让运维人员使用统一的工具进行监控和管理，提升运维效率。

a. 使用syslog

const syslog = require('syslog');
const logger = syslog.createClient(syslog.LOG_INFO, 'my-app');
logger.info('This is an info message');
logger.error('This is an error message');

b. 使用journald

const systemd = require('systemd-journald');
const logger = systemd.createJournal({
  service: 'my-app'
});
logger.info('This is an info message');
logger.error('This is an error message');

从简单的console.log到强大的第三方库，再到与系统日志服务的深度集成，选择哪种方案，最终取决于你的具体需求：是追求开发便捷，是看重性能极致，还是需要融入现有的运维生态。理解这些方法的适用场景，就能为你的Node.js应用配置出既可靠又高效的日志系统。