Go服务需通过/metrics端点暴露Prometheus指标，使用prometheus/client_golang库定义并注册指标，用promhttp.Handler()挂载；避免注册冲突、并发不安全操作及高基数标签导致的内存泄漏。
Go 服务要被 Prometheus 抓取，必须提供一个符合其格式的 HTTP 端点（通常是 /metrics），返回纯文本格式的指标数据。直接手写指标输出极易出错，应使用官方推荐的 prometheus/client_golang 库。
关键步骤：
400-9888-660 prometheus/client_golang/promhttp 和 prometheus
prometheus.NewCounterVec、prometheus.NewGauge）并注册到默认注册器（prometheus.MustRegister）promhttp.Handler() 启动一个独立的 HTTP handler，挂载到 /metrics
注意：不要把 /metrics 和主业务路由混用同一 mux（比如 http.DefaultServeMux），否则可能因中间件或日志干扰导致响应头/状态码异常，触发 Prometheus 抓取失败（错误信息类似 expected 'text/plain' response, got 'text/html'）。
package mainimport ( "net/http" "github.com/prometheus/client_golang/prometheus" "github.com/prometheus/client_golang/prometheus/promhttp" )
var ( httpRequestsTotal = promet
heus.NewCounterVec( prometheus.CounterOpts{ Name: "http_requests_total", Help: "Total number of HTTP requests", }, []string{"method", "endpoint", "status_code"}, ) )
func init() { prometheus.MustRegister(httpRequestsTotal) }
func main() { http.Handle("/metrics", promhttp.Handler())
http.HandleFunc("/health", func(w http.ResponseWriter, r *http.Request) { httpRequestsTotal.WithLabelValues("GET", "/health", "200").Inc() w.WriteHeader(200) }) http.ListenAndServe(":8080", nil)}
为什么 /metrics 返回 500 或空内容
常见原因不是代码逻辑错误，而是指标注册冲突或并发不安全操作。例如：
heus.NewCounterVec(
prometheus.CounterOpts{
Name: "http_requests_total",
Help: "Total number of HTTP requests",
},
[]string{"method", "endpoint", "status_code"},
)
)prometheus.MustRegister 注册同名指标（会 panic 并返回 500）Counter/Gauge 值（虽多数情况不会立即崩溃，但会导致指标值错乱或采集失败）Collect 方法但未调用 ch （导致 /metrics 返回空）
调试建议：启动服务后，手动 curl http://localhost:8080/metrics，观察是否返回以 # HELP 开头的文本；若返回空或 HTML，优先检查 handler 是否被其他路由覆盖、是否启用了 gzip 中间件（Prometheus 不支持压缩响应）。
Prometheus 本身不识别“服务实例”，靠抓取时注入的标签（如 job、instance）区分。Go 服务无法控制 instance 标签——它由 Prometheus 配置中的 targets 决定（通常是 host:port）。但你可以主动添加业务维度标签：
CounterVec 或 GaugeVec 时，把 service_name、version、env 加入 label namesWithLabelValues 中传入动态高基数字段（如用户 ID、请求路径），否则会爆炸性生成时间序列，拖垮 Prometheusregion="us-east-1"）更适合通过 Prometheus 的 static_configs + labels 注入，而非硬编码进 Go 指标示例：添加 service 和 version 标签
var httpRequestDuration = prometheus.NewHistogramVec(
prometheus.HistogramOpts{
Name: "http_request_duration_seconds",
Help: "HTTP request duration in seconds",
Buckets: prometheus.DefBuckets,
},
[]string{"service", "version", "method", "endpoint", "status_code"},
)
func init() {
prometheus.MustRegister(httpRequestDuration)
}
// 使用时：
httpRequestDuration.WithLabelValues("user-service", "v1.2.0", "POST", "/login", "200").Observe(0.045)
高频打点（如每请求都 Inc() 或 Observe()）本身开销极小，但以下情况会导致严重问题：
r.URL.Path 直接作为 label），导致无限多 label 组合 → 时间序列数暴涨 → Prometheus OOMCounter 再注册），触发注册器 panic 或 goroutine 泄漏Histogram 的 Buckets，用默认 16 个 bucket 虽安全，但若业务延迟分布极偏（如 99% 请求 真实踩坑点：某服务将 X-Request-ID 作为 label 打点，上线后 2 小时内生成超 200 万时间序列，Prometheus 抓取超时并开始丢弃样本。解决方式是删掉该 label，改用日志关联追踪 ID。
