Go 结构化日志管道
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/samber-cc-skills-golang-golang-samber-slog。
技能介绍
问题:一条日志要经过多层 Handler,顺序错了就白算 CPU
Go 1.21 起标准库提供 slog,但生产里很少「一个 Handler 打到底」。你要先按流量采样降噪,再在出站前脱敏/规整字段,最后把错误送 Sentry、info 送 Loki——若先格式化再采样,会在注定被丢弃的记录上白跑格式化逻辑;若 Fanout 挂多个同步 Sink,单次 Log 的延迟是各 Handler 之和。
技能在说什么:管道顺序与可组合能力
本技能围绕 samber/slog-\* 生态:三条主干库都实现标准 slog.Handler 接口。
- slog-sampling:
Uniform/Threshold/Absolute/Custom等策略;采样应作为最外层 Handler。 - slog-formatter:经
Pipe中间件做 PII、Error、HTTP 请求/响应等属性变换,下游 Sink 收到的是干净字段。 - slog-multi:
Fanout、Router(含FirstMatch)、Failover、Pool、Pipe等组合模式;内置LevelIs、MessageContains、AttrValueIs等谓词。
另有 HTTP 中间件(slog-gin、slog-echo、slog-fiber、slog-chi、slog-http)与 后端 Sink(Datadog、Sentry、Loki、Kafka、Slack 等)。技能文档强调 批量 Sink 优雅关闭(如 Datadog Stop、Loki Stop、Kafka Close),否则缓冲日志会丢。
边界与注意点
技能自述非穷尽,细节需查各库文档与示例;Go 包事实可查关联的 godig / gopls 技能。部署前应用 go test -bench 量测整条管道的分配与延迟;Fanout 高延迟场景优先考虑 Pool(),Pipe 中间件链宜保持简短(约 2~4 个)。
使用场景
- 微服务上线前要把 Gin 请求日志接入 Loki,同时 5xx 单独路由到 Sentry
- 生产日志量过大,需要按 interval 阈值采样并保留每个错误指纹的前 N 条
- 日志出站前要对手机号、IP 做统一脱敏,再 Fanout 到 Datadog 与 Kafka
- 进程退出时要正确 flush Datadog/Loki/Kafka 批量 Handler,避免丢缓冲日志
适合人员
- 负责 Go 服务可观测性、要把标准 slog 接到多云 Sink 的后端工程师
- 维护高 QPS API、需在不影响排障的前提下做采样与降噪的 SRE
- 合规要求日志脱敏,需在单条管道里统一 PII 规则的安全/平台工程师
- 从 zap/logrus 迁到 slog,需要 Router/Pool 组合与关闭模式的维护者