Prometheus.Client 5.2.0

The ID prefix of this package has been reserved for one of the owners of this package by Prefix Reserved
dotnet add package Prometheus.Client --version 5.2.0
NuGet\Install-Package Prometheus.Client -Version 5.2.0
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Prometheus.Client" Version="5.2.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Prometheus.Client --version 5.2.0
#r "nuget: Prometheus.Client, 5.2.0"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install Prometheus.Client as a Cake Addin
#addin nuget:?package=Prometheus.Client&version=5.2.0

// Install Prometheus.Client as a Cake Tool
#tool nuget:?package=Prometheus.Client&version=5.2.0


ci nuget nuget codecov codefactor license

.NET Client library for

It was started as a fork of prometheus-net, but over time the library was evolved into a different product. Our main goals:

  • Keep possibility of rapid development.
  • Extensibility is one of the core values, together with performance and minimal allocation.
  • We are open for suggestions and new ideas, contribution is always welcomed.

Performance comparison with prometheus-net

General use case benchmarks Find more details on benchmarks description


dotnet add package Prometheus.Client



Prometheus Docs

Quick start

  1. Add IMetricFactory and ICollectorRegistry into DI container with extension library Prometheus.Client.DependencyInjection
public void ConfigureServices(IServiceCollection services)
  1. Add metrics endpoint

With Prometheus.Client.AspNetCore:

public void Configure(IApplicationBuilder app, IHostingEnvironment env, ILoggerFactory loggerFactory, IApplicationLifetime appLifetime)

Without extensions:

public class MetricsController : Controller
    private readonly ICollectorRegistry _registry;

    public MetricsController(ICollectorRegistry registry)
        _registry = registry;

    public async Task Get()
        Response.StatusCode = 200;
        await using var outputStream = Response.Body;
        await ScrapeHandler.ProcessAsync(_registry, outputStream);

For collect http requests, use Prometheus.Client.HttpRequestDurations. It does not depend of Prometheus.Client.AspNetCore, however together it's very convenient to use:

public void Configure(IApplicationBuilder app, IHostingEnvironment env, ILoggerFactory loggerFactory, IApplicationLifetime appLifetime)


Four types of metric are offered: Counter, Gauge, Summary and Histogram. See the documentation on metric types and instrumentation best practices on how to use them.


Counters go up, and reset when the process restarts.

var counter = metricFactory.CreateCounter("myCounter", "some help about this");


Gauges can go up and down.

var gauge = metricFactory.CreateGauge("gauge", "help text");


Summaries track the size and number of events.

var summary = metricFactory.CreateSummary("mySummary", "help text");


Histograms track the size and number of events in buckets. This allows for aggregate calculation of quantiles.

var hist = metricFactory.CreateHistogram("my_histogram", "help text", buckets: new[] { 0, 0.2, 0.4, 0.6, 0.8, 0.9 });

The default buckets are intended to cover a typical web/rpc request from milliseconds to seconds. They can be overridden passing in the buckets argument.


All metrics can have labels, allowing grouping of related time series.

See the best practices on naming and labels.

Taking a counter as an example:

var counter = metricFactory.CreateCounter("myCounter", "help text", labelNames: new []{ "method", "endpoint"});
counter.WithLabels("GET", "/").Inc();
counter.WithLabels("POST", "/cancel").Inc();

Since v4 there is alternative new way to provide a labels via ValueTuple that allow to reduce memory allocation:

var counter = metricFactory.CreateCounter("myCounter", "help text", labelNames: ("method", "endpoint"));
counter.WithLabels(("GET", "/")).Inc();
counter.WithLabels(("POST", "/cancel")).Inc();


AspNetCore Middleware: Prometheus.Client.AspNetCore

dotnet add package Prometheus.Client.AspNetCore

DependencyInjection support: Prometheus.Client.DependencyInjection

dotnet add package Prometheus.Client.DependencyInjection

Collect http requests duration: Prometheus.Client.HttpRequestDurations

dotnet add package Prometheus.Client.HttpRequestDurations

Push metrics to a PushGateway: Prometheus.Client.MetricPusher

