Agent Skills
返回列表
🔒

Go 结构化日志管道

IT 运维与安全 更新于 2026.08.30

将以下提示词粘贴到你的 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 组合与关闭模式的维护者