Popularity
2.4
Declining
Activity
7.4
Growing
81
5
20

Description

This is .NET version for prometheus.io

Programming language: C#
License: MIT License
Tags: Metrics     Netstandard     Prometheus    
Latest version: v4.2.0

Prometheus.Client alternatives and similar packages

Based on the "Metrics" category.
Alternatively, view Prometheus.Client alternatives based on common mentions on social networks and blogs.

Do you think we are missing an alternative of Prometheus.Client or a related project?

Add another 'Metrics' Package

README

Prometheus.Client

NuGet NuGet Gitter

CodeFactor CI codecov License MIT

.NET Client library for prometheus.io
Supports:

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

Installation

dotnet add package Prometheus.Client

Configuration

Examples

Prometheus Docs

Quick start:

1) Add IMetricFactory and ICollectorRegistry into DI container with extension library Prometheus.Client.DependencyInjection


public void ConfigureServices(IServiceCollection services)
{
    services.AddMetricFactory();
}


2) Add metrics endpoint

With Prometheus.Client.AspNetCore:


public void Configure(IApplicationBuilder app, IHostingEnvironment env, ILoggerFactory loggerFactory, IApplicationLifetime appLifetime)
{
    app.UsePrometheusServer();
}


Without extensions:


[Route("[controller]")]
public class MetricsController : Controller
{
    private readonly ICollectorRegistry _registry;

    public MetricsController(ICollectorRegistry registry)
    {
        _registry = registry;
    }

    [HttpGet]
    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)
{
    app.UsePrometheusServer();
    app.UsePrometheusRequestDurations(); 
}

Instrumenting

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.

Counter

Counters go up, and reset when the process restarts.

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

Gauge

Gauges can go up and down.

var gauge = metricFactory.CreateGauge("gauge", "help text");
gauge.Inc(3.4);
gauge.Dec(2.1);
gauge.Set(5.3);

Summary

Summaries track the size and number of events.

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

Histogram

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

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

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.

Labels

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();

Extensions

AspNetCore Middleware: Prometheus.Client.AspNetCore

dotnet add package Prometheus.Client.AspNetCore

Standalone host: Prometheus.Client.MetricServer

dotnet add package Prometheus.Client.MetricServer

Push metrics to a PushGateaway: Prometheus.Client.MetricPusher

dotnet add package Prometheus.Client.MetricPusher

Collect http requests duration: Prometheus.Client.HttpRequestDurations

dotnet add package Prometheus.Client.HttpRequestDurations

Contribute

Contributions to the package are always welcome!

Support

If you are having problems, send a mail to [[email protected]](mailto://[email protected]). We will try to help you.

License

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


*Note that all licence references and agreements mentioned in the Prometheus.Client README section above are relevant to that project's source code only.