Prometheus .NET客户端库Metric实例是否线程安全？正确用法是什么？

你的猜想完全正确！prometheus-net 中的各类 Metric 实例（比如 Histogram、Counter、Gauge 等）都是线程安全的，设计思路和 Java 客户端完全一致，推荐你用 static readonly 的方式创建并复用单个实例，绝对不要每次请求都创建本地实例。

为什么要这么做？ #

• 性能与数据准确性：Metric 是用来长期累计、聚合监控数据的，每次创建本地实例会导致数据分散，Prometheus 无法正确汇总指标，同时频繁创建实例也会带来不必要的性能开销。
• 官方设计保障：prometheus-net 的 Metric 内部使用了线程安全的数据结构（比如原子操作、线程安全的计数器等），多线程并发调用 Observe()、Increment() 这类方法时，完全不需要额外加锁，直接调用即可。
• 社区最佳实践：虽然官方示例没有明确标注线程安全，但所有隐含的用法都是基于复用静态实例的——比如在 ASP.NET Core 控制器、后台服务中，大家都会用静态实例来统一收集指标。

正确用法示例（ASP.NET Core 控制器） #

[ApiController]
[Route("api/[controller]")]
public class DemoController : ControllerBase
{
    // 静态只读实例：全局复用，线程安全
    private static readonly Histogram ApiRequestDuration = Metrics.CreateHistogram(
        "demo_api_request_duration_seconds",
        "Duration of requests to the Demo API",
        new HistogramConfiguration
        {
            Buckets = Histogram.ExponentialBuckets(0.01, 2, 10)
        });

    [HttpGet]
    public IActionResult GetData()
    {
        // 直接在多线程场景下调用，无需额外同步
        using (ApiRequestDuration.NewTimer())
        {
            // 处理业务逻辑
            return Ok("Hello World");
        }
    }
}

千万别做的事 #

不要在控制器方法里创建本地实例，比如这种错误写法：

[HttpGet]
public IActionResult BadExample()
{
    // 错误：每次请求都创建新实例，数据无法聚合，浪费资源
    var badMetric = Metrics.CreateHistogram("bad_example_duration", "Don't do this");
    using (badMetric.NewTimer())
    {
        return Ok();
    }
}

这种写法会导致 Prometheus 抓取到大量重复名称的指标，每个实例对应独立的统计数据，完全失去了监控的意义。

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