根本原因是指标注册到了默认 registry，但 handler 用的是自定义 registry，两者没对上；必须用 reg.MustRegister() 而非 prometheus.MustRegister()，且初始化顺序为：新建 registry → 定义并注册指标 → 挂载 handler。
为什么/metrics返回空或只有go_*指标
根本原因是指标注册到了默认 registry，但 handler 用的是自定义 registry，两者没对上。现象是 curl /metrics 返回 200，内容里只有 go_goroutines、process_cpu_seconds_total，你的 my_app_requests_total 完全不出现。
- 别用
prometheus.MustRegister()—— 它往prometheus.DefaultRegisterer写，而你大概率在 handler 里用了promhttp.HandlerFor(reg, ...)，reg是你自己 new 的 - 所有指标创建后必须立刻调用
reg.MustRegister()，不是prometheus.MustRegister() - 初始化顺序不能乱：先
reg := prometheus.NewRegistry()，再定义并注册指标，最后挂http.Handle("/metrics", promhttp.HandlerFor(reg, ...)) - 如果要用 Go 运行时指标，显式加
reg.MustRegister(prometheus.NewGoCollector())，别指望默认行为带进来
如何让指标支持动态标签（如 path、user_id）
Vec 类型（NewCounterVec、NewGaugeVec）本身只是模板，打点时必须填满所有 label 值，否则 runtime panic。
- 定义时明确 label 名：
httpDuration := prometheus.NewHistogramVec(..., []string{"path", "method", "status"}) - 打点必须用
.WithLabelValues("/api/user", "GET", "200")，数量、顺序、类型都要严格匹配；传少一个或类型不对（比如nil）直接 panic - 路径含斜杠没问题，但别把原始 URL 路径（如
/user/12345）直接当 label 值——基数爆炸，改用归一化形式（如/user/{id}） - 高频打点时，缓存
.WithLabelValues()结果，比如get200 := counter.WithLabelValues("GET", "200")，后续直接get200.Inc()
怎么选 Counter / Gauge / Histogram，常见误用在哪
选错类型不会报错，但查出来全是废数据：分位数算不了、趋势看不准、聚合结果反直觉。
Golang Samber Hot
下载
在 Golang 中使用 samber/hot 进行内存缓存，支持 LRU、LFU、TinyLFU、W‑TinyLFU、S3FIFO、ARC、TwoQueue、SIEVE、FIFO 等淘汰算法，提供 TTL、缓存加载器及分片功能。
-
Counter只用于单调递增累计值，比如总请求数、总错误数；别拿它记“当前在线用户数”，那是Gauge -
Gauge是瞬时快照，比如内存用量、goroutine 数；别拿它记耗时——丢掉分布信息，histogram_quantile()就失效 -
Histogram专为分布观测设计，自带_sum、_count、_bucket；别自己再额外记一个sum指标，重复且语义冲突 - 标签值来自请求参数时，务必校验非空、长度合理、字符合法（小写字母/数字/下划线），避免
invalid metric name or label错误
解析函数怎么嵌入指标更新逻辑
所谓“可配置”，本质是把采集逻辑从硬编码抽成函数签名一致的解析器，由配置驱动调用。关键不是函数多灵活，而是指标更新必须复用已注册的 Vec 实例。
立即学习“go语言免费学习笔记（深入）”；
- 定义统一解析接口：
type Parser func() (map[string]float64, error)，返回 label → value 映射 - 更新时别 new 新指标，用已注册的
GaugeVec或CounterVec，遍历 map 调用.WithLabelValues(k1, k2).Set(v) - label 值必须来自预设白名单或哈希归一化，禁止直接拼接用户输入；比如
user_id改用user_hash标签 - 配置变更（如新增解析项）要能热重载：用
atomic.Value存解析函数指针，更新时Store()替换，旧指标用reg.Unregister()清理（注意只能解注册原对象）
/metrics 看一眼有没有你的指标名，再 grep 一下 label 值是否重复、空、非法，比等告警更早发现问题。 
