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。

查看原文