System.Diagnostics.PerformanceCounter 9.0.0

About

This package provides types that allow applications to interact with the Windows performance counters.

Windows allows you to examine how programs you run affect your computer's performance, both in real time and by collecting log data for later analysis. You can do this via the Windows Performance Monitor tool, which uses performance counters, among other features.

Windows performance counters provide a high-level abstraction layer that provides a consistent interface for collecting various kinds of system data such as CPU, memory, and disk usage. They can be included in the operating system or can be part of individual applications. Windows Performance Monitor requests the current value of performance counters at specifiedtime intervals.

System administrators often use performance counters to monitor systems for performance or behavior problems. Software developers often use performance counters to examine the resource usage of their programs.

Key Features

  • Can be used to read existing predefined or custom counters.
  • Can be used for publishing (writing) data to custom counters.
  • Can collect performance counters from the local machine or from a remote machine.

How to Use

using System;
using System.Collections.Generic;
using System.Diagnostics;

public class App
{
    public static void Main()
    {
        List<CounterSample> samples = [];

        // If the category does not exist, create the category and exit.
        // Performance counters should not be created and immediately used.
        // There is a latency time to enable the counters, they should be created
        // prior to executing the application that uses the counters.
        // Execute this sample a second time to use the category.
        if (SetupCategory())
        {
            return;
        }

        CollectSamples(samples);
        CalculateResults(samples);
    }

    private static bool SetupCategory()
    {
        if (PerformanceCounterCategory.Exists("AverageCounter64SampleCategory"))
        {
            Console.WriteLine("Category exists - AverageCounter64SampleCategory");
            return false;
        }

        CounterCreationDataCollection counterDataCollection = [];

        // Add the counter.
        CounterCreationData averageCount64 = new()
        {
            CounterType = PerformanceCounterType.AverageCount64,
            CounterName = "AverageCounter64Sample"
        };
        counterDataCollection.Add(averageCount64);

        // Add the base counter.
        CounterCreationData averageCount64Base = new()
        {
            CounterType = PerformanceCounterType.AverageBase,
            CounterName = "AverageCounter64SampleBase"
        };
        counterDataCollection.Add(averageCount64Base);

        // Create the category.
        PerformanceCounterCategory.Create("AverageCounter64SampleCategory",
            "Demonstrates usage of the AverageCounter64 performance counter type.",
            PerformanceCounterCategoryType.SingleInstance, counterDataCollection);

        return true;
    }

    private static void CollectSamples(List<CounterSample> samples)
    {
        // Create the counters

        PerformanceCounter avgCounter64Sample = new PerformanceCounter("AverageCounter64SampleCategory",
            "AverageCounter64Sample",
            false)
        {
            RawValue = 0
        };

        PerformanceCounter avgCounter64SampleBase = new PerformanceCounter("AverageCounter64SampleCategory",
            "AverageCounter64SampleBase",
            false)
        {
            RawValue = 0
        };

        Random r = new(DateTime.Now.Millisecond);

        for (int j = 0; j < 100; j++)
        {
            int value = r.Next(1, 10);
            Console.Write(j + " = " + value);

            avgCounter64Sample.IncrementBy(value);

            avgCounter64SampleBase.Increment();

            if ((j % 10) == 9)
            {
                OutputSample(avgCounter64Sample.NextSample());
                samples.Add(avgCounter64Sample.NextSample());
            }
            else
            {
                Console.WriteLine();
            }

            System.Threading.Thread.Sleep(50);
        }
    }

    private static void CalculateResults(List<CounterSample> samples)
    {
        for (int i = 0; i < (samples.Count - 1); i++)
        {
            // Output the sample.
            OutputSample(samples[i]);
            OutputSample(samples[i + 1]);

            // Use .NET to calculate the counter value.
            Console.WriteLine($".NET computed counter value = {CounterSampleCalculator.ComputeCounterValue(samples[i], samples[i + 1])}");

            // Calculate the counter value manually.
            Console.WriteLine($"My computed counter value = {MyComputeCounterValue(samples[i], samples[i + 1])}");
        }
    }

    //    Description - This counter type shows how many items are processed, on average,
    //        during an operation. Counters of this type display a ratio of the items
    //        processed (such as bytes sent) to the number of operations completed. The
    //        ratio is calculated by comparing the number of items processed during the
    //        last interval to the number of operations completed during the last interval.
    // Generic type - Average
    //      Formula - (N1 - N0) / (D1 - D0), where the numerator (N) represents the number
    //        of items processed during the last sample interval and the denominator (D)
    //        represents the number of operations completed during the last two sample
    //        intervals.
    //    Average (Nx - N0) / (Dx - D0)
    //    Example PhysicalDisk\ Avg. Disk Bytes/Transfer
    private static float MyComputeCounterValue(CounterSample s0, CounterSample s1)
    {
        float numerator = (float)s1.RawValue - s0.RawValue;
        float denomenator = (float)s1.BaseValue - s0.BaseValue;
        float counterValue = numerator / denomenator;
        return counterValue;
    }

