Golang 结构化日志包 log/slog 详解(五):LogValuer 和函数包装

上一篇文章讲解了 log/slog 包中的分组、上下文和属性值类型,本文讲解下 LogValuer 和日志记录函数的正确包装方法。

slog.LogValuer

如果想改变或者自定义一个类型的日志记录行为,可以通过实现 slog.LogValuer 接口来实现,slog.LogValuer 接口的定义如下:

复制代码
type LogValuer interface {
	LogValue() Value
}

定义了一个 LogValue 方法,返回一个 Value 类型的对象。如果一个类型实现了 LogValuer 接口,那么从它的 LogValue 方法返回的 Value 将被用于日志记录,可以用来控制该类型的值在日志中的显示方式。看个简单示例:

复制代码
package main

import (
	"log/slog"
	"os"
)

type Token string

// 实现 slog.LogValuer 接口
// 避免泄露 token
func (Token) LogValue() slog.Value {
	return slog.StringValue("******")
}

func main() {
	t := Token("shhhh!")
	logger := slog.New(slog.NewTextHandler(os.Stdout, nil))
	logger.Info("生成 token", "用户", "路多辛的博客", "token", t)
}

输出内容如下:

复制代码
time=2023-10-15T15:06:58.253+08:00 level=INFO msg="生成 token" 用户=路多辛的博客 token=******

从安全角度看,密码或者token 等敏感信息是不能被记录在日志里面的,可以使用自定义的并且实现了 LogValue 的类型来避免这种情况产生。在这个例子中,当记录 token 日志时,token 会被转换为"******"后记录在日志里面。再看一个结合字段分组使用的示例:

复制代码
package main

import (
	"log/slog"
)

type Name struct {
	First, Last string
}

func (n Name) LogValue() slog.Value {
	return slog.GroupValue(
		slog.String("first", n.First),
		slog.String("last", n.Last))
}

func main() {
	n := Name{"路多辛的博客", "路多辛的所思所想"}
	slog.Info("任务结束", "agent", n)
}

输出内容如下:

复制代码
2023/10/15 15:06:09 INFO 任务结束 agent.first=路多辛的博客 agent.last=路多辛的所思所想

包装输出函数

日志记录函数使用调用堆栈上的反射来查找应用程序中日志记录调用的文件名和行号,这可能会导致包装 slog 的函数记录错误的的源信息。举个例子,如果在 mylog.go 中定义了一个日志记录函数 Infof,然后在 main.go 中调用了此函数,这种情况下,日志会将把源文件记录为 mylog.go 而不是 main.go。正确实现 Infof 函数的方式是将获取的源信息传递给 NewRecord 函数,示例代码如下:

复制代码
package main

import (
	"context"
	"fmt"
	"log/slog"
	"os"
	"path/filepath"
	"runtime"
	"time"
)

func Infof(logger *slog.Logger, format string, args ...any) {
	if !logger.Enabled(context.Background(), slog.LevelInfo) {
		return
	}
	var pcs [1]uintptr
	runtime.Callers(2, pcs[:]) // skip [Callers, Infof]
	r := slog.NewRecord(time.Now(), slog.LevelInfo, fmt.Sprintf(format, args...), pcs[0])
	_ = logger.Handler().Handle(context.Background(), r)
}

func main() {
	replace := func(groups []string, a slog.Attr) slog.Attr {
		// Remove time.
		if a.Key == slog.TimeKey && len(groups) == 0 {
			return slog.Attr{}
		}
		// Remove the directory from the source's filename.
		if a.Key == slog.SourceKey {
			source := a.Value.Any().(*slog.Source)
			source.File = filepath.Base(source.File)
		}
		return a
	}
	logger := slog.New(slog.NewTextHandler(os.Stdout, &slog.HandlerOptions{AddSource: true, ReplaceAttr: replace}))
	Infof(logger, "message, %s", "formatted")
}
相关推荐
布莱克6059 分钟前
Swift 循环与控制转移详解:从 for-in 到标签跳转
开发语言·ssh·swift·循环
bcbnb34 分钟前
Windows 上 iOS 开发接 CI,KXBuild 自托管 runner 出签名 ipa
后端·ios
敲上瘾1 小时前
Qt核心机制:信号与槽详解
开发语言·c++·qt·ui·qt6.3
十有八七1 小时前
手搓 Agent(一):先有大脑——大模型只会做一件事
前端·人工智能·后端
锋行天下1 小时前
「踩坑实录」给 LangGraph Agent 接两个 FastMCP,我被 langchain 偷偷改了工具名
前端·人工智能·后端
联犀1 小时前
ai时代复杂项目的golang项目如何更好的与ai共舞:monorepo+gozero
开发语言·人工智能·golang
Resean02232 小时前
Spring 源码分析(一)IOC 容器总览与 refresh() 全景
java·后端·spring
苍何2 小时前
一句话出成片,我搭了个AI视频工厂
后端
bysking2 小时前
GitHub Actions 快速入门+场景实践案例
前端·后端·github
codeejun3 小时前
每日一Go·MySQL-15、慢查询日志实战分析(从 0 到 1 实战排查慢 SQL)
sql·mysql·golang