日志

概述

go-zero 提供了一个强大的日志包, logxlogc 可以供用户进行日志打印。

logx 与 logc

这2个包的区别,logc 是对 logx 的封装,我们可以带上 context 进行日志打印。 如下的代码是等效的,

  1. logx.WithContext(ctx).Info("hello world")
  2. logc.Info(ctx, "hello world")

日志的基本使用

我们提供各种快捷方式供打印日志。如下

  1. ctx := context.Background()
  2. logc.Info(ctx, "info message")
  3. logc.Errorf(ctx, "error message: %d", 123)
  4. logc.Debugw(ctx, "info filed", logc.Field("key", "value"))
  5. logc.Slowv(ctx, "object")

详情见 logclogx

日志的初始化与相关的配置

我们提供丰富的日志设置的能力,可以通过配置进行设置,详情见 日志配置

我们可以通过 如下的方式进行初始化。

  1. logx.MustSetup(logx.LogConf{})

重定向日志输出

在 go-zero 我们可以重定向日志的输出, 通过如下的方式进行

  1. func SetWriter(w Writer)

具体使用例如:

  1. logx.SetWriter(logx.NewWriter(os.Stdout))

我们将日志重定向 stdout, 当然也可以封装各自的输出路径。

日志级别

go-zero 有2种方式可以设置 level,一种通过配置进行设置,详情见日志配置

还有一种通过 logx.SetLevel() 进行设置。 支持的日志级别如下。

  1. const (
  2. // DebugLevel logs everything
  3. DebugLevel uint32 = iota
  4. // InfoLevel does not include debugs
  5. InfoLevel
  6. // ErrorLevel includes errors, slows, stacks
  7. ErrorLevel
  8. // SevereLevel only log severe messages
  9. SevereLevel
  10. )

本方法是线程安全的,可以在业务执行的过程中,通过调整日志级别。

日志关闭

因为日志打印是异步操作,所以在程序退出的时候,我们需要 close 日志,否则可能会出现日志丢失的情况。

  1. logc.Close()

备注,我们在 zrpc,reset 已经操作了日志的关闭.

重置日志

在一些特殊的业务流程中,如果我们设置 writer 之后,需要重置 writer,可以使用如下方式进行重置。

  1. logx.Reset()

这样,所有的日志将会变成默认的输出模式,如果需要,可以再次自行初始化日志。

日志 caller 设置

目前 go-zero 默认会打印当前日志打印的行数。当时我们封装一些方法的时候需要知道上次的调用层次,可以使用 logx.WithCallerSkip(1) 设置 caller 的层次。例如:

  1. package main
  2. import (
  3. "github.com/zeromicro/go-zero/core/logx"
  4. )
  5. func main() {
  6. exec()
  7. }
  8. func exec() error {
  9. logx.WithCallerSkip(1).Info("exec info") // {"@timestamp":"2023-04-23T17:30:09.962+08:00","caller":"inherit/main.go:8","content":"exec info","level":"info"}
  10. return nil
  11. }

如上我们可以打印 exec 的位置。。这种对封装方法获取调用特别有效。

日志文件分割

go-zero在文件输出模式下面,支持2种文件的分割模式 按照天 和 按照大小进行分割, 详情见Rotation

在 日期分割模式下面,go-zero 将会每天晚上0点,将 access.log, error.log, stat.log, slow.log 进行备份,并且创建新的日志文件进行日志打印。 同时会判断日志个数,如果超过 KeepDays 的设置,将会移出历史的旧的配置文件。

在 大小分割模式下面,go-zero 将会记录当前日志文件的大小,超过 MaxSize 将会分割日志。