共计 1406 个字符,预计需要花费 4 分钟才能阅读完成。
说明
之前翻译的一个教程(没有备份原地址,梯子被封了)。原地址找到后补上
正文
zap 提供的字段编码器并一定完全合适自己的需求,比如:希望日志记录的输出和 syslog 或者其他常见的日志格式类似;可能希望日志中的时间戳忽略秒;将日志包含在方括号内等,这时候就需要自定义编码器了
性能因素
你可以自定义编码器 time,leve,caller 等。需要注意的是,编码器要尽可能高效,因为这是 zap 的内存、性能上的优势,毕竟每个日志行都要调用这些函数。所以要避免创建临时变量或者进行任何高强度的计算。
也就是说,下面的例子只是一个示范,不一定就是默认功能的最佳替代品。
自定义时间戳格式
这是一个常见的 syslog 格式的实现
func SyslogTimeEncoder(t time.Time, enc zapcore.PrimitiveArrayEncoder) {
enc.AppendString(t.Format(“jan 2 15:04:05”))
}
func main() {
cfg := zap.Config{
Encoding: “console”,
Level: zap.NewAtomicLevelAt(zap.DebugLevel),
OutputPaths: []string{“stderr”},
EncoderConfig: zapcore.EncoderConfig{
MessageKey: “message”,
TimeKey: “time”,
},
}
cfg.EncoderConfig.EncodeTime = SyslogTimeEncoder
logger, _ := cfg.Build()
logger.Info(“This should have a syslog style timestamp”)
}
输出
jan 1 09:22:59 This should have a syslog style timestamp
应该注意到,编码器应该将基元 (primitives) 附加到对象数组。zap 使用此数组以最小的内存分配有效的编码输出
自定义级别格式
func CustomLevelEncoder(level zapcore.Level, enc zapcore.PrimitiveArrayEncoder) {
enc.AppendString(“[” + level.CapitalString() + “]”)
}
func main() {
cfg := zap.Config{
Encoding: “console”,
Level: zap.NewAtomicLevelAt(zap.DebugLevel),
OutputPaths: []string{“stderr”},
EncoderConfig: zapcore.EncoderConfig{
MessageKey: “message”,
LevelKey: “level”,
},
}
cfg.EncoderConfig.EncodeLevel = CustomLevelEncoder
logger, _ := cfg.Build()
logger.Info(“This should have a bracketed level name”)
}
输出
[INFO] This should have a bracketed level name
注意:上面示例中,拼接多个子字符串形成一个字符串,并附加到数组中。这可能会导致临时内存分配。我不得不这样做,如果我单独附加子串,zap 会将他们视为输出中的单独字段,并将它们用空格隔开