Gewusst wie: Abrufen von Leistungsindikatorstichproben

Aktualisiert: November 2007

Mit der CounterSample-Klasse erstellen Sie Stichproben und führen Berechnungen zu deren Inhalt aus. Eine Stichprobenklasse führt ein "Sampling" eines Leistungsindikators auf der Grundlage der von Ihnen definierten Kriterien durch. Zu diesen Kriterien gehören die Werte von einem oder mehreren Leistungsindikatoren und die Häufigkeit, mit der die Werte ermittelt werden sollen. Darüber hinaus zeichnet die Klasse den Zeitpunkt auf, zu dem die Stichproben entnommen wurden. Sie können alle Daten in einer einzelnen instanziierten Klasse zusammenstellen und anschließend mit der Calculate-Methode eine Berechnung durchführen. Mit der Calculate-Methode können Sie auch eine Berechnung durchführen, bei der die Werte zweier unterschiedlicher Stichproben verglichen werden.

Die durchgeführte Berechnung richtet sich nach dem Leistungsindikatortyp. Bestimmten Leistungsindikatortypen ist eine spezielle Berechnung zugeordnet. Bei Leistungsindikatoren des Typs ElapsedTime wird z. B. die Zeitangabe zweier Stichproben verglichen und ermittelt, wie viel Zeit dazwischen verstrichen ist. Viele Leistungsindikatoren errechnen den Durchschnitt aus den abgerufenen Daten.

Zum Definieren einer Stichprobe führen Sie folgende Schritte aus:

• Erstellen Sie eine oder mehrere Instanzen der CounterSample-Klasse.

• Rufen Sie für jede Instanz eine aktuelle Stichprobe ab.

• Rufen Sie die Calculate-Methode auf, und übergeben Sie dabei jede Stichprobe so, dass sie als Parameter in die Berechnung eingeschlossen wird.

So rufen Sie Leistungsindikatorstichproben ab und führen eine Berechnung durch

1. Erstellen Sie eine PerformanceCounter-Instanz, und konfigurieren Sie sie für die Interaktion mit der gewünschten Kategorie und dem gewünschten Leistungsindikator. Weitere Informationen finden Sie unter Gewusst wie: Erstellen von Instanzen von PerformanceCounter-Komponenten oder unter Gewusst wie: Konfigurieren von Instanzen von PerformanceCounter-Komponenten.

2. Erstellen Sie eine Instanz der CounterSample-Klasse für die Ergebnisse des Samplings.

3. Rufen Sie die NextSample-Methode in der PerformanceCounter-Komponenteninstanz auf, um den berechneten Wert abzurufen, und weisen Sie das Ergebnis der CounterSample-Klasse zu.

   Tipp:
   Für eine Berechnung müssen zwei Stichproben abgerufen werden.

4. Erstellen Sie eine Variable, in die das Ergebnis der Berechnung eingetragen wird, und weisen Sie ihr den Datentyp Single zu.

5. Weisen Sie für beide für die Berechnung erforderlichen Stichproben einer Variable des Typs CounterSample einen NextSample-Rückgabewert zu.

6. Rufen Sie die Calculate-Methode in der CounterSample-Klasse auf, und führen Sie einen der folgenden Schritte aus:

   • Wenn Sie zwei Stichproben abgerufen haben, die als CounterSample-Objekte gespeichert werden, übergeben Sie beide als Parameter an die Calculate-Methode.

   • Wenn Sie nur eine Stichprobe abgerufen haben, übergeben Sie diese an die Calculate-Methode und rufen dann mit dem zweiten Parameter eine weitere Stichprobe ab.

7. Setzen Sie das Berechnungsergebnis der Variablen gleich, die für das Ergebnis erstellt wurde.

   Hinweis:
   Die beiden Stichproben müssen aus Leistungsindikatoren desselben Typs stammen, sonst löst die Methode eine Ausnahme aus. Die durchgeführte Berechnung richtet sich nach dem Leistungsindikatortyp. Weitere Informationen hierzu finden Sie unter Leistungsindikatortypen.

   Der folgende Code zeigt das Abrufen und Vergleichen zweier Stichproben mit der Calculate-Methode:

   ' Dim variables of types CounterSample for each sample and a 
   ' variable of type single for the results.
   Dim sample1 As CounterSample
   Dim sample2 As CounterSample
   Dim result As Single
   ' Retrieve a sample.
   sample1 = PerformanceCounter1.NextSample()
   ' Wait some interval of time here and retrieve
   ' a second sample.
   System.Threading.Thread.Sleep(1000)
   sample2 = PerformanceCounter1.NextSample()
   ' Pass both samples to the Calculate method.
   result = CounterSample.Calculate(sample1, sample2)
   

        System.Diagnostics.CounterSample sample1;
           System.Diagnostics.CounterSample sample2;
           float result;
           // Retrieve a sample.
           sample1 = PerformanceCounter1.NextSample();
           // Wait some interval of time here and retrieve
           // a second sample.
           System.Threading.Thread.Sleep(1000);
           sample2 = PerformanceCounter1.NextSample();
           // Pass both samples to the Calculate method.
           result = System.Diagnostics.CounterSample.Calculate(sample1, sample2);
   

   Stattdessen können Sie auch die NextSample-Methode aufrufen, um die Werte der zweiten Stichprobe zu ermitteln. Dies wird anhand des folgenden Beispiels veranschaulicht:

   Dim sample1 As CounterSample
   Dim result As Single
   ' Retrieve a single sample.
   sample1 = PerformanceCounter1.NextSample()
   ' Pass the retrieved sample to the calculate method
   ' and retrieve another sample in the second parameter.
   result = CounterSample.Calculate(sample1, PerformanceCounter1.NextSample())
   

        System.Diagnostics.CounterSample sample1;
           float result;
           // Retrieve a single sample.
           sample1 = PerformanceCounter1.NextSample();
           // Pass the retrieved sample to the calculate method
           // and retrieve another sample in the second parameter.
           result = System.Diagnostics.CounterSample.Calculate(sample1, PerformanceCounter1.NextSample());
   

Siehe auch

Aufgaben

Gewusst wie: Abrufen der Rohdatenwerte von Leistungsindikatoren

Gewusst wie: Abrufen berechneter Leistungsindikatorwerte

Gewusst wie: Abrufen von Indikator- und Kategorielisten

Konzepte

Abrufen von Leistungsindikatorwerten