node中使用log4js4.x版本记录日志的方法

当我们在使用Node.js编写应用时，日志记录是不可避免的需求。而log4js是一个广泛使用的Node.js日志记录库，其提供了很多有用功能。在本篇攻略中，我将向大家讲解如何在Node.js应用中使用log4js v4.x版本记录日志。

安装log4js

首先，我们需要安装log4js。使用以下命令可在Node.js项目中安装log4js：

npm install log4js

引入log4js

安装完log4js之后，我们需要在代码中引入它：

const log4js = require('log4js');

配置log4js

我们需要对log4js进行一些配置。在配置前，您需要新建一个log4js.json文件，该文件包含log4js的配置。您可以在此文件中指定log4js的日志输出格式和输出方式。

以下是一个样例配置文件：

{
  "appenders": {
    "file": {
      "type": "file",
      "filename": "logs/app.log",
      "maxLogSize": 10485760,
      "backups": 3,
      "compress": true
    },
    "stdout": {
      "type": "stdout"
    }
  },
  "categories": {
    "default": {
      "appenders": [
        "file",
        "stdout"
      ],
      "level": "all"
    }
  }
}

在上述配置中，我们指定了两个输出方式：文件输出和控制台输出。文件输出的文件名为logs/app.log，最大日志文件大小为10MB，会保留3个备份，并进行压缩存储。控制台输出使用默认配置。

使用以下代码可载入配置：

log4js.configure('./log4js.json');

使用loggers

在log4js中，我们使用logger进行日志记录。logger有一个名称，可以通过该名称指定日志记录的环境。例如，我们可以使用以下代码创建一个名为“myLogger”的logger：

const logger = log4js.getLogger('myLogger');

在上述代码中，我们为logger指定了一个名称“myLogger”。

记录日志

现在我们已经准备好记录日志了。使用logger的不同方法可以记录不同级别的日志，例如debug、info、warn和error。

以下是一些示例代码：

const logger = log4js.getLogger('myLogger');

logger.debug('debug message');
logger.info('info message');
logger.warn('warn message');
logger.error('error message');

以上代码将分别在配置文件中指定的输出目标中输出对应级别的日志信息。

除了这些基本的日志级别之外，log4js还提供了其他一些有用的功能。例如，您可以通过以下代码定义一个自定义的日志级别：

log4js.levels.addLevel('TRACE', { value: 1500, colour: 'cyan' });

然后您就可以使用logger.trace('trace message')来记录级别为“TRACE”的日志了。

示例说明

以下是一个示例，我们可以在其中看到基本的配置和日志记录：

const log4js = require('log4js');
log4js.configure({
  appenders: {
    console: { type: 'console' },
    file: {type: 'file', filename: 'logs/app.log'}
  },
  categories: {
    default: { appenders: ['console', 'file'], level: 'debug'}
  }
});
const logger = log4js.getLogger('myLogger');

logger.debug('debug message');
logger.info('info message');
logger.warn('warn message');
logger.error('error message');

在上述示例中，我们使用了控制台输出和文件输出。文件存储在logs/app.log中，日志记录级别为debug。

下面是另一个示例，其中我们使用了自定义的日志级别：

const log4js = require('log4js');
log4js.configure('./log4js.json');
const logger = log4js.getLogger('myLogger');
log4js.levels.addLevel('TRACE', { value: 1500, colour: 'cyan' });
logger.trace('trace message');

在上面的示例中，我们使用了我们前面已经定义的日志级别“TRACE”，并使用自定义的蓝绿色输出了一条Trace级别的日志。这条日志不会在默认的日志级别中输出，需要我们在日志配置中特意将其添加进去。