Go slog 上手指南结构化日志与零配置性能log 包被诟病太久了。Go 1.21 带来官方新 slog本文用最简方式带你完成从 log 到 slog 的升级。一、为什么选 slog1.21 起官方推荐同时提供结构化与文本输出内置 logger pool、handler 路由importlog/sloglogger:slog.New(slog.NewJSONHandler(os.Stdout,nil))logger.Info(user login,user_id,1,ip,1.2.3.4)二、Handler 自定义typeFileHandlerstruct{chchan*slog.Record w io.Writer mu sync.Mutex}func(h*FileHandler)Handle(_context.Context,r slog.Record)error{bytes,_:json.Marshal(struct{Timestringjson:timeLevelstringjson:levelMsgstringjson:msgAttrs[]slog.Attrjson:attrs}{r.Time.Format(time.RFC3339),r.Level.String(),r.Message,r.Attrs})h.mu.Lock()deferh.mu.Unlock()h.w.Write(bytes)returnnil}可以方便接入sl:slog.New(handler)slog.SetDefault(sl)三、属性分组slog.Group(user,id,42,name,tom,)也可以用slog.Attr提前预编译userAttr:slog.String(user,tom)slog.Info(action,userAttr)四、跨协程日志slog 默认 handler 是 goroutine safe但底层 writer 需要保护。File writer 不加锁可能交叉写入。五、性能对比slog vs logrusBenchmarkSlog-8 1000000 1500 ns/op 250 B/op 3 allocs/op BenchmarkLogrus-8 500000 3500 ns/op 800 B/op 14 allocs/opslog 快 2x。六、踩坑清单不要直接 slog.Info 字符串拼接必须传属性JSON 字段顺序slog 内部 map 顺序不定Handler panic某些 handler 内部 panic需要外面套 recoverTrace 与 span 字段用With方法预加载七、实战HTTP access logfuncLogger()gin.HandlerFunc{returnfunc(c*gin.Context){start:time.Now()c.Next()slog.Info(access,method,c.Request.Method,path,c.Request.URL.Path,status,c.Writer.Status(),cost,time.Since(start),ip,c.ClientIP(),)}}八、总结与展望slog 给 Go 后端日志一个清新选择。学会它能解决日志太丑又写不出来的尴尬。未来slog 会与 OpenTelemetry 集成增强自动加上 trace_id、span_id。九、参考文献Go 官方 blog: slog 介绍slog 标准库文档go.opentelemetry.io/otel/log
Go slog 上手指南结构化日志与零配置性能log 包被诟病太久了。Go 1.21 带来官方新 slog本文用最简方式带你完成从 log 到 slog 的升级。一、为什么选 slog1.21 起官方推荐同时提供结构化与文本输出内置 logger pool、handler 路由importlog/sloglogger:slog.New(slog.NewJSONHandler(os.Stdout,nil))logger.Info(user login,user_id,1,ip,1.2.3.4)二、Handler 自定义typeFileHandlerstruct{chchan*slog.Record w io.Writer mu sync.Mutex}func(h*FileHandler)Handle(_context.Context,r slog.Record)error{bytes,_:json.Marshal(struct{Timestringjson:timeLevelstringjson:levelMsgstringjson:msgAttrs[]slog.Attrjson:attrs}{r.Time.Format(time.RFC3339),r.Level.String(),r.Message,r.Attrs})h.mu.Lock()deferh.mu.Unlock()h.w.Write(bytes)returnnil}可以方便接入sl:slog.New(handler)slog.SetDefault(sl)三、属性分组slog.Group(user,id,42,name,tom,)也可以用slog.Attr提前预编译userAttr:slog.String(user,tom)slog.Info(action,userAttr)四、跨协程日志slog 默认 handler 是 goroutine safe但底层 writer 需要保护。File writer 不加锁可能交叉写入。五、性能对比slog vs logrusBenchmarkSlog-8 1000000 1500 ns/op 250 B/op 3 allocs/op BenchmarkLogrus-8 500000 3500 ns/op 800 B/op 14 allocs/opslog 快 2x。六、踩坑清单不要直接 slog.Info 字符串拼接必须传属性JSON 字段顺序slog 内部 map 顺序不定Handler panic某些 handler 内部 panic需要外面套 recoverTrace 与 span 字段用With方法预加载七、实战HTTP access logfuncLogger()gin.HandlerFunc{returnfunc(c*gin.Context){start:time.Now()c.Next()slog.Info(access,method,c.Request.Method,path,c.Request.URL.Path,status,c.Writer.Status(),cost,time.Since(start),ip,c.ClientIP(),)}}八、总结与展望slog 给 Go 后端日志一个清新选择。学会它能解决日志太丑又写不出来的尴尬。未来slog 会与 OpenTelemetry 集成增强自动加上 trace_id、span_id。九、参考文献Go 官方 blog: slog 介绍slog 标准库文档go.opentelemetry.io/otel/log
