node 日誌管理log4js

node 日誌管理log4js

1、默認的控制檯輸出

咱們使用express框架時，開發模式用node或者supervisor啓動nodejs應用時，控制檯都是顯示以下的日誌。

GET /css/bootstrap.min.css 304 1ms
GET /css/my.css 304 0ms
GET /js/bootstrap.min.js 304 4ms
GET /js/jquery-1.9.1.min.js 304 6ms
GET /js/holder.js 304 3ms
GET /cat/json/latest 200 6ms
GET /cat/json/master 200 4ms
GET /cat/json/classic 200 2ms
GET /about 200 6ms
GET /css/bootstrap.min.css 304 2ms
GET /css/my.css 304 2ms
GET /js/bootstrap.min.js 304 2ms
GET /js/jquery-1.9.1.min.js 304 1ms
GET /js/holder.js 304 1ms
GET /js/bootstrap.min.js 304 1ms
GET / 304 6ms
GET /js/jquery-1.9.1.min.js 304 2ms
GET /css/my.css 304 1ms
GET /css/bootstrap.min.css 304 1ms
GET /js/bootstrap.min.js 304 2ms
GET /js/holder.js 304 2ms
GET /cat/json/latest 200 3ms
GET /cat/json/master 200 2ms
GET /cat/json/classic 200 2ms
GET /admin/ 304 13ms
GET /css/bootstrap.min.css 304 3ms
GET /js/jquery-1.9.1.min.js 304 2ms
GET /css/my.css 304 2ms
GET /js/bootstrap.min.js 304 1ms
GET /js/holder.js 304 2ms

 

咱們也能夠在代碼中，用console.log()打印一些控制檯日誌。

修改routes/index.js

exports.index = function(req, res){
console.log("This is an index page!");
res.render('index', {
        title:'首頁|moive.me',
        page:'index'
    });
};

 

訪問頁面，結果以下：

This is an index page!
GET / 304 19ms
GET /css/bootstrap.min.css 304 4ms
GET /css/my.css 304 2ms
GET /js/jquery-1.9.1.min.js 304 38ms
GET /js/holder.js 304 29ms
GET /js/bootstrap.min.js 304 28ms

這樣的輸出的結果，都是在控制檯顯示，一旦server重啓日誌就丟失了。對於程序開發來講，這樣的輸出已經夠用了。可是在生產環境上，咱們但願能把控制檯的輸出，保存到文件中，並且須要更多的信息，不單單是默認的簡化的日誌信息。

因爲express框架沒有日誌功能，咱們須要引入log4js包來完成這個功能。

2、配置log4js與express框架集成

一、安裝

npm install log4js

二、修改項目入口配置文件，如日誌分析項目express.js

var log4js = require('log4js');
log4js.configure({
  appenders: [
    { type: 'console' }, //控制檯輸出
    {
      type: 'file', //文件輸出
      filename: 'logs/log.log', 
      maxLogSize: 1024,
      backups:3,
      category: 'normal' 
    }
  ]
});
var logger = log4js.getLogger('normal');
logger.setLevel('INFO');
...

app.use(log4js.connectLogger(logger, {level:log4js.levels.INFO}));
app.use(app.router);

 

須要在express.js中進行log4js的配置。 appenders中配置了兩個輸出，一個是控制檯輸出，一個是文件輸出。

appenders.type=file的對象,指定文件輸出位置及文件大小，當超過maxLogSize大小時，會自動生成一個新文件。logs的文件目錄要動手建立。 level:log4js.levels.INFO, 設置默認日誌輸出級別是INFO。

log4js的輸出級別6個: trace, debug, info, warn, error, fatal

• logger.trace(‘Entering cheese testing’);
• logger.debug(‘Got cheese.’);
• logger.info(‘Cheese is Gouda.’);
• logger.warn(‘Cheese is quite smelly.’);
• logger.error(‘Cheese is too ripe!’);
• logger.fatal(‘Cheese was breeding ground for listeria.’);

若是輸出級別是INFO，則不會打印出低於info級別的日誌trace,debug，只打印info,warn,error,fatal。這樣作 的好處在於，在生產環境中咱們可能只關心異常和錯誤，並不關心調試信息。從而大大減小日誌的輸出，能減小磁盤寫入。而在開發環境中，咱們能夠須要打印很是 多的信息，幫助開發人員定位錯誤，調試代碼。

還有一個好處就是，代碼中能夠混有各類的日誌打印代碼。咱們只要在一個配置文件中，修改輸出級別，日誌輸出就會發生變化，不用修改全部的代碼。若是全部地方都是console.log()，那麼上線的時候，改動這個東西就要花不少時間。

3、根據項目配置log4js

1. 增長replaceConsole代替console.log() 增長replaceConsole配置，讓全部console輸出到日誌中，以[INFO] console代替console默認樣式。

    var log4js = require('log4js');
    log4js.configure({
      appenders: [
        { type: 'console' },{
          type: 'file', 
          filename: 'logs/log.log', 
          maxLogSize: 1024,
          backups:4,
          category: 'normal' 
        }
      ],
      replaceConsole: true
    });

2. 調整日誌輸出的格式

    app.use(log4js.connectLogger(logger, {level: 
    level:log4js.levels.INFO, format:':method :url'}));

    

3. 自動調整日誌輸出級別

    日誌級別對應規則：
    http responses 3xx, level = WARN
    http responses 4xx & 5xx, level = ERROR
    else, level = INFO  

    

   設置level爲auto:

     app.use(log4js.connectLogger(logger, {level: 'auto', format:':method :url'}));

    

4、調整log4js結構

咱們在配置log4js時會有一個問題。就是以上全部配置信息都是在express.js中作的，logger也是在這裏直接定義的。若是在控制器(routes)想用log4js進行輸出，咱們如今拿不到logger的句柄。

新創建log.js

var log4js = require('log4js');

log4js.configure({

    appenders: [
        {
            type: 'console',
            category: "console"

        }, //控制檯輸出
        {
            type: "file",
            filename: 'logs/log.log',
            pattern: "_yyyy-MM-dd",
            maxLogSize: 20480,
            backups: 3,
            category: 'dateFileLog'

        }//日期文件格式
    ],
    replaceConsole: true,   //替換console.log
    levels:{
        dateFileLog: 'debug',
        console: 'debug'
    }
});


var dateFileLog = log4js.getLogger('dateFileLog');
var consoleLog = log4js.getLogger('console');
exports.logger = consoleLog;


exports.use = function(app) {
    app.use(log4js.connectLogger(consoleLog, {level:'INFO', format:':method :url'}));
}

 

咱們把logger單獨定義出來，而且作爲API暴露出來，此處是開發調試，沒有使用文件輸出。 這樣在其餘模塊中使用logger輸出日誌只需以下操做：

var logger = require('../../log').logger;
logger.debug("collectTime=%s",collectTime);

樣咱們就已經玩轉log4js了，若是部署生產須要文件輸出只要修改log.js中dateFileLog級別，而後設置exports.logger=dateFileLog便可。

原文地址：http://www.blogways.net/blog/2014/06/09/node-log4js.html, 感謝原做者分享。