从v2
版本开始,glog
组件将ctx
上下文变量作为日志打印的必需参数。
自定义CtxKeys
日志组件支持自定义的键值打印,通过ctx
上下文变量中读取。
使用配置
# 日志组件配置
logger:
Path: "/var/log/my-app"
Level: "all"
Stdout: false
CtxKeys: ["RequestId"]
其中CtxKeys
用于配置需要从context.Context
接口对象中读取并输出的键名。
日志输出
在输出日志的时候,需要通过Ctx
链式操作方法指定输出的context.Context
接口对象,例如:
ctx := context.WithValue(context.Background(), "RequestId", "123456789")
g.Log().Error(ctx,"runtime error")
// May Output:
// 2020-06-08 20:17:03.630 [ERRO] {123456789} runtime error
// Stack:
// ...
日志示例
传递给Handler
如果开发者自定义了日志对象的Handler
,那么每个日志打印传递的ctx
上下文变量将会传递给Handler
中。关于日志Handler
的介绍请参考章节:日志组件-Handler
链路跟踪支持
glog
组件支持OpenTelemetry
标准的链路跟踪特性,该支持是内置的,无需开发者做任何设置,具体请参考章节:服务链路跟踪