prometheus-net 7.0.0

The ID prefix of this package has been reserved for one of the owners of this package by NuGet.org. Prefix Reserved
.NET 6.0 .NET Framework 4.6.2
There is a newer prerelease version of this package available.
See the version list below for details.

Requires NuGet 5.1 or higher.

dotnet add package prometheus-net --version 7.0.0
NuGet\Install-Package prometheus-net -Version 7.0.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-net" Version="7.0.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add prometheus-net --version 7.0.0
#r "nuget: prometheus-net, 7.0.0"
#r directive can be used in F# Interactive, C# scripting and .NET Interactive. Copy this into the interactive tool or source code of the script to reference the package.
// Install prometheus-net as a Cake Addin
#addin nuget:?package=prometheus-net&version=7.0.0

// Install prometheus-net as a Cake Tool
#tool nuget:?package=prometheus-net&version=7.0.0

.NET client library for the Prometheus monitoring and alerting system

Product Versions
.NET net6.0 net6.0-android net6.0-ios net6.0-maccatalyst net6.0-macos net6.0-tvos net6.0-windows net7.0 net7.0-android net7.0-ios net7.0-maccatalyst net7.0-macos net7.0-tvos net7.0-windows
.NET Framework net462 net463 net47 net471 net472 net48 net481
Compatible target framework(s)
Additional computed target framework(s)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (112)

Showing the top 5 NuGet packages that depend on prometheus-net:

Package Downloads
prometheus-net.AspNetCore The ID prefix of this package has been reserved for one of the owners of this package by NuGet.org.

ASP.NET Core middleware and stand-alone Kestrel server for exporting metrics to Prometheus

KubernetesClient

Client library for the Kubernetes open source container orchestrator.

prometheus-net.DotNetRuntime

Exposes .NET core runtime metrics (GC, JIT, lock contention, thread pool, exceptions) using the prometheus-net package.

MassTransit.Prometheus The ID prefix of this package has been reserved for one of the owners of this package by NuGet.org.

MassTransit Prometheus support; MassTransit is a message-based distributed application framework for .NET http://masstransit-project.com

Takenet.Iris.Common

Iris common data types package

GitHub repositories (24)

Showing the top 5 popular GitHub repositories that depend on prometheus-net:

