Express进阶之log4js实用入门指南

对于线上项目用来说，日志是非常重要的一环。log4js是使用得比较多的一个日志组件，经常跟express一起配合使用。本文从入门实例开始，讲解log4js的使用，以及如何跟express进行整合。

入门例子

输出日志如下，包括日志打印时间、日志级别、日志分类、日志内容。

// started.js
var log4js = require('log4js');
var logger = log4js.getlogger();
logger.debug('hello world');

// 输出： 
// [2017-02-28 21:28:22.853] [debug] [default] - hello world

日志级别

logger.setlevel('info'); 表示想要打印的最低级别的日志是 info ，也就是说，调用类似 logger.debug() 等级别低于 info 的接口，日志是不会打印出来的。

var log4js = require('log4js');
var logger = log4js.getlogger();
logger.setlevel('info');

logger.debug('level: debug');
logger.info('level: info');
logger.error('level: error');

// 输出如下：
// [2017-02-28 21:50:45.372] [info] [default] - level: info
// [2017-02-28 21:50:45.376] [error] [default] - level: error

日志类别

除级别外，还可以对日志进行分类， log4js.getlogger(category) ，如下所示

var log4js = require('log4js');
var alogger = log4js.getlogger('category-a');
var blogger = log4js.getlogger('category-b');

alogger.info('hello');
blogger.info('hello');

// 输出如下：
// [2017-02-28 22:36:57.570] [info] category-a - hello
// [2017-02-28 22:36:57.574] [info] category-b - hello

appenders

appenders指定日志输出的位置，可以同时配置多个，用category进行区分。比如 log4js.getlogger('info') 应用的就是 type 为 datefile 的配置。

可以注意到， type 为 console 的配置没有声明 category ，因此，所有的日志都会打印到控制台。

var log4js = require('log4js');

log4js.configure({
  appenders: [
    { type: 'console'},
    { type: 'datefile', filename: './logs/info.log', category: 'info' }
  ]
});

var logger = log4js.getlogger('info');
logger.setlevel('info');

logger.trace('trace');
logger.debug('debug');
logger.info('info');

// 输出如下：
// [2017-02-28 22:51:30.723] [info] info - info

express应用

一个比较简单的例子如下，日志全部打印到控制台。

var express = require('express');
var log4js = require('log4js');
var app = express();

log4js.configure({
  appenders: [
    { type: 'console', category: 'app' }
  ]
});

var logger = log4js.getlogger('app');

logger.setlevel('info'); // 级别 > info 的日志才会被打印

app.use( log4js.connectlogger(logger) );

app.use(function(req, res, next){
  res.send('ok');
});

app.listen(3000);

访问 http://127.0.0.1:3000 ，打印日志如下

[2017-03-01 00:28:29.301] [info] app - ::ffff:127.0.0.1 - - "get / http/1.1" 304 - "" "mozilla/5.0 (macintosh; intel mac os x 10_11_4) applewebkit/537.36 (khtml, like gecko) chrome/56.0.2924.87 safari/537.36"

log4js.connectlogger(logger) 时，可以声明日志的级别。

// 级别 > info 的日志才会被打印
logger.setlevel('info'); 

// 日志的级别是 warn 
app.use( log4js.connectlogger(logger, {level: 'warn'}) );

注意，如果声明的日志级别低于 logger.setlevel(level) 限定的级别，那么日志不会被打印，如下例子。

logger.setlevel('info'); 

app.use( log4js.connectlogger(logger, {level: 'debug'}) );

相关链接

官网：

以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持。