Versions Compared
compared with
Key
- This line was added.
- This line was removed.
- Formatting was changed.
从v2
版本开始,glog
组件将ctx
上下文变量作为日志打印的必需参数。
自定义CtxKeys
记录
使用配置
glog
支持标准库context.Context
接口对象中上下文变量的自动读取打印。
键名配置
我们推荐使用配置文件来对上下文中的键名进行配置,例如:Code Block | ||
---|---|---|
| ||
# 日志组件配置 [logger] Path = "/var/log/my-app" Level = "all" Stdout = false CtxKeys = ["RequestId"] |
其中CtxKeys
用于配置需要从context.Context
接口对象中读取并输出的键名。
日志输出
在输出日志的时候,需要通过Ctx
链式操作方法指定输出的context.Context
接口对象,例如:
Code Block | ||
---|---|---|
| ||
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: // ... |
日志示例
Image Added
链路跟踪
从goframe v1.15
版本开始,日志组件增加了对OpenTelemetry
规范的链路跟踪支持,该支持是标准化形式的,无需开发者做任何设置,具体请参考章节:链路跟踪(更新中)
除了链路跟踪能够实现全链路的TraceId
记录打印之外,由于框架组件完备并且设计良好,因此glog
组件也可以实现最小成本的自定义全链路跟踪信息打印。像这样:
Image Removed
1、通过中间件注入RequestId
通过中间件往Context
中注入RequestId
,并且将RequestId
写入到返回的Header
中。
Image Removed
2、通过配置文件设置Context Key
为默认的logger
以及database logger
设置Context Key
,便于日志打印时自动读取。
Image Removed
Panel | ||
---|---|---|
| ||
|