直接用 promhttp.Handler() 会暴露所有指标,因其默认绑定全局注册器 prometheus.DefaultRegisterer,所有经 prometheus.MustRegister() 注册的指标(包括 go_*、process_* 等 SDK 自带指标)均被一并导出;生产环境应显式创建独立注册器、仅注册业务指标,并手动选择性添加运行时指标。

为什么直接用 promhttp.Handler() 会暴露所有指标?
因为默认的 promhttp.Handler() 绑定的是全局注册器 prometheus.DefaultRegisterer,只要调用过 prometheus.MustRegister() 的指标,全都会被吐出来。这不是 bug,是设计使然——但生产环境常需隔离指标,比如只暴露业务相关指标,屏蔽 SDK 自身的 go_* 或 process_*。
实操建议:
- 显式创建独立注册器:
reg := prometheus.NewRegistry(),避免污染全局状态 - 只注册你真正要暴露的指标:
reg.MustRegister(httpDuration),不碰prometheus.MustRegister() - 若需保留 Go 运行时指标,手动加:
reg.MustRegister(prometheus.NewGoCollector()),而非依赖默认行为 - 启动 HTTP handler 时传入该注册器:
http.Handle("/metrics", promhttp.HandlerFor(reg, promhttp.HandlerOpts{}))
如何让自定义指标支持动态标签(如请求路径、用户 ID)?
静态指标(prometheus.NewGaugeVec 或 NewCounterVec)本身不存储值,它只是“模板”。真正打点时必须通过 .WithLabelValues() 或 .With() 注入标签值,否则会 panic。
常见错误现象:collected metric "http_request_duration_seconds" { label: —— 标签值为空或未对齐。
实操建议:
- 定义指标时明确标签名:
httpDuration := prometheus.NewHistogramVec(prometheus.HistogramOpts{...}, []string{"path", "method", "status"}) - 打点前确保标签值非空且类型一致;路径含斜杠时无需额外转义,但避免注入恶意字符(应由上层路由/中间件预处理)
- 高频打点场景慎用高基数标签(如
user_id),可用采样或聚合替代,否则 Prometheus 内存暴涨 - 调试时用
.WithLabelValues("/api/user", "GET", "200").Observe(0.123),比.With(map[string]string{...})更快、更安全
Exporter 启动后 metrics 端点返回空或 404?
最常见原因是 HTTP 路由未正确挂载,或 handler 初始化顺序错乱。Go 的 http.ServeMux 是默认全局复用的,但一旦你调用 http.Handle 前已启动 server,或用了自定义 http.ServeMux 却没传给 http.Server,就会失效。
实操建议:
- 确认
http.Handle("/metrics", ...)在http.ListenAndServe()之前执行 - 若使用自定义
mux := http.NewServeMux(),必须显式传入:&http.Server{Addr: ":9100", Handler: mux} - 检查是否误将 handler 挂在了子路径(如
mux.Handle("/metrics/", ...)),导致访问/metrics时 404 - 加一行健康检查:
http.HandleFunc("/healthz", func(w http.ResponseWriter, _ *http.Request) { w.WriteHeader(200) }),快速验证服务是否存活
如何安全暴露进程指标而不引入 gopsutil 依赖?
gopsutil 功能强但体积大、跨平台行为不一(尤其 Windows 下权限问题多),而多数 Exporter 只需 CPU、内存、FD 数等基础项。Go 标准库 runtime 和 debug 已覆盖核心需求。
实操建议:
- CPU/内存用
runtime.ReadMemStats()+runtime.NumGoroutine(),每 10s 更新一次并写入Gauge - 文件描述符数在 Linux/macOS 可读
/proc/self/fd目录条目数(注意权限),Windows 则跳过或返回 -1 - 避免在
Collect()方法里做阻塞操作(如 exec 命令),否则 metrics 抓取超时;改用后台 goroutine 定期采集+缓存 - 若真需磁盘/网络指标,优先用 host PID namespace 下的
/proc/diskstats或/proc/net/dev,比调外部命令更稳定
指标命名和标签设计比实现逻辑更难收敛。上线前拿 curl -s localhost:9100/metrics | grep your_prefix 看一眼输出,比写十遍单元测试更能暴露聚合维度错误。











