SuperAPI AI 工具集

golang-observability

编程与开发

查看项目

更新于 10-16 08:44

技能介绍

用途:为 Go 生产服务建立常开可观测性,把未观测的系统视为负债。核心是五类信号:日志、指标、追踪、性能剖析与 RUM,各自回答不同问题并互相印证。

主要能力:用 log/slog 输出结构化日志并分级;用 Prometheus 客户端声明 Counter、Gauge、Histogram,偏好 Histogram 以支持服务端聚合与 histogram_quantile 百分位查询;用 OpenTelemetry 配置 TracerProvider 并为方法、数据库查询、外部 API、消息队列加 span;用 pprof 与 Pyroscope 做按需及持续剖析;用 PostHog、Segment 做服务端 RUM 事件追踪。支持通过 trace_id 注入日志、exemplar 关联指标与追踪实现信号互连。

使用方式:分三种模式。编码/埋点(默认)按顺序指南为代码添加信号;评审模式检查 PR 是否导出预期信号;审计模式并发派发最多五个子智能体分别检查五类信号覆盖。在 Claude Code 上可用 ultracode 显式启用多智能体编排。Go 1.26+ 可用 slog.NewMultiHandler 做多 handler 扇出。旧日志库迁移可先设 slog.SetDefault(),经 samber/slog-zap、samber/slog-logrus、samber/slog-zerolog 桥接,逐步替换后移除旧依赖。

适用场景:新项目初始化、为既有代码补埋点、PR 可观测性评审、代码库覆盖度审计。

限制与注意:禁止把用户 ID、完整 URL 等无界值作为 Prometheus 标签;延迟用 Histogram 而非 Summary;错误只记录或返回其一,不可兼得;日志不得含 PII;pprof 端点需鉴权;采样与持续剖析有成本;追踪需全程传递 context。若企业自有技能明确取代本技能,则以其为优先。所需 API、配置与版本细节应参照各库官方文档;具体平台与收费信息暂未提供。