答案是通过引入prometheus client_golang库，在Go项目中定义、注册并更新自定义指标，再通过http暴露/metrics端点供Prometheus抓取。具体步骤包括：1. 安装client_golang库；2. 使用Counter、Gauge等类型定义业务指标；3. 在init函数中注册指标；4. 于业务逻辑中更新指标值；5. 通过promhttp.Handler()暴露metrics接口；6. 配置Prometheus目标抓取该端点，最终实现监控数据采集与查询。

在Go项目中接入Prometheus自定义指标采集，核心是使用官方提供的 client_golang 库暴露业务相关的监控数据。整个过程包括定义指标、注册、更新数值，并通过HTTP服务暴露给Prometheus抓取。

1. 引入Prometheus客户端库

安装Go的Prometheus客户端：

go get github.com/prometheus/client_golang/prometheus
go get github.com/prometheus/client_golang/prometheus/promhttp

这两个包分别用于定义指标和提供HTTP处理器来暴露指标。

2. 定义自定义指标

Prometheus支持多种指标类型：Counter（计数器）、Gauge（当前值）、Histogram（直方图）、Summary（摘要）。根据业务场景选择合适类型。

立即学习“go语言免费学习笔记（深入）”；

例如，定义一个请求计数器和一个处理耗时的直方图：

var (
  httpRequestsTotal = prometheus.NewCounterVec(
    prometheus.CounterOpts{
      Name: “http_requests_total”,
      Help: “Total number of HTTP requests made.”,
    },
    []String{“method”, “endpoint”, “status”},
  )

  requestDuration = prometheus.NewHistogramVec(
    prometheus.HistogramOpts{
      Name: “http_request_duration_seconds”,
      Help: “HTTP request latency in seconds.”,
      Buckets: prometheus.DefBuckets,
    },
    []string{“method”, “endpoint”},
  )
)

3. 注册指标

定义后的指标需要注册到默认的Registry中，才能被暴露出来：

func init() {
  prometheus.MustRegister(httpRequestsTotal)
  prometheus.MustRegister(requestDuration)
}

也可以创建自定义Registry，但通常使用默认即可。

标小兔AI写标书

一款专业的标书ai代写平台，提供专业AI标书代写服务，安全、稳定、速度快，可满足各类招投标需求，标小兔，写标书，快如兔。

40

查看详情

4. 在业务代码中更新指标

在处理HTTP请求的地方记录数据：

func handler(w http.ResponseWriter, r http.Request) {
  start := time.Now()

  w.Write([]byte(“OK”))
}

5. 暴露/metrics端点

启动一个HTTP服务，将指标通过 /metrics 接口暴露：

func main() {
  http.Handle(“/metrics”, promhttp.Handler())
  http.HandleFunc(“/”, handler)

  log.Println(“Server starting on :8080”)
  log.Fatal(http.ListenAndServe(“:8080”, nil))
}

启动后访问 http://localhost:8080/metrics 可看到类似如下内容：

# HELP http_requests_total Total number of HTTP requests made.
# TYPE http_requests_total counter
http_requests_total{endpoint=”/”,method=”GET”,status=”200″} 5

6. 配置Prometheus抓取

在Prometheus配置文件中添加目标：

scrape_configs:
  – job_name: ‘go-app‘
    static_configs:
      – targets: [‘localhost:8080’]

重启Prometheus后，在Web ui中就能查询自定义指标。

基本上就这些。关键在于合理设计指标名称和标签，避免 cardinality 过高，同时确保性能开销可控。