PerformanceCounter Klasa

Definicja

Przestrzeń nazw:

System.Diagnostics

Zestaw:

System.Diagnostics.PerformanceCounter.dll

Źródło:

PerformanceCounter.cs

Reprezentuje składnik licznika wydajności systemu Windows NT.

public ref class PerformanceCounter sealed : System::ComponentModel::Component, System::ComponentModel::ISupportInitialize

public sealed class PerformanceCounter : System.ComponentModel.Component, System.ComponentModel.ISupportInitialize

type PerformanceCounter = class
    inherit Component
    interface ISupportInitialize

Public NotInheritable Class PerformanceCounter
Inherits Component
Implements ISupportInitialize

Dziedziczenie

Object

MarshalByRefObject

Component

PerformanceCounter

Implementuje

ISupportInitialize

Przykłady

W poniższym przykładzie kodu pokazano użycie klasy do utworzenia PerformanceCounter i użycia typu licznika AverageCount64 . Przykład tworzy kategorie, konfiguruje liczniki, zbiera dane z liczników i wywołuje klasę CounterSampleCalculator w celu zinterpretowania danych licznika wydajności. Wyniki pośrednie i końcowe są wyświetlane w oknie konsoli. Aby uzyskać dodatkowe przykłady innych typów liczników wydajności, zobacz PerformanceCounterType wyliczenie.

using System;
using System.Collections;
using System.Collections.Specialized;
using System.Diagnostics;

public class App
{
    private static PerformanceCounter avgCounter64Sample;
    private static PerformanceCounter avgCounter64SampleBase;

    public static void Main()
    {
        ArrayList samplesList = new ArrayList();

        // 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;
        CreateCounters();
        CollectSamples(samplesList);
        CalculateResults(samplesList);
    }

    private static bool SetupCategory()
    {
        if ( !PerformanceCounterCategory.Exists("AverageCounter64SampleCategory") )
        {

            CounterCreationDataCollection counterDataCollection = new CounterCreationDataCollection();

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

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

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

            return(true);
        }
        else
        {
            Console.WriteLine("Category exists - AverageCounter64SampleCategory");
            return(false);
        }
    }