Repository Stars
jellyfin/jellyfin
The Free Software Media System
microsoft/reverse-proxy
A toolkit for developing high-performance HTTP reverse proxy applications.
MassTransit/MassTransit
Distributed Application Framework for .NET
Xabaril/AspNetCore.Diagnostics.HealthChecks
Enterprise HealthChecks for ASP.NET Core Diagnostics Package
asynkron/protoactor-dotnet
Proto Actor - Ultra fast distributed actors for Go, C# and Java/Kotlin
Version Downloads Last updated
8.0.0-pre-230127154206-9ec9e9b 0 1/27/2023
8.0.0-pre-230127124604-8b7c7e1 0 1/27/2023
8.0.0-pre-230127111923-d72115a 0 1/27/2023
8.0.0-pre-230127084218-90f4311 14 1/27/2023
8.0.0-pre-230127075825-bfc1041 29 1/27/2023
8.0.0-pre-230126143551-210a1ab 48 1/26/2023
8.0.0-pre-230119065217-312c2e9 445 1/19/2023
8.0.0-pre-230116052305-1ed397b 376 1/16/2023
8.0.0-pre-230102092516-2351266 795 1/2/2023
8.0.0-pre-230101195105-9f23889 60 1/1/2023
8.0.0-pre-230101084444-630935f 48 1/1/2023
8.0.0-pre-221231102537-13e7ac6 62 12/31/2022
8.0.0-pre-221231100152-fb39dcb 49 12/31/2022
8.0.0-pre-000351-fb39dcb 49 12/31/2022
8.0.0-pre-000347-e83cc87 54 12/30/2022
8.0.0-pre-000346-e83cc87 50 12/30/2022
8.0.0-pre-000342-4d6812e 147 12/29/2022
7.1.0-pre-000318-0479f53 6,029 11/15/2022
7.1.0-pre-000310-9c9e1e9 2,448 11/7/2022
7.1.0-pre-000307-f980713 829 10/27/2022
7.0.0 1,155,506 10/26/2022
7.0.0-pre-000305-75cc817 2,943 10/17/2022
7.0.0-pre-000304-cbb305a 58 10/17/2022
7.0.0-pre-000303-5a44ada 293 10/16/2022
7.0.0-pre-000301-06c5932 229 10/13/2022
7.0.0-pre-000298-4b8d3e7 68 10/13/2022
7.0.0-pre-000297-7068d28 62 10/13/2022
7.0.0-pre-000296-5b1a1c4 1,472 10/5/2022
7.0.0-pre-000294-486fcd8 82 10/5/2022
7.0.0-pre-000293-d13fe06 449 10/4/2022
7.0.0-pre-000292-88fbe2a 67 10/4/2022
7.0.0-pre-000288-4688bd3 585 10/2/2022
7.0.0-pre-000282-d90ebf3 1,012 9/28/2022
7.0.0-pre-000280-ce6d494 68 9/28/2022
7.0.0-pre-000277-6bc5023 145 9/27/2022
7.0.0-pre-000276-9e65611 234 9/23/2022
7.0.0-pre-000270-ee6c23e 78 9/23/2022
7.0.0-pre-000269-08d9f2c 72 9/22/2022
7.0.0-pre-000259-7317089 325 9/21/2022
7.0.0-pre-000244-66d82e6 152 9/19/2022
6.0.0 8,646,460 3/3/2022
6.0.0-pre-000234-4598e28 143 3/3/2022
6.0.0-pre-000233-0dd30d3 802 3/2/2022
6.0.0-pre-000231-38d45fa 17,937 2/20/2022
6.0.0-pre-000223-ab9edeb 166 2/18/2022
5.1.0-pre-000215-c81d12d 8,064 1/22/2022
5.0.2 4,798,130 11/19/2021
5.0.2-pre-000210-fbf24c8 1,079 11/19/2021
5.0.1 6,373,117 8/19/2021
5.0.1-pre-000202-59e0610 264 8/19/2021
5.0.0 95,385 8/18/2021
5.0.0-pre-000201-8d79f11 2,007 7/30/2021
5.0.0-pre-000200-0afede9 443 7/30/2021
4.3.0-pre-000199-35f4961 307 7/29/2021
4.3.0-pre-000198-79466f7 314 7/29/2021
4.2.0 2,569,609 7/6/2021
4.2.0-pre-000195-ec10b08 271 7/6/2021
4.2.0-pre-000194-7aacfb0 268 7/6/2021
4.1.1 13,524,899 12/12/2020
4.1.1-pre-000180-1cfbebb 444 12/12/2020
4.1.0 9,966 12/12/2020
4.1.0-pre-000179-9582014 431 12/12/2020
4.1.0-pre-000171-15be8f3 3,615 12/6/2020
4.0.0 2,396,912 10/18/2020
4.0.0-pre-000158-d425fff 492 10/18/2020
4.0.0-pre-000134-2fea549 53,818 7/6/2020
3.6.0 5,219,380 6/19/2020
3.6.0-pre-000131-673cfe2 493 6/19/2020
3.6.0-pre-000129-bd91778 4,245 6/16/2020
3.5.0 4,246,819 3/9/2020
3.5.0-pre-000099-ee2bdbd 10,681 3/9/2020
3.5.0-pre-000098-f9cb93e 6,614 2/9/2020
3.4.0 1,847,795 12/26/2019
3.4.0-pre-000084-e9d0f37 414 12/26/2019
3.4.0-pre-000082-546478d 1,899 12/23/2019
3.4.0-pre-000081-1712a44 411 12/23/2019
3.4.0-pre-000079-eff2a83 431 12/22/2019
3.4.0-pre-000078-34a900d 481 12/22/2019
3.4.0-pre-000077-0ace5bd 521 12/20/2019
3.4.0-pre-000067-701dfdc 413 12/19/2019
3.3.1-pre-000052-0842664 1,750 12/13/2019
3.3.0 4,092,174 10/18/2019
3.3.0-pre-000042-252e89c 438 10/18/2019
3.2.1 395,642 10/2/2019
3.2.1-pre-000036-696f4ab 415 10/2/2019
3.2.0 1,841 10/1/2019
3.2.0-pre-000035-8d4cf7d 465 10/1/2019
3.2.0-pre-000032-9939133 474 9/25/2019
3.2.0-pre-000028-abe3225 439 9/25/2019
3.2.0-pre-000027-29e0fce 440 9/25/2019
3.1.5-pre-000023-d29ca37 793 9/24/2019
3.1.5-pre-000021-8c7b328 426 9/24/2019
3.1.5-pre-000020-5a2fc50 453 9/24/2019
3.1.4 1,752,984 6/20/2019
3.1.4-pre-000016-95d0170 501 6/20/2019
3.1.3 329,918 5/30/2019
3.1.3-pre-000009-505a08e 558 5/29/2019
3.1.3-cb-000009-505a08e 470 5/29/2019
3.1.2 4,044,228 4/27/2019
3.1.2-pre-006681-4f8ce09 3,952 4/23/2019
3.1.1 181,507 4/10/2019
3.1.1-pre-006463-cd3cd18 510 4/10/2019
3.1.0 110,286 3/29/2019
3.1.0-pre-006304-959164e 522 3/27/2019
3.1.0-pre-006267-9aac888 3,431 3/22/2019
3.1.0-pre-006177-d35e0b8 697 3/15/2019
3.0.3 405,687 2/11/2019
3.0.2 7,370 2/7/2019
3.0.1 3,697 2/6/2019
3.0.0 89,567 2/5/2019
3.0.0-pre-005830-d9493da 572 2/4/2019
3.0.0-pre-005828-27b7100 553 2/4/2019
3.0.0-pre-005823-68ad8e2 568 2/4/2019
3.0.0-pre-005803-4289c4a 579 2/1/2019
3.0.0-pre-005801-6f306bc 662 1/31/2019
3.0.0-pre-005800-ec1da05 582 1/31/2019
3.0.0-pre-005795-6aca95b 595 1/30/2019
3.0.0-pre-005647-e277cbe 2,133 1/9/2019
2.1.3 1,562,185 9/25/2018
2.1.3-pre-005238-380e4ab 652 9/25/2018
2.1.2 36,109 9/6/2018
2.1.2-pre-005131-012bc01 712 9/6/2018
2.1.1-pre-004445-bc00b93 4,926 5/25/2018
2.1.0 596,124 4/13/2018
2.1.0-pre-003985-910fb52 847 4/11/2018
2.1.0-pre-003982-37c9f93 751 4/11/2018
2.0.0 236,125 2/26/2018
2.0.0-pre-003523-49de0a3 2,066 2/22/2018
2.0.0-pre-003112-3de1c34 2,643 2/7/2018
2.0.0-pre-003077-0447c86 1,761 2/5/2018
2.0.0-pre-003054-ffb96c7 895 2/1/2018
2.0.0-pre-003051-6f12a46 1,034 2/1/2018
2.0.0-pre-003009-4e26344 7,132 1/27/2018
2.0.0-pre-002968-9fcb8aa 999 1/25/2018
1.3.6-rc 28,226 5/5/2017
1.3.5 173,387 3/18/2017
1.3.4 7,842 3/10/2017
1.3.4-beta 907 1/16/2017
1.2.4 8,335 11/9/2016
1.2.3 1,397 10/31/2016
1.2.2.1 16,795 8/20/2016
1.1.4 2,104 7/14/2016
1.1.3 1,933 6/1/2016
1.1.2 1,122 5/21/2016
1.1.1 1,311 4/25/2016
1.1.0 1,321 3/8/2016
0.0.11 1,324 1/11/2016
0.0.10 1,048 12/19/2015
0.0.9 1,108 12/4/2015
0.0.8 1,117 12/2/2015
0.0.7 1,229 11/26/2015
0.0.6 1,138 11/18/2015
0.0.5 1,461 11/6/2015
0.0.3 1,306 4/15/2015

