Skip to content

Extremely useful library for collecting and tracking performance metrics in your .NET application

License

Notifications You must be signed in to change notification settings

qoollo/performance-counters

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

53 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Qoollo Performance Counters NuGet Build status

Extremely useful library for collecting and tracking performance metrics in your .NET applications.

This library allows you to measure performance of your application by some common metrics and send this values to any target.

Main features:

  • support most commonly used metrics;
  • support several targets to distribute counter values;
  • targets can be combined;
  • XSD schema for configuration section in App.config.

Supported metrics (counter types):

  • Number of Items (example: measure number of received requests);
  • Operations per Second (example: measure performance of your code);
  • Average Count (example: measure average size of queue);
  • Average Time (example: measure average execution time of your functions);
  • Moment Time (example: fixate time of some process that executing only once);
  • Elapsed Time (example: measure the total execution time of your application);
  • Delta (example: measure changes in processing rate);

Supported targets:

  • Internal (values are available only inside your app);
  • Windows Performance Counters (values can be read by windows performance monitor);
  • Network (values are sent to network service);
  • Graphite (values are sent to graphite/carbon server).

Quick start guide

  • add reference to performance counters library;
  • define category with required counters:
internal class TestSingleInstance: SingleInstanceCategoryWrapper
{
    public TestSingleInstance() : base("SingleInstance", "For tests") { }

    [Counter("Test NumberOfItemsCounter")]
    public NumberOfItemsCounter Count { get; private set; }
}
  • define your counters container (if you need a singleton):
internal class PerfCounters: Qoollo.PerformanceCounters.PerfCountersContainer
{
    private static TestSingleInstance _singleInstance = CreateNullCategoryWrapper<TestSingleInstance>();
    public static TestSingleInstance TestSingle { get { return _singleInstance; } }

    public static void Init(CategoryWrapper parent)
    {
        _singleInstance = parent.CreateSubCategory<TestSingleInstance>();
    }
}
  • create counters factory on application start-up and initialize you PerfCounters container:
var counterFactory = new WinCounterFactory();
// or load from App.config:
// var counterFactory = PerfCountersInstantiationFactory.CreateCounterFactoryFromAppConfig("PerfCountersConfigurationSection");

PerfCounters.Init(counterFactory.CreateRootWrapper());
counterFactory.InitAll();
  • use counters like this:
PerfCounters.TestSingle.Count.Increment();
  • don't forget to dispose counters factory when application is closing:
counterFactory.Dispose();

Extended materials

NuGet

About

Extremely useful library for collecting and tracking performance metrics in your .NET application

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages