开发过程中,日志记录是不可缺少的事情。尤其是生产系统中常常无法调试,因此日志就成了重要的调试信息来源。
Node.js,已经有现成的开源日志模块,就是log4js,源代码地址:
项目引用方法: npm install log4js
1、配置说明(仅以经常使用的dateFile日志类型举例。很多其它说明參考):
{ "appenders": [ // 以下一行应该是用于跟express配合输出web请求url日志的 {"type": "console", "category": "console"}, // 定义一个日志记录器 { "type": "dateFile", // 日志文件类型,能够使用日期作为文件名称的占位符 "filename": "e:/weblogs/logs/", // 日志文件名称。能够设置相对路径或绝对路径 "pattern": "debug/yyyyMMddhh.txt", // 占位符。紧跟在filename后面 "absolute": true, // filename是否绝对路径 "alwaysIncludePattern": true, // 文件名称是否始终包括占位符 "category": "logInfo" // 记录器名 } ], "levels":{ "logInfo": "DEBUG"} // 设置记录器的默认显示级别,低于这个级别的日志,不会输出}pattern能够使用的占位符说明,不属于下列占位符格式。均会原样输出为文件名称(注:不支持单个M、d、h、m): yy 两位年份 yyyy 四位年份 MM 两位月份 dd 两位日期 hh 两位的小时数。按24小时制 mm 两位的分数数 ss 两位的秒数 SSS 三位的毫秒数 O 时区,大写字母O,占位符输出结果为+0800
如果当前是2014年6月20月15点,那么上面的配置终于将会记录到 e:\weblogs\logs\debug\2014062015.txt这个文件里。
2、输出日志代码,首先请把上面的配置代码保存为log4js.json文件。用于代码从文件载入配置(配置独立也便于改动和公布):
注意:json文件不支持不论什么形式的凝视// 或 /**/,因此上面的配置代码里的凝视要所有移除,不然会编译出错的var log4js = require('log4js');// 注:配置里的日志文件夹要先创建,才干载入配置,不然会出异常log4js.configure("./log4js.json");var logInfo = log4js.getLogger('logInfo');logInfo.info("測试日志信息");上述配置和代码,比較简单,我这边參考之前用的C#版本号的日志记录类。又一次封装了一下log4js。定义了一个logHelper.js
1、log4js.json配置文件内容(定义了4个日志记录器。分别写入到不同的日志文件夹;并自己定义了2个属性,把一些公共属性提取到自己定义属性中):
{ "customBaseDir" :"e:/weblogs/logs/", "customDefaultAtt" :{ "type": "dateFile", "absolute": true, "alwaysIncludePattern": true }, "appenders": [ {"type": "console", "category": "console"}, {"pattern": "debug/yyyyMMddhh.txt", "category": "logDebug"}, {"pattern": "info/yyyyMMddhh.txt", "category": "logInfo"}, {"pattern": "warn/yyyyMMddhh.txt", "category": "logWarn"}, {"pattern": "err/yyyyMMddhh.txt", "category": "logErr"} ], "replaceConsole": true, "levels":{ "logDebug": "DEBUG", "logInfo": "DEBUG", "logWarn": "DEBUG", "logErr": "DEBUG"}}2、logHelper.js封装的文件内容:
var helper = {};exports.helper = helper;var log4js = require('log4js');var fs = require("fs");var path = require("path");// 载入配置文件var objConfig = JSON.parse(fs.readFileSync("log4js.json", "utf8"));// 检查配置文件所需的文件夹是否存在,不存在时创建if(objConfig.appenders){ var baseDir = objConfig["customBaseDir"]; var defaultAtt = objConfig["customDefaultAtt"]; for(var i= 0, j=objConfig.appenders.length; i3、代码调用:
var logger = require("./logHelper").helper;logger.writeInfo("哈哈1開始记录日志");logger.writeErr("出错了。你怎么搞的");4、跟express集成,能够输出clientGET 或 POST的url(假设没用。或者不须要记录url。这段代码忽略):
//在app.js中加入下面代码, 以便在日志中输出url请求。因为载入顺序的原因,放在其它app.use前面var app = express();var log = require('./logHelper');log.use(app);