Node.js 中使用 log4js 记录日志
在开发和维护 Node.js 应用程序时，日志记录是一个至关重要的部分。良好的日志管理可以帮助我们跟踪程序运行状态、捕获异常、定位问题并优化性能。log4js 是一个强大的日志库，它为 Node.js 提供了灵活的日志记录功能，包括日志级别控制、日志输出方式、日志文件轮换等。本文将带你了解如何在 Node.js 中使用 log4js 记录日志。
为什么选择 log4js？
在 Node.js 中，日志记录的常见方法有很多，但 log4js 提供了一些额外的功能，使其成为一个流行的选择：
- 多种日志级别：支持不同级别的日志记录（如
trace、debug、info、warn、error、fatal），可以根据需求过滤输出的日志内容。 - 日志轮换：通过配置，可以将日志按日期或大小进行轮换，有效避免日志文件过大，占用过多存储空间。
- 日志压缩：日志轮换时，可以启用压缩功能，将日志文件以
.gz格式保存，进一步节省磁盘空间。 - 多种输出方式：可以将日志输出到控制台、文件、远程服务器等多种目标，满足不同的需求。
安装 log4js
首先，我们需要在项目中安装 log4js 库。可以通过以下命令来安装：
npm install log4js
配置 log4js
在使用 log4js 之前，首先需要配置日志记录器。以下是一个示例配置，其中包括日志输出到控制台和文件，文件按日期进行轮换，并设置日志保留天数和压缩。
示例代码：
const log4js = require("log4js");// 配置日志记录器
log4js.configure({appenders: {out: { type: "stdout" }, // 输出到控制台app: {type: "file", // 使用 file appender 进行文件输出filename: "logs/app.log", // 日志文件路径（不需要扩展名，自动添加）pattern: "yyyy-MM-dd", // 日志文件轮换的模式，按天轮换alwaysIncludePattern: true, // 始终在文件名中添加日期后缀daysToKeep: 90, // 保留最近 90 天的日志文件compress: true, // 启用日志文件压缩（.gz 格式）},},categories: {default: { appenders: ["out", "app"], level: "info" }, // 设置日志级别和输出方式},
});// 获取记录器
const logger = log4js.getLogger();// 记录不同级别的日志
logger.trace('This is a trace log');
logger.debug('This is a debug log');
logger.info('This is an info log');
logger.warn('This is a warn log');
logger.error('This is an error log');
logger.fatal('This is a fatal log');
配置解析：
stdout：将日志输出到控制台，方便开发人员实时查看程序的运行状态。file：将日志输出到文件，文件路径为logs/app.log。日志文件会按天进行轮换，并且每个文件名都会包含日期后缀（例如：app-2024-12-23.log）。pattern: "yyyy-MM-dd"：指定日志文件的轮换模式，这里设置为按天轮换。alwaysIncludePattern: true：确保日志文件名始终包含日期后缀。daysToKeep: 90：保留最近 90 天的日志文件，超过 90 天的日志文件会自动删除。compress: true：启用日志压缩功能，日志文件会以.gz格式保存，以节省磁盘空间。
日志级别
在 log4js 中，有六个主要的日志级别，分别是：
trace：最细粒度的日志，通常用于记录非常详细的调试信息。debug：调试信息，记录开发过程中的一些变量和流程。info：常规信息，用于记录程序的正常运行状态。warn：警告信息，记录潜在的问题，通常是应用程序的异常或错误，但并不会导致程序崩溃。error：错误信息，用于记录程序中的异常和错误。fatal：致命错误，记录会导致程序崩溃或无法继续运行的问题。
根据你的需求，你可以选择不同的日志级别来记录信息。例如，如果你只想记录程序正常运行的状态，可以将日志级别设置为 info，而如果你需要调试一些问题，可以使用 debug 或 trace 级别。
如何使用日志记录器
在配置完 log4js 后，可以通过 getLogger 获取日志记录器，并使用不同的级别来记录日志：
// 获取记录器
const logger = log4js.getLogger();// 记录不同级别的日志
logger.trace('This is a trace log'); // 最细粒度的日志
logger.debug('This is a debug log'); // 调试信息
logger.info('This is an info log'); // 常规信息
logger.warn('This is a warn log'); // 警告信息
logger.error('This is an error log'); // 错误信息
logger.fatal('This is a fatal log'); // 致命错误
日志级别使用场景：
trace：用于记录非常详细的调试信息，适用于调试代码时需要追踪每一步执行过程。debug：记录开发过程中常见的变量值和执行路径，帮助开发人员理解程序的运行状态。info：记录常规的运行状态，如程序启动、任务完成等。warn：用于记录警告信息，提醒开发人员注意潜在的问题。error：记录错误信息，通常用于捕捉异常和错误。fatal：记录致命错误信息，通常表示程序无法继续运行，需要立即修复。
日志文件轮换与压缩
在生产环境中，日志文件可能会迅速增长，导致占用大量磁盘空间。log4js 提供了日志文件轮换功能，可以根据配置自动将日志文件按日期或大小进行轮换。通过配置 daysToKeep 和 compress，你可以轻松管理日志文件的存储和压缩。
daysToKeep: 90：日志文件最多保存 90 天，超过这个时长的日志文件会被删除。compress: true：启用日志文件压缩功能，日志文件会被压缩为.gz格式，减少磁盘占用。
总结
通过 log4js，你可以在 Node.js 中方便地实现日志记录，并根据不同的需求灵活配置日志输出方式和轮换策略。本文通过一个示例介绍了如何配置 log4js，记录不同级别的日志信息，并展示了日志轮换和压缩的配置。无论是在开发环境调试，还是在生产环境监控应用，log4js 都是一个非常有效的日志工具。
