Golang 结构化日志包 log/slog 详解（六）：slog.Record

上一篇文章讲解了 log/slog 包中的 LogValuer 和日志记录函数的正确包装方法，本文详细讲解一下 slog.Record 结构体的使用方法和需要注意的点。

slog.Record

Record 类型用来保存日志事件的信息，定义如下：

type Record struct {Time time.TimeMessage stringLevel LevelPC uintptrfront [nAttrsInline]AttrnFront intback []Attr
}

有如下几个方法：

func (r Record) Clone() Record，返回一个不共享状态的副本，Record 和其克隆副本都可以被修改并且不会相互干扰。
func (r Record) NumAttrs() int，返回日志记录中属性的个数。
func (r Record) Attrs(f func(Attr) bool)，使用函数 f 作用于日志记录中的每个属性，如果 f 返回 false，则停止迭代。
func (r *Record) AddAttrs(attrs ...Attr)，将给定的属性追加到日志记录的属性列表中。
func (r *Record) Add(args ...any)，将参数转换为 Logger.Log 中描述的 Attrs，然后将Attrs 追加到日志记录中的 Attrs 列表。
func (r Record) source() *Source，返回日志事件的 Source。

使用示例

可以使用 slog.NewRecord 函数创建一个 Record 对象，使用 Record 记录日志的示例代码如下：

package mainimport ("context""log/slog""os""time"
)func main() {logger := slog.New(slog.NewTextHandler(os.Stdout, nil))r := slog.NewRecord(time.Now(), slog.LevelInfo, "test", 1)r.Add("title", "路多辛的博客")_ = logger.Handler().Handle(context.Background(), r)
}

运行程序，输出结果如下：

time=2023-10-17T21:01:12.041+08:00 level=INFO msg=test title=路多辛的博客

在日常的使用场景中，会有这么一种情况，首先创建一个基础的 Record 对象，然后会使用不同的 Handler 来基于这个对象分别做不同的处理。这种场景下，需要先调用 Clone 方法克隆一份 Record 对象的副本，然后传递给其他 Handler 做处理。这样对副本的修改不会影响到原本的对象，对原本对象的修改也不会影响到副本，示例代码如下：

package mainimport ("context""log/slog""os""time"
)func main() {logger := slog.New(slog.NewTextHandler(os.Stdout, nil))r := slog.NewRecord(time.Now(), slog.LevelInfo, "test", 1)r.Add("title", "路多辛的博客")_ = logger.Handler().Handle(context.Background(), r)r2 := r.Clone()r2.Add("subTitle", "路多辛的所思所想")l := slog.NewJSONHandler(os.Stdout, nil)_ = l.Handle(context.Background(), r2)
}

运行程序输出结果如下：

time=2023-10-17T21:24:23.588+08:00 level=INFO msg=test title=路多辛的博客
{"time":"2023-10-17T21:24:23.588517+08:00","level":"INFO","msg":"test","title":"路多辛的博客","subTitle":"路多辛的所思所想"}