* 7.0.0
- .NET Core specific functionality now targeting .NET 6.0 or greater (all previous versions will be end of life by December 2022).
- Relaxed the API restriction that forbade you to create multiple metrics with the same name but different label names. While this is a Prometheus anti-pattern, it is a standard pattern in other metrics technologies and we will allow it in the name of interoperability.
- Added IMetricFactory.WithLabels() to define static labels per-factory and reduce the effort needed by users when defining static labels in specific scopes.
- Added automatic metric expiration feature, to remove timeseries when they are no longer used after a while. This improves interoperability with other metrics technologies such as .NET Meters.
- (Breaking change) Rewrite of the MeterAdapter functionality to bridge .NET 6 metrics to Prometheus. API remains equivalent, though options class changed. Output format (what metrics are published) is completely different. Now it translates metric names (instead of putting them in labels) and preserves tags (labels) provided via the .NET Meters API. Added sample project to demonstrate functionality. Ref #359
- (Breaking change) Dropped support for .NET Standard 2.0 - now will target specifically .NET 6.0 and .NET Framework 4.6.2. This was already documented before but there was "unofficial" support also for .NET Standard remaining. This is now removed.
- (Breaking change) EventCounterAdapter output format changed to translate counters to Prometheus metrics and to improve usability by publishing both counters and gauges from ambiguous event counters.
- EventCounterAdapter and MeterAdapter are now enabled on startup by default.
- Added some debug metrics to indicate the number of metric families, instances and timeseries being exported by prometheus-net.
- Added typical benchmark results to readme for easy reference, and to show relative speed of the simple versus complex instruments.
- Removed MetricConfiguration.StaticLabels because it had negative performance impact on many code paths that did not use it. The same functionality can be manually implemented in user code. Static labels remain available on registry and factory level.
- When a before-collection metrics update callback throws an exception, it is now logged and ignored instead of breaking all metrics collection.
- EventCounterAdapter now defaults to Informational events only, for reduced performance overhead. Can be configured via callback.
* 6.0.0
- Dropped library support for unsupported .NET runtime versions (.NET 2.1).
- If Razor Pages is enabled, the "page" label is now automatically added to the default HTTP server metrics, unless there is a user-defined label already present with this name.
- The "endpoint" label is now automatically added to the default HTTP server metrics, containing this endpoint routing route pattern of the request, unless there is a user-defined label already present with this name.
- Added integration with .NET EventCounters, which can now be easily exposed as Promtheus metrics (see EventCounterAdapter class).
- Added integration with .NET Meters, which can now be easily exposed as Promtheus metrics (see MeterAdapter class).
- Added ReplaceOnPush option to MetricPusher #305 #322.
- Minimum .NET Framework version is now 4.6.2.
* 5.1.0
- Add support for adding custom label value providers to HTTP server metrics. #347
* 5.0.2
- Bugfix: HttpClientMetrics under concurrent load with long-running requests were leading to broken response streams. #336
* 5.0.1
- Bugfix: PowersOfTenDividedBuckets did not work with >= 10 buckets due to overlap. Now skips overlapping region of generated series.
* 5.0.0
- Added HTTP client metric that measures the response duration (time until response content reading is finished).
- Added "client" label containing the name of HTTP client to HTTP client metrics.
- Added "code" label with HTTP response code to HTTP client metrics. #299
- HTTP client metrics now count responses when they are completed, not when started, to match with HTTP server metrics. Also renamed metric to httpclient_requests_sent_total since it said "received" previously (due to copy-paste error from HTTP server metrics).
- HTTP client metrics are now published via the netstandard package, without requiring ASP.NET Core. #314
- Added Counter.IncTo[Current]TimeUtc().
* 4.2.0
- Added Histogram.PowersOfTenDividedBuckets()
- Improved accuracy of histogram bucket calculations to reduce the likelyhood of seeing 0.00000000000000000001 offsets from expected value due to floating point math.
- Added ConfigureAwait(false) to MetricHandler to help avoid deadlocks in some rare scenarios. #308
- Fix defect where MetricPusher terminated when HttpClient signaled timeout. #302, #293
- No longer need to manually reference ASP.NET Core SDK in csproj file when installing prometheus-net.AspNetCore library. It gets automatically referenced now. #267
* 4.1.1
- Bugfix: HTTP request metrics in 4.1.0 got broken due to typo in middleware helper.
* 4.1.0
- Fixed HttpClient metrics duration that was incorrectly measured. #265
- prometheus-net.NetFramework.AspNet is now strong named, just like all the other assemblies. #273
- NetFx target is now conditional for Windows builds only, to allow easier development work on nonwindows platforms. #264
- MetricPusher now supports a callback for logging push errors. #186
- Added support for defining static labels on registry or metric level. #256
- Added ICollectorRegistry and IMetricFactory for mocking in test code. #268
- Ignore /metrics URL by default in HTTP request metrics.
- Fix overflow in Summary after observing more than uint.MaxValue events. #277
- Reduce allocations in hot paths. #276, #275
- Added request filtering (authorization) support to standalone MetricServer. #261
* 4.0.0
- Allow arbitrary ASP.NET Core route parameters to be exposed as HTTP metric labels. #225
- Breaking change: some HTTP metrics implementation classes were changed from public to internal. They were never supposed to be public and hopefully nobody ever used them directly. Public documented API did not change.
- Add HttpClient metrics with IHttpClientFactory integration.
* 3.6.0
- Added ASP.NET Core health check publisher for publishing metrics on health check status. #203 #209
- Fixed hang in ASP.NET Web API exporter. #215
- Fixed ASP.NET Web API exporter exporting metrics from the wrong registry. #217
- Reduced memory use in MetricPusher implementation. Inspired by #208
- Added basic gRPC service metrics support. #212
- Reduce pointless log spam on cancelled scrapes - will silently ignore cancelled scrapes in the ASP.NET Core exporter. #220
* 3.5.0
- Exposed metric.Unpublish() method since there was already a matching Publish() there.
- When the scrape is aborted, stop collecting/serializing metrics. #189
- Added simple metric export handler for legacy ASP.NET Web API, to avoid having to deal with HttpListener complexity.
* 3.4.0
- Separate packaging for ASP.NET Core 3 to reduce package reference management complexity for users. #164
- Lazy-initialize the default sample metrics to reduce initialization cost for those who do not need them. #170
- ASP.NET Core middlware no longer disposes of output stream. #171
- Fix DotNetStats occasional data tearing under parallel collections. #173
- Improved wording of some error messages. #169
- Added Counter.IncTo(), Gauge.IncTo(), Gauge.DecTo(). #181
- Added Gauge.Set(DateTimeOffset) and Gauge.IncTo(DateTimeOffset). #181
- Improve .NET Framework 4.6.1 packaging to include the ValueTuple reference automatically. #179
- ASP.NET Core HTTP metrics now capture route data before it is overwritten by an exception handler. #177
- ASP.NET Core HTTP "in progress" metrics now include controller/action labels (ASP.NET Core 3 only).
- Fixed concurrently defect in HTTP metrics that may have caused label values from wrong request to apply. #182
- The HttpListener based MetricServer can now handle more than one concurrent request.
- Added asynchronous "before collect" callbacks, giving user code more flexibility in metric updates.
- Added .Remove() to labeled metric instances for more convenient removal API (previously had to call method on parent instance).
- Added .Unpublish() to labeled metric instances to support temporary unpublishing of a metric, without discarding collected data (e.g. histogram buckets), during periods of data unavailability.
* 3.3.0
- Add ability to filter requests by port number when exporting metrics. #160
* 3.2.1
- Fix NuGet packaging defect that caused reference failures after installing .2.0 on .NET Core 2.1 or newer. #158
* 3.2.0
- Enable custom HTTP client to be used in MetricPusher, allowing for Basic auth and more flexibility. #125
- Add DiagnosticSourceAdapter (.NET Core only). #153
- Improved compatibility with older .NET Framework versions. #155
* 3.1.4
- Fix timezone mismatch in Summary that led to unintended delays in buffer flushing. #149
* 3.1.3
- Fix regression introduced in 3.1.0 where MetricPusher does not always flush metrics before stopping.
* 3.1.2
- Fix defect where Histogram batch observations only incremented sum by one value, instead of entire batch. #147
* 3.1.1
- Added missing UTF-8 charset to Content-Type header, so non-ASCII characters are interpreted correctly by browsers.
* 3.1.0
- Added ICounter.NewTimer() (adds the value to the counter)
- Eliminated some needless allocations when trying to register a metric that is already registered. #134
- Added IHistogram.Count and IHistogram.Sum to expose aspects of collected data for inspection.
- Added Collector.GetAllLabelValues() to expose the list of child metrics by all their known label values.
- Metric export is now asynchronous internally to be compatible with ASP.NET Core 3.0 default configuration.
- Added CollectorRegistry.CollectAndExportAsTextAsync() to support metric data export via arbitrary custom endpoints.
* 3.0.3
- Now backward compatible with ASP.NET Core 2.1 (was 2.2+)
* 3.0.2
- Fix defect where histogram sum failed to increment.
* 3.0.1
- Fix ObjectDisposedException in MetricPusher.
* 3.0.0
- Added HTTP request metrics for ASP.NET Core.
- Somewhat more realistic examples in readme.
- Metrics exporter is now significantly more CPU and memory-efficient.
- Added Observe(value, count) to histogram metric, enabling multiple observations with the same value to be counted.
- Added CountExceptions() and MeasureInProgress() helper extensions.
- Adjusted API to better conform to Prometheus client library guidelines in terms of default values.
- Breaking change: assemblies are now strong-named.
- Breaking change: removed "windows" from built-in metric names as they are not Windows-specific.
- Breaking change: removed support for protobuf export format (it is no longer used by Prometheus).
- Breaking change: API surface cleaned up, removed some legacy methods, made many internal types actually internal.
- Breaking change: "on demand collectors" concept replaced with simpler "before collect callbacks". Works the same, just less code needed to use it and fewer possible error conditions.
- Breaking change: removed support for "custom collectors", as this was a very special use case that did not benefit at all from the main functionality of the library. Just generate a Prometheus exporter output document yourself if you need to export arbitrary data.
* 2.1.3
- Fixed wrong case used for metric type in the export data format. Should always be lowercase. #96
* 2.1.2
- Fixed potential conflict when using pushgateway and also other exporter libraries (see #89)
* 2.1.1
- Various minor fixes (see issues on GitHub for details).
* 2.1.0
- Add MetricOptions and subclasses for more extensible API (old API surface remains available)
- Add SuppressInitialValue to metric configuration (ref https://www.robustperception.io/existential-issues-with-metrics/)
- Add .WithLabels() as alternative to .Labels() for fewer annoying Intellisense conflicts.
* 2.0.0
- Targeting .NET Standard 2.0 as minimum version (.NET Framework 4.6.1, .NET Core 2.0 and Mono 5.4)
- Added ASP.NET Core middlware
- Added possibility to signal a failed scrape from on-demand collectors
- Removed dependency on Reactive Extensions
- Minor breaking changes to API
- Performance improvements for hot-path code
- Removed mostly obsolete PerfCounterCollector class
- Fixed NuGet package contents to remove assemblies from dependencies
- Various minor fixes (see issues on GitHub for details)
* 1.3.4
- Added support for .NET 4.5 using System.Reactive 3.1.1.
- .NET 4.0 support continues to target Rx 2.5
* 1.2.4:
- Fixed MetricPusher not flushing metrics when stopped
* 1.2.3:
- Fixed label values escaping for ASCII formatter
* 1.2.2:
- PushGateway support
- Various internal improvements (replaced locks with Interlocked operations)
* 1.1.4:
- Fixed some metrics not updating, added process ID metric
- Replaced lock statements in Counter and Gauge with CAS
* 1.1.3:
- optionally use https in MetricServer
* 1.1.2:
- using UTF-8 in text formatter
- catching exceptions in MetricServer http loop
* 1.1.1:
- disposing of MetricServer loop on Stop()
* 1.1.0:
- Renamed some metric names to be in-line with prometheus guidelines (breaking change as far as the exported metrics are concerned)
* 1.0.0:
- Add CPU, num handles, start time, num threads metrics to dot net stats collector
- Made DotNetStatsCollector default (previously it was PerfCounterCollector)
* 0.0.11:
- Summary metric ported from go
* 0.0.10:
- Fix header writing order
* 0.0.9:
- Generalise scraping so it can be called externally without using the embedded http handler
* 0.0.8:
- Introduced interfaces for all the metrics to make unlabelled collectors and their children polymorph
* 0.0.7:
- Added the notion of OnDemandCollectors + a DotNetStatsCollector to avoid having to use .net perf counters
* 0.0.6:
- Do not create unlabelled metric if label names are specified
* 0.0.5:
- Allow specifying hostname in URL
- Fix null ref exception if 'Accept' header is not specified
* 0.0.3 - initial version