Prometheus注销后重新注册计数器指标无法获取问题

你的问题出在反复注册/注销同一个Prometheus Counter实例，Prometheus Registry不支持将已注销的实例重新注册，导致再次启用时指标无法被正确识别。

推荐方案：用开关控制计数逻辑（最佳实践） #

不要动态注册/注销指标，而是初始化时就完成注册，在需要计数的地方通过开关判断是否累加。这种方式更符合Prometheus的设计理念，也更稳定。

代码示例 #

// 全局初始化计数器，一次性完成注册
var successCounter = prometheus.NewCounter(prometheus.CounterOpts{
    Name: "success_count",
    Help: "The number of API success calls.",
})

func init() {
    defaultRegistry := prometheus.NewRegistry()
    prometheus.DefaultRegisterer = defaultRegistry
    prometheus.DefaultGatherer = defaultRegistry
    // 初始化时就注册指标，后续不再变更注册状态
    prometheus.MustRegister(successCounter)
}

// 在API成功的逻辑处添加计数判断
func onAPISuccess() {
    // 只有指标启用时才累加计数
    if !disableMetricTrue {
        successCounter.Inc()
    }
}

备选方案：动态注册新实例（不推荐） #

如果必须通过动态注册/注销实现，每次启用时需要创建全新的Counter实例，因为已注销的实例无法再次被Registry接受。

代码示例 #

var successCounter prometheus.Counter
var defaultRegistry = prometheus.NewRegistry()

func init() {
    prometheus.DefaultRegisterer = defaultRegistry
    prometheus.DefaultGatherer = defaultRegistry
}

// 当指标启用/禁用条件变更时调用
func toggleMetric(disable bool) {
    if disable {
        if successCounter != nil {
            prometheus.Unregister(successCounter)
            successCounter = nil // 置空避免重复操作
        }
    } else {
        if successCounter == nil {
            // 创建新的Counter实例并注册
            successCounter = prometheus.NewCounter(prometheus.CounterOpts{
                Name: "success_count",
                Help: "The number of API success calls.",
            })
            prometheus.MustRegister(successCounter)
        }
    }
}

原因说明 #

• Prometheus Registry内部会跟踪每个注册的指标实例状态，已注销的实例无法重新注册，即使指标名称相同也不行。
• 动态注册/注销会增加系统复杂度，且容易引发注册冲突，开关控制计数的方式更简洁可靠。

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