    private static void CreateCounters()
    {
        // Create the counters.

        avgCounter64Sample = new PerformanceCounter("AverageCounter64SampleCategory",
            "AverageCounter64Sample",
            false);


        avgCounter64SampleBase = new PerformanceCounter("AverageCounter64SampleCategory",
            "AverageCounter64SampleBase",
            false);

        avgCounter64Sample.RawValue=0;
        avgCounter64SampleBase.RawValue=0;
    }
    private static void CollectSamples(ArrayList samplesList)
    {

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

        // Loop for the samples.
        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());
                samplesList.Add( avgCounter64Sample.NextSample() );
            }
            else
            {
                Console.WriteLine();
            }

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

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

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

            // Calculate the counter value manually.
            Console.WriteLine("My computed counter value = " +
                MyComputeCounterValue((CounterSample)samplesList[i],
                (CounterSample)samplesList[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 Single MyComputeCounterValue(CounterSample s0, CounterSample s1)
    {
        Single numerator = (Single)s1.RawValue - (Single)s0.RawValue;
        Single denomenator = (Single)s1.BaseValue - (Single)s0.BaseValue;
        Single counterValue = numerator / denomenator;
        return(counterValue);
    }

    // Output information about the counter sample.
    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("++++++++++++++++++++++");
    }
}

Imports System.Collections
Imports System.Collections.Specialized
Imports System.Diagnostics

 _

Public Class App

    Private Shared avgCounter64Sample As PerformanceCounter
    Private Shared avgCounter64SampleBase As PerformanceCounter


    Public Shared Sub Main()

        Dim samplesList As New ArrayList()
        '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 counters.
        If Not (SetupCategory()) Then
            CreateCounters()
            CollectSamples(samplesList)
            CalculateResults(samplesList)
        End If

    End Sub

    Private Shared Function SetupCategory() As Boolean
        If Not PerformanceCounterCategory.Exists("AverageCounter64SampleCategory") Then

            Dim counterDataCollection As New CounterCreationDataCollection()

            ' Add the counter.
            Dim averageCount64 As New CounterCreationData()
            averageCount64.CounterType = PerformanceCounterType.AverageCount64
            averageCount64.CounterName = "AverageCounter64Sample"
            counterDataCollection.Add(averageCount64)

            ' Add the base counter.
            Dim averageCount64Base As New CounterCreationData()
            averageCount64Base.CounterType = PerformanceCounterType.AverageBase
            averageCount64Base.CounterName = "AverageCounter64SampleBase"
            counterDataCollection.Add(averageCount64Base)

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

            Return True
        Else
            Console.WriteLine("Category exists - AverageCounter64SampleCategory")
            Return False
        End If
    End Function 'SetupCategory

    Private Shared Sub CreateCounters()
        ' Create the counters.

        avgCounter64Sample = New PerformanceCounter("AverageCounter64SampleCategory", "AverageCounter64Sample", False)

        avgCounter64SampleBase = New PerformanceCounter("AverageCounter64SampleCategory", "AverageCounter64SampleBase", False)

        avgCounter64Sample.RawValue = 0
        avgCounter64SampleBase.RawValue = 0
    End Sub

    Private Shared Sub CollectSamples(ByVal samplesList As ArrayList)

        Dim r As New Random(DateTime.Now.Millisecond)

        ' Loop for the samples.
        Dim j As Integer
        For j = 0 To 99

            Dim value As Integer = r.Next(1, 10)
            Console.Write(j.ToString() + " = " + value.ToString())

            avgCounter64Sample.IncrementBy(value)

            avgCounter64SampleBase.Increment()

            If j Mod 10 = 9 Then
                OutputSample(avgCounter64Sample.NextSample())
                samplesList.Add(avgCounter64Sample.NextSample())
            Else
                Console.WriteLine()
            End If
            System.Threading.Thread.Sleep(50)
        Next j
    End Sub

    Private Shared Sub CalculateResults(ByVal samplesList As ArrayList)
        Dim i As Integer
        For i = 0 To (samplesList.Count - 1) - 1
            ' Output the sample.
            OutputSample(CType(samplesList(i), CounterSample))
            OutputSample(CType(samplesList((i + 1)), CounterSample))

            ' Use .NET to calculate the counter value.
            Console.WriteLine(".NET computed counter value = " + CounterSampleCalculator.ComputeCounterValue(CType(samplesList(i), CounterSample), CType(samplesList((i + 1)), CounterSample)).ToString())

            ' Calculate the counter value manually.
            Console.WriteLine("My computed counter value = " + MyComputeCounterValue(CType(samplesList(i), CounterSample), CType(samplesList((i + 1)), CounterSample)).ToString())
        Next i
    End Sub

    '++++++++//++++++++//++++++++//++++++++//++++++++//++++++++//++++++++//++++++++
    '	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 Shared Function MyComputeCounterValue(ByVal s0 As CounterSample, ByVal s1 As CounterSample) As [Single]
        Dim numerator As [Single] = CType(s1.RawValue, [Single]) - CType(s0.RawValue, [Single])
        Dim denomenator As [Single] = CType(s1.BaseValue, [Single]) - CType(s0.BaseValue, [Single])
        Dim counterValue As [Single] = numerator / denomenator
        Return counterValue
    End Function 'MyComputeCounterValue

    ' Output information about the counter sample.
    Private Shared Sub OutputSample(ByVal s As CounterSample)
        Console.WriteLine(ControlChars.Lf + ControlChars.Cr + "+++++++++++")
        Console.WriteLine("Sample values - " + ControlChars.Lf + ControlChars.Cr)
        Console.WriteLine(("   BaseValue        = " + s.BaseValue.ToString()))
        Console.WriteLine(("   CounterFrequency = " + s.CounterFrequency.ToString()))
        Console.WriteLine(("   CounterTimeStamp = " + s.CounterTimeStamp.ToString()))
        Console.WriteLine(("   CounterType      = " + s.CounterType.ToString()))
        Console.WriteLine(("   RawValue         = " + s.RawValue.ToString()))
        Console.WriteLine(("   SystemFrequency  = " + s.SystemFrequency.ToString()))
        Console.WriteLine(("   TimeStamp        = " + s.TimeStamp.ToString()))
        Console.WriteLine(("   TimeStamp100nSec = " + s.TimeStamp100nSec.ToString()))
        Console.WriteLine("++++++++++++++++++++++")
    End Sub
End Class

Uwagi

Składnik PerformanceCounter może służyć zarówno do odczytywania istniejących wstępnie zdefiniowanych lub niestandardowych liczników, jak i publikowania (zapisu) danych wydajności do liczników niestandardowych.

Istnieje wiele wstępnie zdefiniowanych liczników wymienionych w oknie dialogowym Dodawanie liczników monitora wydajności systemu Windows. Aby dowiedzieć się więcej na temat liczników wydajności programu .NET Framework, zobacz Liczniki wydajności.

Ten typ implementuje interfejs IDisposable. Po zakończeniu korzystania z typu danych, należy go usunąć w sposób bezpośredni lub pośredni. Aby usunąć typ bezpośrednio, wywołaj metodę Dispose w bloku try/catch. Aby usunąć go pośrednio, należy użyć konstrukcji języka, takiej jak using (w języku C#) lub Using (w Visual Basic). Aby uzyskać więcej informacji, zobacz sekcję "Używanie obiektu implementującego IDisposable" (Using an Object that Implements IDisposable) w temacie interfejsu IDisposable.

Ważna

W wersjach 1.0 i 1.1 programu .NET Framework ta klasa wymaga, aby wywołania natychmiastowe byłyby w pełni zaufane. Począwszy od programu .NET Framework w wersji 2.0, ta klasa wymaga PerformanceCounterPermission określonych akcji. Zdecydowanie zaleca się, aby PerformanceCounterPermission nie udzielać kodu częściowo zaufanego. Możliwość odczytywania i zapisywania liczników wydajności umożliwia kodowi wykonywanie akcji, takich jak wyliczanie wykonywanych procesów i uzyskiwanie informacji o nich.

Ponadto przekazanie obiektu do mniej zaufanego PerformanceCounter kodu może spowodować problem z zabezpieczeniami. Nigdy nie przekazuj obiektów licznika wydajności, takich jak lub PerformanceCounterCategoryPerformanceCounter, do mniej zaufanego kodu.

Aby odczytać z licznika wydajności, utwórz wystąpienie PerformanceCounter klasy, ustaw CounterNameCategoryName, i, opcjonalnie, InstanceName właściwości lubMachineName, a następnie wywołaj NextValue metodę , aby pobrać odczyt licznika wydajności.

Aby opublikować dane licznika wydajności, utwórz co najmniej jeden licznik niestandardowy przy użyciu PerformanceCounterCategory.Create metody , utwórz wystąpienie PerformanceCounter klasy, ustaw CounterNameCategoryName, i, opcjonalnie InstanceName lub MachineName właściwości, a następnie wywołaj IncrementBymetodę , Incrementlub Decrement ustaw RawValue właściwość, aby zmienić wartość licznika niestandardowego.

Uwaga / Notatka

Metody Increment, IncrementByi Decrement używają zakleszczenia w celu zaktualizowania wartości licznika. Pomaga to zachować dokładność wartości licznika w scenariuszach wielowątków lub wieloprocesorowych, ale także powoduje karę za wydajność. Jeśli nie potrzebujesz dokładności zapewnianej przez zakleszczone operacje, możesz zaktualizować RawValue właściwość bezpośrednio do 5-krotnej poprawy wydajności. Jednak w scenariuszach wielowątkowych niektóre aktualizacje wartości licznika mogą być ignorowane, co powoduje niedokładne dane.

Licznik to mechanizm, za pomocą którego są zbierane dane dotyczące wydajności. Rejestr przechowuje nazwy wszystkich liczników, z których każdy jest powiązany z określonym obszarem funkcjonalności systemu. Przykłady obejmują zajęty czas procesora, użycie pamięci lub liczbę bajtów odebranych za pośrednictwem połączenia sieciowego.

Każdy licznik jest jednoznacznie identyfikowany za pomocą jego nazwy i jego lokalizacji. W ten sam sposób, w jaki ścieżka pliku zawiera dysk, katalog, co najmniej jeden podkatalog i nazwę pliku, informacje licznika składają się z czterech elementów: komputera, kategorii, wystąpienia kategorii i nazwy licznika.

Informacje licznika muszą zawierać kategorię lub obiekt wydajności, dla którego licznik mierzy dane. Kategorie komputera obejmują składniki fizyczne, takie jak procesory, dyski i pamięć. Istnieją również kategorie systemowe, takie jak procesy i wątki. Każda kategoria jest powiązana z elementem funkcjonalnym na komputerze i ma przypisany zestaw standardowych liczników. Te obiekty są wyświetlane na liście rozwijanej Obiekt wydajności okna dialogowego Dodawanie liczników w monitorze systemu Windows 2000 i należy je uwzględnić w ścieżce licznika. Dane wydajności są pogrupowane według kategorii, do której są powiązane.

W niektórych przypadkach może istnieć kilka kopii tej samej kategorii. Na przykład kilka procesów i wątków jest uruchamianych jednocześnie, a niektóre komputery zawierają więcej niż jeden procesor. Kopie kategorii są nazywane wystąpieniami kategorii, a każde wystąpienie ma przypisany zestaw standardowych liczników. Jeśli kategoria może zawierać więcej niż jedno wystąpienie, specyfikacja wystąpienia musi być uwzględniona w informacjach licznika.

Aby uzyskać dane dotyczące wydajności liczników, które wymagały początkowej lub poprzedniej wartości do wykonania niezbędnych obliczeń, wywołaj NextValue metodę dwukrotnie i użyj informacji zwracanych zgodnie z wymaganiami aplikacji.

Uwaga / Notatka

Kategorie liczników wydajności zainstalowane na platformie .NET używają oddzielnej pamięci udostępnionej, a każda kategoria licznika wydajności ma własną pamięć. Rozmiar oddzielnej pamięci udostępnionej można określić, tworząc DWORD o nazwie FileMappingSize w kluczu rejestru HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\<nazwę> kategorii\Wydajność. Wartość FileMappingSize jest ustawiona na rozmiar pamięci udostępnionej kategorii. Domyślny rozmiar to 131072 dziesiętny. Jeśli wartość FileMappingSize nie jest obecna, fileMappingSize zostanie użyta wartość atrybutu elementu określonego performanceCounters w pliku Machine.config, co powoduje dodatkowe obciążenie związane z przetwarzaniem plików konfiguracji. Możesz zrealizować poprawę wydajności uruchamiania aplikacji, ustawiając rozmiar mapowania plików w rejestrze. Aby uzyskać więcej informacji na temat rozmiaru mapowania plików, zobacz <performanceCounters>.

Konstruktory

Nazwa	Opis
PerformanceCounter()	Inicjuje nowe wystąpienie PerformanceCounter klasy tylko do odczytu bez kojarzenia wystąpienia z dowolnym systemem lub niestandardowym licznikiem wydajności.
PerformanceCounter(String, String, Boolean)	Inicjuje nowe, tylko do odczytu lub zapisu wystąpienie PerformanceCounter klasy i kojarzy je z określonym systemem lub niestandardowym licznikiem wydajności na komputerze lokalnym. Ten konstruktor wymaga, aby kategoria zawierała pojedyncze wystąpienie.
PerformanceCounter(String, String, String, Boolean)	Inicjuje nowe, tylko do odczytu lub odczytu/zapisu wystąpienie PerformanceCounter klasy i kojarzy je z określonym systemem lub niestandardowym licznikiem wydajności i wystąpieniem kategorii na komputerze lokalnym.
PerformanceCounter(String, String, String, String)	Inicjuje nowe wystąpienie PerformanceCounter klasy tylko do odczytu i kojarzy je z określonym systemem lub niestandardowym licznikiem wydajności i wystąpieniem kategorii na określonym komputerze.
PerformanceCounter(String, String, String)	Inicjuje nowe, tylko do odczytu wystąpienie PerformanceCounter klasy i kojarzy je z określonym systemem lub niestandardowym licznikiem wydajności i wystąpieniem kategorii na komputerze lokalnym.
PerformanceCounter(String, String)	Inicjuje nowe, tylko do odczytu wystąpienie PerformanceCounter klasy i kojarzy je z określonym systemem lub niestandardowym licznikiem wydajności na komputerze lokalnym. Ten konstruktor wymaga, aby kategoria miała pojedyncze wystąpienie.

Pola

Nazwa	Opis
DefaultFileMappingSize	Przestarzałe. Określa rozmiar w bajtach globalnej pamięci współużytkowanej przez liczniki wydajności. Domyślny rozmiar to 524 288 bajtów.

Właściwości

Nazwa	Opis
CategoryName	Pobiera lub ustawia nazwę kategorii licznika wydajności dla tego licznika wydajności.
CounterHelp	Pobiera opis tego licznika wydajności.
CounterName	Pobiera lub ustawia nazwę licznika wydajności skojarzonego z tym PerformanceCounter wystąpieniem.
CounterType	Pobiera typ licznika skojarzonego licznika wydajności.
InstanceLifetime	Pobiera lub ustawia okres istnienia procesu.
InstanceName	Pobiera lub ustawia nazwę wystąpienia dla tego licznika wydajności.
MachineName	Pobiera lub ustawia nazwę komputera dla tego licznika wydajności.
RawValue	Pobiera lub ustawia nieprzetworzone lub nieliczane wartości tego licznika.
ReadOnly	Pobiera lub ustawia wartość wskazującą, czy to PerformanceCounter wystąpienie jest w trybie tylko do odczytu.

Metody

Nazwa	Opis
BeginInit()	Rozpoczyna inicjowanie wystąpienia używanego PerformanceCounter w formularzu lub przez inny składnik. Inicjowanie odbywa się w czasie wykonywania.
Close()	Zamyka licznik wydajności i zwalnia wszystkie zasoby przydzielone przez to wystąpienie licznika wydajności.
CloseSharedResources()	Zwalnia udostępniony stan biblioteki liczników wydajności przydzielony przez liczniki.
Decrement()	Dekrementuje skojarzony licznik wydajności o jeden przez wydajną operację niepodzieną.
EndInit()	Kończy inicjowanie PerformanceCounter wystąpienia używanego w formularzu lub przez inny składnik. Inicjowanie odbywa się w czasie wykonywania.
Increment()	Zwiększa skojarzony licznik wydajności o jeden przez wydajną operację niepodzieną.
IncrementBy(Int64)	Zwiększa lub dekrementuje wartość skojarzonego licznika wydajności o określoną kwotę za pomocą wydajnej operacji niepodzielnej.
NextSample()	Uzyskuje próbkę licznika i zwraca dla niej wartość nieprzetworzona lub nieliczona.
NextValue()	Uzyskuje próbkę licznika i zwraca dla niej wartość obliczeniową.
RemoveInstance()	Usuwa wystąpienie kategorii określone przez PerformanceCounter właściwość obiektu InstanceName .

Zobacz też

• PerformanceCounterType
• CounterCreationData
• CounterCreationDataCollection
• CounterSample
• CounterSampleCalculator