最简单暴露 prometheus 指标的方法是：调用 http.handle("/metrics", promhttp.handler())，确保指标已注册到默认 registerer，路径固定为 /metrics，避免中间件拦截、重复注册或误用未注册指标。
用 promhttp.Handler() 暴露指标端点最简单
Go 应用暴露 Prometheus 指标，核心就一条：把指标注册到默认的 prometheus.DefaultRegisterer，再用 promhttp.Handler() 挂到 HTTP 路由上。别自己手写指标响应体，也别试图用 http.HandlerFunc 手动调 prometheus.WriteToTextFormat —— 容易漏掉 Content-Type、编码头、错误处理，Prometheus 服务端会直接拒收。
- 标准做法是：
http.Handle("/metrics", promhttp.Handler())，路径必须是/metrics（除非你改了 Prometheus 的metrics_path配置） - 如果用了
gorilla/mux或chi，记得用router.Handle("/metrics", promhttp.Handler()).Methods("GET")，避免被其他路由覆盖 - 不要在
/metrics上加中间件（比如 JWT 鉴权），Prometheus 抓取时没 token，会 401；真要鉴权，得在反向代理层做，而不是 Go 应用里拦
自定义指标别直接 new CounterVec，先注册再用
新手常写 myCounter := prometheus.NewCounterVec(...); myCounter.Inc() 就完事 —— 这会导致指标不生效，/metrics 里根本看不到。因为 Prometheus 要求所有指标必须显式注册到某个 Registerer，否则会被 GC 掉。
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
- 正确顺序：先
prometheus.MustRegister(myCounter)，再调myCounter.WithLabelValues("xxx").Inc() - 推荐在
init()或main()开头注册，避免多次调用MustRegister导致 panic（重复注册会报"duplicate metrics collector registration attempted"） - 如果用的是非默认 Registry（比如测试时隔离），记得把
promhttp.HandlerFor(reg, promhttp.HandlerOpts{})传进去，否则还是走默认的，查不到你的指标
HTTP 请求耗时直方图 prometheus.HistogramVec 的 buckets 设置很关键
监控接口延迟，用 HistogramVec 是主流，但它的 Buckets 参数不是摆设 —— 它决定了分桶边界，直接影响 Prometheus 查询 histogram_quantile() 的精度和存储开销。
- 别用默认
prometheus.DefBuckets（从 .005s 到 10s），Web API 通常 99% 请求在 2s 内，建议缩成[]float64{.01, .025, .05, .1, .25, .5, 1, 2, 5} - 每个 bucket 都会生成一个时间序列，10 个 bucket × 5 个 label 组合 = 50 条时间序列，label 值多或 bucket 太密会快速撑爆 Prometheus 内存
- 如果发现
rate(http_request_duration_seconds_bucket[5m])总是集中在最大 bucket（比如全在5上），说明上限设低了，得加个10或20
Goroutine 数量暴涨？小心 prometheus.GaugeFunc 闭包捕获变量
想监控 goroutine 数，有人写 prometheus.NewGaugeFunc(prometheus.GaugeOpts{...}, func() float64 { return float64(runtime.NumGoroutine()) }) —— 看似没问题，但如果你在 handler 里动态创建这种 GaugeFunc，每次请求都 new 一个，就会导致指标对象泄漏，Prometheus 抓取时不断累积时间序列，最终 OOM。
-
GaugeFunc应该全局只建一次，在init()或main()里注册，函数体里直接调runtime.NumGoroutine() - 更稳妥的做法是用
prometheus.NewGauge(prometheus.GaugeOpts{...})+ 定期gauge.Set(float64(runtime.NumGoroutine()))（比如用time.Ticker每 10 秒更新），避免函数注册器内部状态干扰 - 检查方式：访问
/metrics，搜go_goroutines，看是不是只有一行；如果出现go_goroutines{instance="xxx"} 123多次重复，基本就是重复注册了
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
