在知识星球简书项目中，我们分析对比了目前的一些日志库。虽然 Go 标准库有一个 log，但功能有限，所以才出现了很多第三方的日志库。在 用 Go 实现一个简书 8：日志记录和优秀库的学习 中，我们得出结论，推荐大家使用 zerolog 。现在我们就将 zerolog 集成进 Echo 框架中。
Echo 日志记录的默认格式是 JSON，可以通过修改标头来更改，即 Echo#Logger.SetHeader(io.Writer)。
标头默认值为：
{"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"
/* ... */
if l, ok := e.Logger.(*log.Logger); ok {
l.SetHeader("${time_rfc3339} ${level}")
}
这样输出的标头成为：2018-05-08T20:30:06-07:00 INFO info。
目前，预定义的 tag 有：
time_rfc3339：时间格式time_rfc3339_nano：带纳秒的时间格式level：级别prefix：前缀long_file：长文件名（带路径）short_file：短文件名（不带路径）line：文件行号Echo#Logger.SetOutput(io.Writer) 可以设置日志输出的目的地。默认输出到标准输出。如果想禁用日志，有两种方式：
默认情况下，日志的级别是 ERROR。可以通过 Echo#Logger.SetLevel(log.Lvl) 修改。一共有如下一些级别：
DEBUGINFOWARNERROROFF以上就是 Echo 框架提供的可以定制 Log 的相关接口。
Echo 支持通过Echo#Logger 注册自定义的 Logger，前提是这个 Logger 必须实现 Echo 提供的接口：echo.Logger：
type Logger interface {
Output() io.Writer
SetOutput(w io.Writer)
Prefix() string
SetPrefix(p string)
Level() log.Lvl
SetLevel(v log.Lvl)
SetHeader(h string)
Print(i ...interface{})
Printf(format string, args ...interface{})
Printj(j log.JSON)
Debug(i ...interface{})
Debugf(format string, args ...interface{})
Debugj(j log.JSON)
Info(i ...interface{})
Infof(format string, args ...interface{})
Infoj(j log.JSON)
Warn(i ...interface{})
Warnf(format string, args ...interface{})
Warnj(j log.JSON)
Error(i ...interface{})
Errorf(format string, args ...interface{})
Errorj(j log.JSON)
Fatal(i ...interface{})
Fatalj(j log.JSON)
Fatalf(format string, args ...interface{})
Panic(i ...interface{})
Panicj(j log.JSON)
Panicf(format string, args ...interface{})
}
这个接口看着很吓人，基本上是几个日志级别对应的方法。因此，如果我们要将 zerolog 集成进 Echo，让 zerolog 实现该接口（zerolog 本身肯定没有实现该接口）。
因为 zerolog 库的设计和 API 与 echo.Logger 接口差异极大，想要直接为 zerolog 实现一个 Adapter 以便实现 echo.Logger 接口不太现实。于是我们做如下处理来进行适配：
type Logger struct {
*log.Logger
ZeroLog zerolog.Logger
}
我们定义一个自己的 Logger 结构体，内嵌一个 github.com/labstack/gommon/log 库的 Logger 指针，这样默认就实现了 echo.Logger 接口，然后再是 zerolog.Logger。看看构造函数如何实现？
func New(writer io.Writer) *Logger {
l := &Logger{
Logger: log.New("-"),
ZeroLog: zerolog.New(writer).With().Caller().Timestamp().Logger(),
}
// log 默认是 ERROR，将 Level 默认都改为 INFO
l.SetLevel(log.INFO)
l.Logger.SetOutput(writer)
return l
}
这么做有什么用？还不如干脆 echo 框架自己的日志由它处理，我们的日志使用 zerolog 处理。这样当然是可以的。但集成在一起有如下好处：
那统一控制行为如何实现呢？这里实现了两个，控制输出目的地和日志级别。
func (l *Logger) SetOutput(writer io.Writer) {
l.Logger.SetOutput(writer)
l.ZeroLog.Output(writer)
}
func (l *Logger) SetLevel(level log.Lvl) {
l.Logger.SetLevel(level)
if level == log.OFF {
l.ZeroLog = l.ZeroLog.Level(zerolog.Disabled)
} else {
zeroLevel := int8(level) - 1
l.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。
在 go-echo-example 项目的 cmd 下创建一个目录 gopher，将来我们的实战篇就用它作为入口。之后创建一个 main.go 文件，核心代码如下：
func main() {
e := echo.New()
e.Logger = logger.New(os.Stdout)
// e.Logger.SetLevel(log.DEBUG)
e.Use(middleware.Recover())
e.GET("/", func(ctx echo.Context) error {
ctx.Logger().Debugf("This is echo logger debug msg!")
zerolog := ctx.Logger().(*logger.Logger).ZeroLog
zerolog.Debug().Str("path", ctx.Path()).Msg("This is Debug msg!")
return ctx.HTML(http.StatusOK, "Hello World!")
})
e.Logger.Fatal(e.Start(":2020"))
}
我们得到 echo 的实例后，将其日志设置为我们自定义的 logger：e.Logger = logger.New(os.Stdout)。注意注释掉的代码。运行程序：go run main.go，打开浏览器访问 http://localhost:2020 ，看看日志是否有两条 Debug 记录。接着将注释去掉再次测试，看日志是否有输出。
不出意外，一切都符合预期。恭喜你大功告成！
完整代码点这里 。
此内容由惯性聚合(RSS阅读器)自动聚合整理，仅供阅读参考。 原文来自 — 版权归原作者所有。