Versions Compared
compared with
Key
- This line was added.
- This line was removed.
- Formatting was changed.
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().Ctx(ctx).Error("runtime error") // May Output: // 2020-06-08 20:17:03.630 [ERRO] { |
RequestId: 123456789} runtime error // Stack: // ... |
链路跟踪
从goframe v1.15
版本开始,日志组件增加了对OpenTelemetry
规范的链路跟踪支持,该支持是标准化形式的,无需开发者做任何设置,具体请参考章节:链路跟踪
使用示例
除了链路跟踪能够实现全链路的TraceId
记录打印之外,由于框架组件完备设计良好设计,因此glog
组件也可以实现最小成本的全链路跟踪信息打印。像这样:
Image Added
1、通过中间件注入RequestId
通过中间件往Context
中注入RequestId
,并且将RequestId
写入到返回的Header
中。
Image Added
2、通过配置文件设置Context Key
为默认的logger
以及database logger
设置Context Key
,便于日志打印时自动读取。
Image Added
Panel | ||
---|---|---|
| ||
|