go微服务接入grafana的核心是确保prometheus能正确抓取/metrics：需显式挂载promhttp.handler()到/metrics路径，避免中间件拦截head请求，注册指标须在handler初始化前完成，标签维度要克制，命名加前缀，且grafana数据源与prometheus抓取目标地址不可混淆。
Go 微服务要上 Grafana，核心不是“配面板”，而是先让指标能被 Prometheus 正确抓到——90% 的失败卡在这一步，不是 Grafana 配错了，是 /metrics 根本没暴露成功，或暴露了但格式非法、标签爆炸、路径不对。
为什么 curl http://localhost:8080/metrics 返回 404 或空？
这是最常卡住的第一步。根本原因不是代码写得不够多，而是注册和挂载没对齐。
-
promhttp.Handler()必须显式挂到/metrics路径，不能只 new 一个 Handler 却没http.Handle()；更不能用http.HandleFunc("/metrics", ...)手动写响应——promhttp.Handler()是完整实现，自己拼字符串极易漏# HELP、# TYPE或换行，触发 Prometheus 的text format parsing error - 别用
http.DefaultServeMux外挂中间件（比如日志、CORS、JWT 验证），某些中间件会拦截HEAD请求——而 Prometheus 抓取时默认发 HEAD 预检，失败就直接跳过该 target - 启动服务后必须立刻验证：
curl -v http://localhost:8080/metrics | head -n 5，看到以# HELP开头的多行文本才算通；如果返回空或 HTML，说明路由没生效，检查http.ListenAndServe是否被前面的log.Fatal吞掉、端口是否被占用
自定义指标注册后为什么 /metrics 里看不到？
注册动作本身不等于指标生效。Prometheus 只输出 MustRegister() 或显式 Register() 过的对象，且必须在 promhttp.Handler() 初始化之前完成。
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 不要在 handler 函数里动态 new 指标（比如每次请求都
prometheus.NewCounter(...)），会导致重复注册 panic；要用promauto.NewCounter(...)（需额外引入github.com/prometheus/client_golang/prometheus/promauto）或提前声明全局变量 - 标签维度要克制：像
user_id、request_id这种高基数 label，哪怕只暴露一个CounterVec，也会让 Prometheus 内存暴涨甚至 OOM；延迟直方图用prometheus.NewHistogram，别用Summary（它在客户端算分位数，精度高但不可聚合） - 命名加前缀：运行时指标如
go_goroutines是固定的，你自己的指标建议统一前缀，比如myapp_http_requests_total，避免和内置指标冲突，也方便 Grafana 查询时用myapp_*过滤
Grafana 查不到数据？先看 Prometheus Targets 页面
Grafana 显示 “No data” 时，第一反应不该调面板，而是打开 Prometheus UI 的 Status > Targets 页面——这里才是真相所在。
- 如果目标显示
DOWN，说明 Prometheus 根本连不上你的 Go 服务：检查scrape_configs里的targets地址是不是写了localhost（Docker 环境下它指向容器自身）；确认 Go 服务监听的是0.0.0.0:8080而非127.0.0.1:8080；防火墙或 Kubernetes NetworkPolicy 是否放行 - 如果状态是
UP但指标查不到，去Graph页面手动输 PromQL，比如count(http_requests_total)，看有没有结果；没有就说明指标名或 label 键写错，比如你注册的是http_requests_total{method="GET", status="200"}，查询时却写了http_requests_total{method="get"}（大小写敏感） - 延迟 P95 计算必须用
histogram_quantile(0.95, sum(rate(http_request_duration_seconds_bucket[5m])) by (le))，漏掉by (le)或括号位置错，结果就是一条平直线（值恒为 0）
真正容易被忽略的点：Grafana 数据源填的是 Prometheus 地址（http://prometheus:9090），不是 Go 服务地址；而 Prometheus 的 scrape_configs 填的才是 Go 服务地址（http://go-service:8080/metrics）。这两层地址完全独立，混在一起配就全崩。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
