Go语言日志采样实战指南（使用slog包实现高性能日志记录）

什么是日志采样？

日志采样是指在高频率日志事件中，只记录一部分日志，而不是全部。例如：每100次请求只记录1次错误日志。这样既能保留关键信息，又能显著降低 I/O 开销和存储成本。

为什么使用 slog 包？

log/slog 是 Go 官方推出的结构化日志库，相比传统 log 包，它支持：

• 结构化日志（Key-Value 格式）
• 多级别日志（Debug、Info、Warn、Error 等）
• 自定义 Handler 和格式（JSON、Text）
• 内置日志采样支持（通过 slog.NewSampler）

快速入门：slog 基础用法

首先，确保你使用的是 Go 1.21 或更高版本。创建一个简单项目：

package mainimport (	"log/slog"	"os")func main() {	logger := slog.New(slog.NewTextHandler(os.Stdout, nil))	logger.Info("Hello, slog!", "user", "alice", "id", 123)}

运行后输出：

time=2024-06-01T10:00:00.000Z level=INFO msg="Hello, slog!" user=alice id=123

实现日志采样

要启用采样，我们需要使用 slog.NewSampler 创建一个采样处理器（Sampler Handler）。其核心参数包括：

• next：底层实际的日志处理器（如 TextHandler 或 JSONHandler）
• burst：初始允许连续记录的日志数量
• every：之后每隔多少条日志才记录一次

下面是一个每100条 Info 级别日志只记录1条的示例：

package mainimport (	"log/slog"	"os")func main() {	// 创建基础处理器	baseHandler := slog.NewTextHandler(os.Stdout, nil)	// 创建采样处理器：burst=1, every=100	// 表示先放行1条，之后每100条放行1条	sampledHandler := slog.NewSampler(baseHandler, 1, 100)	logger := slog.New(sampledHandler)	// 模拟高频日志	for i := 0; i < 1000; i++ {		logger.Info("High frequency log", "counter", i)	}}

运行这段代码，你会发现控制台只输出了大约 10 条日志（第0条 + 每100条一次），而不是1000条！

采样策略详解

slog 的采样器采用“令牌桶”算法：

• burst：桶的初始容量（可立即使用的令牌数）
• every：每产生一条日志消耗1个令牌；当令牌耗尽后，每 every 条日志补充1个令牌

常见配置建议：

⚠️ 注意：错误日志（Error/Fatal）通常不应采样，以免丢失关键故障信息！建议对不同日志级别使用不同 Handler。

高级技巧：按级别采样

我们可以为不同日志级别设置不同的采样策略。例如：Info 日志采样，Error 日志全量记录。

type LevelSampler struct {	infoSampler   slog.Handler	errorHandler  slog.Handler}func (ls LevelSampler) Enabled(ctx context.Context, level slog.Level) bool {	if level == slog.LevelError {		return ls.errorHandler.Enabled(ctx, level)	}	return ls.infoSampler.Enabled(ctx, level)}func (ls LevelSampler) Handle(ctx context.Context, r slog.Record) error {	if r.Level == slog.LevelError {		return ls.errorHandler.Handle(ctx, r)	}	return ls.infoSampler.Handle(ctx, r)}func (ls LevelSampler) WithAttrs(attrs []slog.Attr) slog.Handler {	return LevelSampler{		infoSampler:  ls.infoSampler.WithAttrs(attrs),		errorHandler: ls.errorHandler.WithAttrs(attrs),	}}func (ls LevelSampler) WithGroup(name string) slog.Handler {	return LevelSampler{		infoSampler:  ls.infoSampler.WithGroup(name),		errorHandler: ls.errorHandler.WithGroup(name),	}}// 使用方式func main() {	base := slog.NewTextHandler(os.Stdout, nil)	infoSampled := slog.NewSampler(base, 1, 100)	errorFull := base // 不采样	logger := slog.New(LevelSampler{		infoSampler:  infoSampled,		errorHandler: errorFull,	})	logger.Info("This may be sampled")	logger.Error("This is always recorded!")}

总结

通过本文，你已经掌握了如何在 Go语言 中使用 slog 包实现高效的日志采样。合理使用采样策略，可以在保证可观测性的同时，大幅降低系统开销。

记住关键词：Go语言日志采样、slog包使用、高性能日志记录、Go slog采样教程。这些是你优化日志系统的关键！

赶快在你的项目中试试吧！