Golang Samber Slog Skill 安全审计

27| `WithRequestID` | `bool` | `false` | Include request ID |28| `WithRequestBody` | `bool` | `false` | Include request body (capped) |29| `WithResponseBody` | `bool` | `false` | Include response body (capped) |30| `WithRequestHeader` | `bool` | `false` | Include request headers |31| `WithResponseHeader` | `bool` | `false` | Include response headers |32| `WithSpanID` | `bool` | `false` | Include OpenTelemetry span ID |

3637**Global configuration variables** (set before creating middleware):3839- `RequestBodyMaxSize` / `ResponseBodyMaxSize` — default 64KB each40- `HiddenRequestHeaders` / `HiddenResponseHeaders` — headers to redact41- `TraceIDKey` / `SpanIDKey` — context key names for OpenTelemetry42

186187| Category     | Packages                                                   |188| ------------ | ---------------------------------------------------------- |189| Cloud        | `slog-datadog`, `slog-sentry`, `slog-loki`, `slog-graylog` |190| Messaging    | `slog-kafka`, `slog-fluentd`, `slog-logstash`, `slog-nats` |191| Notification | `slog-slack`, `slog-telegram`, `slog-webhook`              |192| Storage      | `slog-parquet`                                             |193| Bridges      | `slog-zap`, `slog-zerolog`, `slog-logrus`                  |194

187188handler := slogtelegram.Option{189    Level:    slog.LevelError,190    Token:    "your-bot-token",191    Username: "@your-channel",192}.NewTelegramHandler()193```

199200handler := slogwebhook.Option{201    Level:    slog.LevelError,202    Endpoint: "https://webhook.site/your-id",203    Timeout:  10 * time.Second,204}.NewWebhookHandler()205```

184185```go186import slogtelegram "github.com/samber/slog-telegram/v2"187188handler := slogtelegram.Option{189    Level:    slog.LevelError,190    Token:    "your-bot-token",191    Username: "@your-channel",192}.NewTelegramHandler()193```

196197```go198import slogwebhook "github.com/samber/slog-webhook/v2"199200handler := slogwebhook.Option{201    Level:    slog.LevelError,202    Endpoint: "https://webhook.site/your-id",203    Timeout:  10 * time.Second,204}.NewWebhookHandler()205```

200201| Mistake | Why it fails | Fix |202| --- | --- | --- |203| Sampling after formatting | Wastes CPU formatting records that get dropped | Place sampling as outermost handler |204| Fanout to many synchronous handlers | Blocks caller — latency is sum of all handlers | Use `Pool()` for concurrent dispatch |205| Missing shutdown flush on batch handlers | Buffered logs lost on shutdown | `defer handler.Stop(ctx)` (Datadog), `defer lokiClient.Stop()` (Loki), `defer writer.Close()` (Kafka) |206| Router without default/catch-all handler | Unmatched records silently dropped | Add a handler with no predicate as catch-all |

122123## Pool — Load-Balanced Dispatch124125Randomly distributes each record to one handler from the pool. Useful when you have equivalent handlers and want to spread load.126127```go128logger := slog.New(129    slogmulti.Pool()(130        lokiHandler1, // shard 1131        lokiHandler2, // shard 2132        lokiHandler3, // shard 3133    ),134)135```136137**When to use:** Multiple equivalent sinks where you want throughput distribution. Latency = single handler latency (not sum like Fanout).138

9495| Pattern | Behavior | Latency impact |96| --- | --- | --- |97| `Fanout(handlers...)` | Broadcast to all handlers sequentially | Sum of all handler latencies |98| `Router().Add(h, predicate).Handler()` | Route to ALL matching handlers | Sum of matching handlers |99| `Router().Add(...).FirstMatch().Handler()` | Route to FIRST match only | Single handler latency |100| `Failover()(handlers...)` | Try sequentially until one succeeds | Primary handler latency (happy path) |101| `Pool()(handlers...)` | Load-balance: sends each record to ONE handler | Single handler latency |102| `Pipe(middlewares...).Handler(sink)` | Middleware chain before sink | Middleware overhead + sink |103

1---2name: golang-samber-slog3description: "Structured logging extensions for Golang using samber/slog-**** packages — multi-handler pipelines (slog-multi), log sampling (slog-sampling), attribute formatting (slog-formatter), HTTP middleware (slog-fiber, slog-gin, slog-chi, slog-echo), and backend routing (slog-datadog, slog-sentry, slog-loki, slog-syslog, slog-logstash, slog-graylog...). Apply when using or adopting slog, or when the codebase already imports any github.com/samber/slog-* package."4user-invocable: true

6667This skill is not exhaustive — refer to library documentation and code examples for more information:6869- For Go package docs, symbols, versions, importers, and known vulnerabilities, → See `samber/cc-skills-golang@golang-pkg-go-dev` skill (`godig`), preferred over Context7 for Go package facts.70- To navigate this library's usage in your own code (definitions, call sites, diagnostics), → See `samber/cc-skills-golang@golang-gopls` skill (`gopls`).71- Context7 remains a fallback for docs not indexed on pkg.go.dev.72