Golang中如何为Prometheus Gauge传递动态ConstLabels值

情况1：Job名称固定（仅需初始化时获取一次） #

如果你的dat[0].Name是固定不变的（比如只监控某个特定Job），不要全局直接定义Gauge，而是在程序启动阶段先调用getJobData()拿到名称，再初始化带有ConstLabels的Gauge：

package main

import (
	"github.com/prometheus/client_golang/prometheus"
	"github.com/prometheus/client_golang/prometheus/promhttp"
	"net/http"
	"time"
)

type Job struct {
	Name       string
	QueueCount int
}

// 先声明Gauge变量，不直接初始化
var jobsInQueues prometheus.Gauge

func getJobData() ([]Job, error) {
	// 这里实现调用GitLab API获取Job数据的逻辑
	// 示例返回：return []Job{{Name: "build-job", QueueCount: 5}}, nil
}

func main() {
	// 第一步：先获取Job名称
	jobs, err := getJobData()
	if err != nil {
		// 根据实际场景处理错误，比如日志打印、退出程序
		panic("failed to fetch job data: " + err.Error())
	}
	if len(jobs) == 0 {
		panic("no job data retrieved from GitLab API")
	}
	targetJobName := jobs[0].Name

	// 第二步：用获取到的名称初始化带有ConstLabels的Gauge
	jobsInQueues = prometheus.NewGauge(prometheus.GaugeOpts{
		Name:        "gitlab_jobs_in_queue",
		Help:        "Number of pending jobs in GitLab queue",
		ConstLabels: prometheus.Labels{"target_job": targetJobName},
	})
	// 注册指标
	prometheus.MustRegister(jobsInQueues)

	// 定期更新指标值
	go func() {
		for {
			jobs, err := getJobData()
			if err == nil && len(jobs) > 0 {
				jobsInQueues.Set(float64(jobs[0].QueueCount))
			}
			time.Sleep(15 * time.Second)
		}
	}()

	// 启动metrics服务
	http.Handle("/metrics", promhttp.Handler())
	http.ListenAndServe(":8080", nil)
}

情况2：Job名称动态变化/监控多个Job #

如果Job名称可能变更，或者需要监控多个Job的队列数，不要用ConstLabels——因为ConstLabels是指标的固定属性，一旦创建就无法修改。这种场景应该使用可变标签（Labels），通过GaugeVec来实现：

package main

import (
	"github.com/prometheus/client_golang/prometheus"
	"github.com/prometheus/client_golang/prometheus/promhttp"
	"net/http"
	"time"
)

type Job struct {
	Name       string
	QueueCount int
}

// 初始化GaugeVec，将job_name作为可变标签
var jobsInQueues = prometheus.NewGaugeVec(
	prometheus.GaugeOpts{
		Name: "gitlab_jobs_in_queue",
		Help: "Number of pending jobs per GitLab job",
	},
	[]string{"job_name"}, // 可变标签列表
)

func init() {
	// 提前注册指标
	prometheus.MustRegister(jobsInQueues)
}

func getJobData() ([]Job, error) {
	// GitLab API调用逻辑，返回多个Job数据
}

func updateMetrics() {
	for {
		jobs, err := getJobData()
		if err != nil {
			// 处理错误，比如打印日志
			continue
		}

		// 遍历Job数据，更新对应标签的指标值
		for _, job := range jobs {
			jobsInQueues.WithLabelValues(job.Name).Set(float64(job.QueueCount))
		}

		time.Sleep(15 * time.Second)
	}
}

func main() {
	// 启动goroutine定期更新指标
	go updateMetrics()

	// 启动metrics服务
	http.Handle("/metrics", promhttp.Handler())
	http.ListenAndServe(":8080", nil)
}

关键说明 #

• ConstLabels的设计初衷是标记不会变化的指标属性（比如exporter版本、部署环境），不适合用来存储动态变化的值。
• 如果必须使用ConstLabels，一定要确保在初始化Gauge之前就拿到固定的标签值——全局变量初始化阶段无法执行依赖外部资源的函数（比如调用GitLab API），所以必须在main函数或init函数的逻辑中先获取值再初始化指标。

内容的提问来源于stack exchange，提问作者Sergei Chechevs