observability instrumentation

SKILL.md

You can't improve what you can't measure. You can't debug what you can't observe.

❌ Log spamming: Logging everything (noise overwhelms signal) ❌ Unstructured logs: String concatenation instead of structured fields ❌ Synchronous logging: Blocking on log writes (use async handlers) ❌ Missing context: Logs without request ID or user context ❌ Metrics explosion: Too many unique label combinations (cardinality issues)

Status: ✅ Production-ready | 23-46x speedup | 90-95% transferable | Validated in meta-cc

全面的可观察性方法通过使用 Go slog、Prometheus 式指标和分布式跟踪模式的结构化日志记录实现三大支柱（日志、指标、跟踪）。当从头开始添加可观察性、日志非结构化或不充分、没有指标收集、调试生产问题困难或需要性能监控时使用。提供结构化日志记录模式（上下文日志记录、日志级别 DEBUG/INFO/WARN/ERROR、请求 ID 传播）、指标检测（计数器/仪表/直方图模式、Prometheus 展示）、跟踪设置（跨度创建、上下文传播、采样策略）和 Go slog 最佳实践（JSON 格式、属性管理、处理程序配置）。在 meta-cc 中进行了验证，与临时日志记录相比，速度提高了 23-46 倍，跨语言的可转移性为 90-95%（slog 特定于 Go，但模式是通用的）。 来源：zpankz/mcp-skillset。

查看原文