Node.js日志框架选型比較：Bunyan

前一篇Node.js日志框架选型比較：Winston

Bunyan

Bunyan(by Trent Mick)是另外一个值得考虑的日志框架，以稍微不同的方式处理结构化，机器可读性被重点对待。

其结果是，bunyan每行日志记录实际上就是JSON.stringify的一个输出。

安装（Installation）

npm install bunyan

使用（Usage）

JSON

Bunyan和Winston之间一个关键的差别是Bunyan能够处理复杂的上下文环境和对象。再看上面的样例：
log.warn({lang: 'fr'},'au revoir');
{"name":"myapp","hostname":"pwony-2","pid":12616,"level":40,"lang":"fr","msg":"au revoir","time":"2014-05-26T17:58:32.837Z","v":0}
你能够看到bunyan把语言參数合并进了日志结果。再看看以下这个：
log.info(user, 'registered');
log.info({user:user},'registered');
Which produces:
{"name":"myapp","hostname":"pwony-2","pid":14837,"level":30,"username":"alex","email":"...@gmail.com","msg":"registered","time":"2014-05-26T18:27:43.530Z","v":0}
{"name":"myapp","hostname":"pwony-2","pid":14912,"level":30,"user":{"username":"alex","email":"...@gmail.com"},"msg":"registered","time":"2014-05-26T18:28:19.874Z","v":0}
通过punyan管道处理后：
[2014-05-26T18:28:42.455Z] INFO: myapp/14943 on pwony-2: registered (username=alex,email=...@gmail.com)
[2014-05-26T18:28:42.457Z] INFO: myapp/14943on pwony-2:registered
user:{
"username": "alex",
"email":"...@gmail.com"
}
当我们使用子日志（Child Loggers）时，这样的处理方式的美妙之处将表露无遗。

子日志（Child Loggers）

Bunyan有一个子日志的概念，这同意为你的应用程序的某个子组件指定日志实例。

也即是。创建一个新的日志实例使得能够处理额外的字段。

子日志通过log.child(...)方法创建。这为记录系统、请求以及简单函数这些不同作用域的组件日志带来极大的方便。
如果你想把请求ID记入该请求范围内的全部日志中，这样你能够把这些日志关联绑定在一起。

varbunyan= require('bunyan');
var log = bunyan.createLogger({name:'myapp'});

app.use(function(req, res,next) {
req.log=log.child({reqId: uuid()});
next();
});

app.get('/', function(req, res) {
req.log.info({user:...});
});
req.log日志实例将总是把它的上下文传递给log.child()函数并和全部兴许调用合并，输出例如以下:
{"name":"myapp","hostname":"pwony-2","pid":14837,"level":30,"reqId":"XXXX-XX-XXXX","user":"...@gmail.com","time":"2014-05-26T18:27:43.530Z","v":0}

序列化器（Serializers）

Bunyan在格式化整个对象时有两个问题:
1循环引用（Circular references）。Winston在这里更聪明些，会检測发生的循环情况。
2多余的数据（Unwanted noises）. 我认为在Bunyan中对象是第一位的。所以非常easy形成习惯把对象直接dump到日志中。
为了处理这两个问题，Bunyan有一个序列化器的概念，基本上就是一些转换函数，把对象转换为部分字段的输出格式:
function reqSerializer(req) {
return{
method:req.method,
url: req.url,
headers: req.headers
}
}

var log = bunyan.createLogger({name:'myapp',serializers:{req: reqSerializer}});
log.info({req:req});
这样就仅仅记录我们感兴趣的请求的方法、url和头部字段。

流（Streams）

Bunyan流的概念和Winston中的传输（transporters）概念一样 – 发送您的日志到一些地方用来显示和存储。
Bunyan使用具有一些额外属性的可写流接口。

一个Bunyan日志记录器实例拥有1个或多个指定流选项的流：
var log=bunyan.createLogger({
name: "foo",
streams:[
{
stream: process.stderr,
level: "debug"
},
...
]

});

怎样选择

Winston和Bunyan都是非常成熟的两个框架，Winston有一个强大的社区支持，而Bunyan使得日志的进一步系统分析处理非常方便。

两个系统怎样选择的关键因素是“是否能和你的应用系统方便的集成”。

by iefreer - founder of techbrood.com