    private static void OutputSample(CounterSample s)
    {
        Console.WriteLine("\r\n+++++++++++");
        Console.WriteLine("Sample values - \r\n");
        Console.WriteLine($"   BaseValue        = {s.BaseValue}");
        Console.WriteLine($"   CounterFrequency = {s.CounterFrequency}");
        Console.WriteLine($"   CounterTimeStamp = {s.CounterTimeStamp}");
        Console.WriteLine($"   CounterType      = {s.CounterType}");
        Console.WriteLine($"   RawValue         = {s.RawValue}");
        Console.WriteLine($"   SystemFrequency  = {s.SystemFrequency}");
        Console.WriteLine($"   TimeStamp        = {s.TimeStamp}");
        Console.WriteLine($"   TimeStamp100nSec = {s.TimeStamp100nSec}");
        Console.WriteLine("++++++++++++++++++++++");
    }
}

Notes:

  • This assembly is only supported on Windows operating systems.
  • Only the administrator of the computer or users in the Performance Logs User Group can log counter data. Users in the Administrator group can log counter data only if the tool they use to log counter data is started from a Command Prompt window that is opened with Run as administrator.... Any users in interactive logon sessions can view counter data. However, users in non-interactive logon sessions must be in the Performance Monitoring Users group to view counter data.

Main Types

The main types provided by this library are:

Under the System.Diagnostics namespace, the main types are:

Under the System.Diagnostics.PerformanceData namespace, the main types are:

Additional Documentation

Feedback & Contributing

System.Diagnostics.PerformanceCounter is released as open source under the MIT license. Bug reports and contributions are welcome at the GitHub repository.

Showing the top 20 packages that depend on System.Diagnostics.PerformanceCounter.

Packages Downloads
Elastic.Apm
Elastic APM .NET Agent base package. This package provides core functionality for transmitting of all Elastic APM types and is a dependent package for all other Elastic APM package. Additionally this package contains the public Agent API that allows you to manually capture transactions and spans. Please install the platform specific package for the best experience. See: https://github.com/elastic/apm-agent-dotnet/tree/main/docs
282
Elastic.Apm
Elastic APM .NET Agent base package. This package provides core functionality for transmitting of all Elastic APM types and is a dependent package for all other Elastic APM package. Additionally this package contains the public Agent API that allows you to manually capture transactions and spans. Please install the platform specific package for the best experience. See: https://github.com/elastic/apm-agent-dotnet/tree/main/docs
2,006
Microsoft.Windows.Compatibility
This Windows Compatibility Pack provides access to APIs that were previously available only for .NET Framework. It can be used from both .NET Core as well as .NET Standard. When using NuGet 3.x this package requires at least version 3.4.
697
Oracle.ManagedDataAccess.Core
Oracle Data Provider for .NET (ODP.NET) Core is a multi-platform ADO.NET driver that provides fast data access from Microsoft .NET (Core) clients to Oracle databases. ODP.NET Core consists of a single 100% managed code dynamic-link library.
323
Oracle.ManagedDataAccess.Core
Oracle Data Provider for .NET (ODP.NET) Core is an ADO.NET driver that provides fast data access from Microsoft .NET Core clients to Oracle databases. ODP.NET Core consists of a single 100% managed code dynamic-link library.
53
Oracle.ManagedDataAccess.Core
Oracle Data Provider for .NET (ODP.NET) Core is an ADO.NET driver that provides fast data access from Microsoft .NET Core clients to Oracle databases. ODP.NET Core consists of a single 100% managed code dynamic-link library.
99
Oracle.ManagedDataAccess.Core
Oracle Data Provider for .NET (ODP.NET) Core is an ADO.NET driver that provides fast data access from Microsoft .NET Core clients to Oracle databases. ODP.NET Core consists of a single 100% managed code dynamic-link library.
115
Quantum.Framework.Core.StandardLib
Package Description
52
Quantum.Framework.Core.StandardLib
Package Description
56
Quantum.Framework.Core.StandardLib
Package Description
57
Quantum.Framework.Core.StandardLib
Package Description
58
Quantum.Framework.Core.StandardLib
Package Description
61
Quantum.Framework.Core.StandardLib
Package Description
62
Quantum.Framework.Core.StandardLib
Package Description
63
Quantum.Framework.Core.StandardLib
Package Description
64
Quantum.Framework.Core.StandardLib
Package Description
171
StackExchange.Redis
High performance Redis client, incorporating both synchronous and asynchronous usage.
9,740
System.Data.OleDb
Provides a collection of classes for OLEDB. Commonly Used Types: System.Data.OleDb.OleDbCommand System.Data.OleDb.OleDbCommandBuilder System.Data.OleDb.OleDbConnection System.Data.OleDb.OleDbDataAdapter System.Data.OleDb.OleDbDataReader System.Data.OleDb.OleDbParameter System.Data.OleDb.OleDbParameterCollection System.Data.OleDb.OleDbTransaction When using NuGet 3.x this package requires at least version 3.4.
693

