V4

Summary

A large refactor that aims to make this library far more stable and performant by default. Event counters are now the default source of metrics while more detailed events can be enabled manually when required (see CaptureLevel).

Changes

Breaking changes

• Dropped support for prometheus-net v2.
• Dropped support for netcoreapp2.2
• WithThreadPoolSchedulingStats has been removed- it was both a performance hog and incorrect (the IDs of the start/stop events were not stable). May consider adding this in a later release as .NET 5.0 should have fixed the stable IDs issue.
• DotNetRuntimeStatsBuilder.Default() now only uses event counters to generate metrics. JIT metrics will not be collected (there are no JIT-related event counters in .NET core 3.1). Plan to add support for .NET 5.0 in a later release. You can restore more detailed metrics by using DotNetRuntimeStatsBuilder.Customize() and passing a custom CaptureLevel.
• Renamed dotnet_gc_collection_reasons_total -> dotnet_gc_collection_count_total

Additions/ enhancements

• Added new threadpool metrics: dotnet_threadpool_throughput_total, dotnet_threadpool_queue_length and dotnet_threadpool_timer_count
• Added dotnet_gc_memory_total_available_bytes to track the total amount of memory .NET can allocate to (this takes into account docker memory limits)
• Added ability to configure the source of majority of collectors- can either be driven solely by event counters (CaptureLevel.Counters) or event listeners for more detailed metrics.
• Added support for recycling EventListeners periodically (net5.0 only as netcoreapp3.1 is impacted by dotnet/runtime#49804).
• Improved the collection of debugging metrics available
• Added documentation around metrics exposed
• Added an example docker-compose stack that can be used for testing and experimentation

Fixes

• #9
• #10
• #20
• #33
• #35
• #39

Adding support for .net 5.0

This release includes net5.0 as a targeted framework. Fixes #44.

Adding ExceptionStatsCollector

Added new stats collector, ExceptionStatsCollector- can now expose the number of exceptions broken down by the type via the dotnet_exceptions_total metric.

Bug fixes

• Fix minor memory leak: #29

Adding support for .NET standard 2.1

Merged https://github.com/djluck/prometheus-net.DotNetRuntime/pulls?q=is%3Apr+is%3Aclosed, adding ability to use prometheus-net.DotNetRuntime in .NET core 2.1 projects. This enables support for projects that while are built against .NET core 2.1, run against v2.2+ of the runtime.

v3.2.0

First full release of prometheus-net.DotNetRuntime.