dotnet add package Prometheus.Client.MetricPusher

Standalone Kestrel host: Prometheus.Client.MetricServer

dotnet add package Prometheus.Client.MetricServer

HealthChecks Publisher Prometheus.Client.HealthChecks

dotnet add package Prometheus.Client.HealthChecks


Contributions to the package are always welcome!


JetBrains Promitor

We much appreciate free licenses provided by JetBrains to support our library.

Thanks Promitor for supporting us via GitHub Sponsors.


All contents of this package are licensed under the MIT license.

Product Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  net6.0 was computed.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed. 
.NET Core netcoreapp2.0 was computed.  netcoreapp2.1 was computed.  netcoreapp2.2 was computed.  netcoreapp3.0 was computed.  netcoreapp3.1 was computed. 
.NET Standard netstandard2.0 is compatible.  netstandard2.1 is compatible. 
.NET Framework net461 was computed.  net462 was computed.  net463 was computed.  net47 was computed.  net471 was computed.  net472 was computed.  net48 was computed.  net481 was computed. 
MonoAndroid monoandroid was computed. 
MonoMac monomac was computed. 
MonoTouch monotouch was computed. 
Tizen tizen40 was computed.  tizen60 was computed. 
Xamarin.iOS xamarinios was computed. 
Xamarin.Mac xamarinmac was computed. 
Xamarin.TVOS xamarintvos was computed. 
Xamarin.WatchOS xamarinwatchos was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (23)

Showing the top 5 NuGet packages that depend on Prometheus.Client:

Package Downloads
Prometheus.Client.AspNetCore The ID prefix of this package has been reserved for one of the owners of this package by

ASP.NET Core middleware for the Prometheus.Client

Prometheus.Client.DependencyInjection The ID prefix of this package has been reserved for one of the owners of this package by

DependencyInjection support for the Prometheus.Client

Prometheus.Client.HealthChecks The ID prefix of this package has been reserved for one of the owners of this package by

HealthChecks middleware for the Prometheus.Client

Prometheus.Client.HttpRequestDurations The ID prefix of this package has been reserved for one of the owners of this package by

Metrics logging of request durations for the Prometheus.Client

Prometheus.Client.MetricPusher The ID prefix of this package has been reserved for one of the owners of this package by

Push metrics to a PushGateaway for the Prometheus.Client

GitHub repositories (2)

Showing the top 2 popular GitHub repositories that depend on Prometheus.Client:

Repository Stars
Bringing Azure Monitor metrics where you need them.
Version Downloads Last updated
5.2.0 1,128,407 1/5/2023
5.1.0 149,274 9/11/2022
5.0.0 767,094 8/21/2022
4.5.3 724,903 9/20/2021
4.5.2 317,220 7/14/2021
4.5.1 105,107 7/12/2021
4.4.0 183,950 3/11/2021
4.3.0 199,875 1/29/2021
4.2.0 127,972 10/21/2020
4.1.0 206,514 8/19/2020
3.1.0 980,013 1/10/2020
3.0.3 112,349 10/2/2019
3.0.2 96,271 9/4/2019
3.0.1 193,956 5/23/2019
3.0.0-rc2 1,829 4/1/2019
3.0.0-rc1 34,508 3/24/2019
2.2.2 522,326 3/1/2019
2.2.1 3,804 2/26/2019
2.2.0 322,971 2/10/2019
2.1.0 222,375 1/24/2019
2.0.0 603,548 9/13/2018
1.5.1 24,783 6/17/2018
1.5.0 18,729 4/22/2018
1.4.1 40,683 3/4/2018
1.4.0 102,004 12/3/2017
1.3.0 12,552 11/12/2017
1.2.2 1,763 11/9/2017
1.2.1 3,048 10/8/2017
1.1.3 1,514 10/8/2017
1.1.2 5,982 7/30/2017
1.1.1 2,085 6/7/2017
1.1.0 8,244 5/9/2017
1.0.0 3,542 5/8/2017
1.0.0-alpha2 6,540 3/6/2017
1.0.0-alpha1 1,477 3/3/2017