https://go.microsoft.com/fwlink/?LinkID=799421

.NET Framework 4.6.2

  • No dependencies.

.NET 8.0

.NET 9.0

.NET Standard 2.0

  • No dependencies.

Version Downloads Last updated
9.0.0 1 11/17/2024
9.0.0-rc.2.24473.5 3 11/05/2024
9.0.0-rc.1.24431.7 3 11/09/2024
9.0.0-preview.7.24405.7 3 11/10/2024
9.0.0-preview.6.24327.7 3 11/10/2024
9.0.0-preview.5.24306.7 5 11/10/2024
9.0.0-preview.4.24266.19 10 05/29/2024
9.0.0-preview.3.24172.9 7 05/29/2024
9.0.0-preview.2.24128.5 8 05/03/2024
9.0.0-preview.1.24080.9 8 05/29/2024
8.0.1 3 11/10/2024
8.0.0 187 05/08/2024
8.0.0-rc.2.23479.6 9 12/13/2023
8.0.0-rc.1.23419.4 9 10/07/2023
8.0.0-preview.7.23375.6 12 08/22/2023
8.0.0-preview.6.23329.7 9 05/29/2024
8.0.0-preview.5.23280.8 8 07/08/2023
8.0.0-preview.4.23259.5 8 06/05/2023
8.0.0-preview.3.23174.8 11 05/29/2024
8.0.0-preview.2.23128.3 8 05/29/2024
8.0.0-preview.1.23110.8 11 05/29/2024
7.0.0 6 05/29/2024
7.0.0-rc.2.22472.3 10 05/29/2024
7.0.0-rc.1.22426.10 8 05/29/2024
7.0.0-preview.7.22375.6 6 05/29/2024
7.0.0-preview.6.22324.4 8 05/29/2024
7.0.0-preview.5.22301.12 8 05/29/2024
7.0.0-preview.4.22229.4 8 05/29/2024
7.0.0-preview.3.22175.4 8 04/19/2022
7.0.0-preview.2.22152.2 7 05/29/2024
7.0.0-preview.1.22076.8 7 05/29/2024
6.0.2 0 11/12/2024
6.0.2-mauipre.1.22102.15 8 05/29/2024
6.0.2-mauipre.1.22054.8 7 05/29/2024
6.0.1 175 04/13/2023
6.0.0 25 04/19/2022
6.0.0-rc.2.21480.5 8 05/29/2024
6.0.0-rc.1.21451.13 6 05/29/2024
6.0.0-preview.7.21377.19 7 05/29/2024
6.0.0-preview.6.21352.12 10 05/29/2024
6.0.0-preview.5.21301.5 9 05/29/2024
6.0.0-preview.4.21253.7 11 05/29/2024
6.0.0-preview.3.21201.4 6 05/29/2024
6.0.0-preview.2.21154.6 9 05/29/2024
6.0.0-preview.1.21102.12 9 05/29/2024
5.0.1 8 01/31/2024
5.0.0-rc.2.20475.5 9 05/29/2024
5.0.0-rc.1.20451.14 6 05/29/2024
5.0.0-preview.8.20407.11 7 05/29/2024
5.0.0-preview.7.20364.11 7 05/29/2024
5.0.0-preview.6.20305.6 9 05/29/2024
5.0.0-preview.5.20278.1 12 05/29/2024
5.0.0-preview.4.20251.6 8 05/29/2024
5.0.0-preview.3.20214.6 8 05/29/2024
5.0.0-preview.2.20160.6 7 05/29/2024
5.0.0-preview.1.20120.5 9 05/29/2024
4.7.0 890 10/11/2022
4.7.0-preview3.19551.4 7 05/29/2024
4.7.0-preview2.19523.17 11 05/29/2024
4.7.0-preview1.19504.10 9 05/29/2024
4.6.0 13 05/29/2024
4.6.0-rc1.19456.4 9 05/29/2024
4.6.0-preview9.19421.4 9 05/29/2024
4.6.0-preview9.19416.11 9 05/29/2024
4.6.0-preview8.19405.3 8 05/29/2024
4.6.0-preview7.19362.9 9 05/29/2024
4.6.0-preview6.19303.8 9 05/29/2024
4.6.0-preview6.19264.9 8 05/29/2024
4.6.0-preview5.19224.8 6 05/29/2024
4.6.0-preview4.19212.13 11 05/29/2024
4.6.0-preview3.19128.7 8 05/29/2024
4.6.0-preview.19073.11 11 05/29/2024
4.6.0-preview.18571.3 8 05/29/2024
4.5.0 13,844 04/21/2022
4.5.0-rc1 7 05/29/2024
4.5.0-preview2-26406-04 7 05/29/2024
4.5.0-preview1-26216-02 7 05/29/2024
4.5.0-preview1-25914-04 5 05/29/2024