{"time":"${time_rfc3339_nano}","level":"${level}","prefix":"${prefix}","file":"${short_file}","line":"${line}"}
由于 Echo 默认利用的 Logger 是作者开拓的 github.com/labstack/gommon/log 库,我们看看怎么自定义默认标头。
import"github.com/labstack/gommon/log"/.../ifl,ok:=e.Logger.(log.Logger);ok{l.SetHeader("${time_rfc3339}${level}")}
这样输出的标头成为:2018-05-08T20:30:06-07:00 INFO info。
目前,预定义的 tag 有:

Echo#Logger.SetOutput(io.Writer) 可以设置日志输出的目的地。默认输出到标准输出。如果想禁用日志,有两种办法:
Echo#Logger.SetOutput(ioutil.Discard)Echo#Logger.SetLevel(log.OFF)Log 级别默认情形下,日志的级别是 ERROR。可以通过 Echo#Logger.SetLevel(log.Lvl) 修正。一共有如下一些级别:
DEBUGINFOWARNERROROFF以上便是 Echo 框架供应的可以定制 Log 的干系接口。
自定义 LoggerEcho 支持通过Echo#Logger 注册自定义的 Logger,条件是这个 Logger 必须实现 Echo 供应的接口:echo.Logger:
typeLoggerinterface{Output()io.WriterSetOutput(wio.Writer)Prefix()stringSetPrefix(pstring)Level()log.LvlSetLevel(vlog.Lvl)SetHeader(hstring)Print(i...interface{})Printf(formatstring,args...interface{})Printj(jlog.JSON)Debug(i...interface{})Debugf(formatstring,args...interface{})Debugj(jlog.JSON)Info(i...interface{})Infof(formatstring,args...interface{})Infoj(jlog.JSON)Warn(i...interface{})Warnf(formatstring,args...interface{})Warnj(jlog.JSON)Error(i...interface{})Errorf(formatstring,args...interface{})Errorj(jlog.JSON)Fatal(i...interface{})Fatalj(jlog.JSON)Fatalf(formatstring,args...interface{})Panic(i...interface{})Panicj(jlog.JSON)Panicf(formatstring,args...interface{})}
这个接口看着很吓人,基本上是几个日志级别对应的方法。因此,如果我们要将 zerolog 集成进 Echo,让 zerolog 实现该接口(zerolog 本身肯定没有实现该接口)。
由于 zerolog 库的设计和 API 与 echo.Logger 接口差异极大,想要直接为 zerolog 实现一个 Adapter 以便实现 echo.Logger 接口不太现实。于是我们做如下处理来进行适配:
typeLoggerstruct{log.LoggerZeroLogzerolog.Logger}
我们定义一个自己的 Logger 构造体,内嵌一个 github.com/labstack/gommon/log 库的 Logger 指针,这样默认就实现了 echo.Logger 接口,然后再是 zerolog.Logger。看看布局函数如何实现?
funcNew(writerio.Writer)Logger{l:=&Logger{Logger:log.New("-"),ZeroLog:zerolog.New(writer).With().Caller().Timestamp().Logger(),}//log默认是ERROR,将Level默认都改为INFOl.SetLevel(log.INFO)l.Logger.SetOutput(writer)returnl}
这么做有什么用?还不如干脆 echo 框架自己的日志由它处理,我们的日志利用 zerolog 处理。这样当然是可以的。但集成在一起有如下好处:
形式上变成了一个日志类,也便是我们自定义的 Logger;方便统一掌握,比如输出目标、日志级别;通过一个日志库,既可以做到单独掌握 echo 的行为,也可以单独掌握 zerolog 的行为;那统一掌握行为如何实现呢?这里实现了两个,掌握输出目的地和日志级别。
func(lLogger)SetOutput(writerio.Writer){l.Logger.SetOutput(writer)l.ZeroLog.Output(writer)}func(lLogger)SetLevel(levellog.Lvl){l.Logger.SetLevel(level)iflevel==log.OFF{l.ZeroLog=l.ZeroLog.Level(zerolog.Disabled)}else{zeroLevel:=int8(level)-1l.ZeroLog=l.ZeroLog.Level(zerolog.Level(zeroLevel))}}
当然这种办法也有麻烦的地方,那便是通过 echo 的 Context 得到 zerolog 日志实例:
zerolog:=ctx.Logger().(logger.Logger).ZeroLog
这样自定义日志库就完成了。该库完全代码见:https://github.com/polaris1119/go-echo-example/blob/master/pkg/logger/logger.go。
在 Echo 项目中利用自定义日志库在 go-echo-example 项目的 cmd 下创建一个目录 gopher,将来我们的实战篇就用它作为入口。之后创建一个 main.go 文件,核心代码如下:
funcmain(){e:=echo.New()e.Logger=logger.New(os.Stdout)//e.Logger.SetLevel(log.DEBUG)e.Use(middleware.Recover())e.GET("/",func(ctxecho.Context)error{ctx.Logger().Debugf("Thisisechologgerdebugmsg!")zerolog:=ctx.Logger().(logger.Logger).ZeroLogzerolog.Debug().Str("path",ctx.Path()).Msg("ThisisDebugmsg!")returnctx.HTML(http.StatusOK,"HelloWorld!")})e.Logger.Fatal(e.Start(":2020"))}
我们得到 echo 的实例后,将其日志设置为我们自定义的 logger:e.Logger = logger.New(os.Stdout)。把稳注释掉的代码。运行程序:go run main.go,打开浏览器访问 http://localhost:2020 ,看看日志是否有两条 Debug 记录。接着将注释去掉再次测试,看日志是否有输出。
不出意外,统统都符合预期。恭喜你大功告成!
完全代码点这里[3]。
参考资料[1]
用 Go 实现一个简书 8:日志记录和精良库的学习: https://studygolang.com/topics/10625
[2]
zerolog: https://github.com/rs/zerolog
[3]
完全代码点这里: https://github.com/polaris1119/go-echo-example/tree/091967f4bea4a3f9ee7c20411f15287d2c950e02
私聊小编,领取全套Go资料,每天学习 Go 措辞