使用context包进行日志记录
最后更新于:2022-04-02 06:47:49
## 使用context包进行日志记录
本节将展示如何在各种函数间传递log操作。使用Go标准库中的context包是在函数之间传递和取消变量的绝佳方式。本节将探讨如何使用该方案在函数之间分配变量以进行日志记录。
本节使用到了上节中提到的apex库。
### 实践
1. 获取第三方库:
```
go get github.com/apex/log
```
2. 建立log.go:
```
package context
import (
"context"
"github.com/apex/log"
)
type key int
const logFields key = 0
func getFields(ctx context.Context) *log.Fields {
fields, ok := ctx.Value(logFields).(*log.Fields)
if !ok {
f := make(log.Fields)
fields = &f
}
return fields
}
// FromContext 接收一个log.Interface和context
// 然后返回由context对象填充的log.Entry指针
func FromContext(ctx context.Context, l log.Interface) (context.Context, *log.Entry) {
fields := getFields(ctx)
e := l.WithFields(fields)
ctx = context.WithValue(ctx, logFields, fields)
return ctx, e
}
// WithField 将log.Fielder添加到context
func WithField(ctx context.Context, key string, value interface{}) context.Context {
return WithFields(ctx, log.Fields{key: value})
}
// WithFields 将log.Fielder添加到context
func WithFields(ctx context.Context, fields log.Fielder) context.Context {
f := getFields(ctx)
for key, val := range fields.Fields() {
(*f)[key] = val
}
ctx = context.WithValue(ctx, logFields, f)
return ctx
}
```
3. 建立collect.go:
```
package context
import (
"context"
"os"
"github.com/apex/log"
"github.com/apex/log/handlers/text"
)
// Initialize调用3个函数来设置,然后在操作完成之前记录日志
func Initialize() {
log.SetHandler(text.New(os.Stdout))
//初始化context
ctx := context.Background()
// 将context与log.Log建立联系
ctx, e := FromContext(ctx, log.Log)
ctx = WithField(ctx, "id", "123")
e.Info("starting")
gatherName(ctx)
e.Info("after gatherName")
gatherLocation(ctx)
e.Info("after gatherLocation")
}
func gatherName(ctx context.Context) {
ctx = WithField(ctx, "name", "Go Cookbook")
}
func gatherLocation(ctx context.Context) {
ctx = WithFields(ctx, log.Fields{"city": "Seattle", "state": "WA"})
}
```
4. 建立main.go:
```
package main
import "github.com/agtorre/go-cookbook/chapter4/context"
func main() {
context.Initialize()
}
```
5. 这会输出:
```
INFO[0000] starting id=123
INFO[0000] after gatherName id=123 name=Go Cookbook
INFO[0000] after gatherLocation city=Seattle id=123 name=Go
Cookbook state=WA
```
### 说明
context包的使用在databases包和HTTP包中都可以看到。本节将log附加到context并将其用于记录日志以达到并发安全的目的。我们通过在方法中传递context来同时传递附加于其上的属性,以达到在最终调用位置记录日志的目的。
这些修改了存储在上下文中的单个值,并提供了使用context的另一个好处:可以执行取消和超时操作,并且线程安全。
* * * *
学识浅薄,错误在所难免。欢迎在群中就本书提出修改意见,以飨后来者,长风拜谢。
Golang中国(211938256)
beego实战(258969317)
Go实践(386056972)
';