SuperAPI AI 工具集

golang-samber-slog

编程与开发

查看项目

更新于 10-16 08:44

技能介绍

用途:为 Go 项目设计结构化日志管道,基于 samber/slog-**** 系列(20+ 实现标准 slog.Handler 接口的可组合包),把日志按“采样→格式化→路由→输出”顺序流转。

主要能力:slog-multi 提供组合模式:Fanout(广播全部)、Router(命中全部匹配)、Router 加 FirstMatch(仅首个匹配)、Failover、Pool(负载均衡)、Pipe(中间件链);内置谓词如 LevelIs、MessageContains、AttrValueIs 等。slog-sampling 控制吞吐:Uniform、Threshold、Absolute、Custom,并可用 MatchByLevel、MatchByMessage 等去重分组。slog-formatter 做属性变换:PIIFormatter、ErrorFormatter、IPAddressFormatter、TimeFormatter、HTTPRequestFormatter 等,以及 FormatByType[T]、FormatByKey、FlattenFormatterMiddleware。HTTP 中间件覆盖 gin、echo、fiber、chi、net/http,统一用法 router.Use(slogXXX.New(logger)),共享 Config(各级别、请求/响应体、请求 ID、过滤等)。后端输出含云(datadog、sentry、loki、graylog)、消息(kafka、fluentd、logstash、nats)、通知(slack、telegram、webhook)、存储(parquet)与 zap/zerolog/logrus 桥接。

使用方式:核心代码为 slog.New(slogmulti.Router().Add(sentryHandler, slogmulti.LevelIs(slog.LevelError)).Add(slog.NewJSONHandler(os.Stdout, nil)).Handler());采样示例见资料中的 ThresholdSamplingOption 与 slogmulti.Pipe。

限制与注意:采样必须放在管道最外层,否则浪费 CPU;Fanout 延迟为各 handler 之和,宜用 Pool;批处理输出(datadog、loki、kafka、parquet)须优雅关闭刷新,如 defer handler.Stop(ctx)、defer lokiClient.Stop()、defer writer.Close();Router 需加默认 handler 以免丢弃未匹配记录;AttrFromContext 需配合 HTTP 中间件;无中间件时勿用 Pipe。上生产前用 go test -bench 压测。具体版本、配置与符号细节请查阅各库文档,本技能未提供价格或平台信息。