如何通过Prometheus Python客户端的CollectorRegistry获取Counter对象？

不要依赖私有属性_names_to_collectors来获取Counter对象，因为私有API没有兼容性承诺，后续版本可能会被修改或移除。推荐两种基于公共API的实现方式：

方法一：重复调用Counter构造函数（推荐） #

prometheus_client的Metric构造函数（如Counter）在传入相同的注册器、名称、文档字符串和标签时，会返回已注册的实例，而非创建新的metric。这是官方隐含支持的用法，代码简洁且安全：

from prometheus_client import CollectorRegistry, Counter, write_to_textfile

registry = CollectorRegistry()

name = "NAME"
counter = Counter(name, "DOCUMENTATION", registry=registry)
counter.inc(2)

# 直接调用Counter构造函数获取已有的实例
counter = Counter(name, "DOCUMENTATION", registry=registry)
counter.inc(3)

write_to_textfile("counters.prom", registry)

注意：如果再次调用时传入的文档字符串、标签等参数与最初创建时不一致，会抛出ValueError，这符合Prometheus的规范——同一名称的metric必须保持元数据一致。

方法二：遍历注册器中的Collector并筛选 #

如果不想重复调用构造函数，可以遍历注册器中的所有Collector，通过类型和名称筛选目标Counter（注：此方法仍需访问私有列表_collectors，仅作为备选方案）：

# 遍历collectors筛选目标Counter
target_counter = None
for collector in registry._collectors:
    if isinstance(collector, Counter) and collector._name == name:
        target_counter = collector
        break

if target_counter:
    target_counter.inc(3)

显然方法一更为优雅且符合公共API的使用规范，优先推荐。

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