對于線上項目用來說，日志是非常重要的一環。log4js是使用得比較多的一個日志組件，經常跟Express一起配合使用。本文從入門實例開始，講解log4js的使用，以及如何跟Express進行整合。

入門例子

輸出日志如下，包括日志打印時間、日志級別、日志分類、日志內容。

// started.jsvar 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"