SO WIRD'S GEMACHT: Erstellen benutzerdefinierter Leistungsindikatoren

Dieser Dokumentation für die Vorschau nur ist und in späteren Versionen geändert. Leere Themen wurden als Platzhalter eingefügt.]

Wenn Sie einen neuen Indikator erstellen, erstellen Sie zuerst eine Kategorie, und geben Sie dann eine oder mehrere zu einbezogen werden Leistungsindikatoren aus. Dazu können Sie auf eine der folgenden Arten:

• Server-Explorer können Sie einen oder mehrere Leistungsindikatoren zur Entwurfszeit zu erstellen.

• Verwenden Sie die CounterCreationData -Klasse erstellen einen oder mehrere Leistungsindikatoren programmgesteuert, dann zu einer Auflistung von Typ CounterCreationDataCollection hinzufügen und die Auflistung als Parameter einer Sonderform der Create-Methode übergeben.

• Create -Methode können der Klasse PerformanceCounterCategory Sie einen einzelnen Leistungsindikator in eine neue Kategorie erstellen. Weitere Informationen finden Sie unter SO WIRD'S GEMACHT: Erstellen von Leistungsindikatorkategorien.

Es gibt zwei spezielle Probleme, die Sie beim Erstellen von Leistungsindikatoren und Kategorien berücksichtigen sollten. Sie können nicht zuerst benutzerdefinierte Kategorien und Leistungsindikatoren auf Remotecomputern erstellen. Zweitens ist die Interaktion mit benutzerdefinierten Leistungsindikatoren und Kategorien auf Nur-Lese-Modus beschränkt, es sei denn, dies wird ausdrücklich anders angegeben. Im Nur-Lese-Modus können nicht inkrementieren oder dekrementieren oder den Rohwert oder andere Werte darin festlegen. ReadOnly-Eigenschaft können Sie einen benutzerdefinierten Leistungsindikator in den schreibbaren Modus überführen.

Es ist wichtig, den Unterschied zwischen dem Erstellen eines Leistungsindikators und dem Erstellen einer Instanz der Komponente PerformanceCounter. Wenn Sie einen Leistungsindikator erstellen, erstellen eine neue Kategorie mit den zugehörigen Leistungsindikatoren Sie in das Windows-Betriebssystem, anstatt eine Komponente in einem Projekt oder einer Anwendung. Wenn Sie eine Instanz der Komponente PerformanceCounter erstellen, erstellen Sie eine Komponente innerhalb des Projekts Visual Studio, die einen externen Leistungsindikator verweist.

Hinweis

Es bestehen Sicherheitsbeschränkungen, die die Möglichkeit zum Verwenden von Leistungsindikatoren auswirken.Weitere Informationen finden Sie unter Einführung in die Überwachung von Leistungsschwellenwerten.

Sicherheitshinweis
Wenn Sie einen Leistungsindikator erstellen, Beachten Sie, dass die Ressource bereits vorhanden sind möglicherweise.Ein anderer Prozess, einem bösartigen möglicherweise bereits den Ressource und haben Zugriff darauf erstellt.Wenn Sie den Leistungsindikator Daten hinzufügen, steht die Daten des anderen Prozesses zur Verfügung.

Hinweis

PerformanceCounter-Klasse wird in Microsoft Windows NT Version 4.0 nicht vollständig unterstützt.Sie können aus den Systemindikatoren lesen, jedoch kann nicht erstellen, schreiben oder Löschen von benutzerdefinierte Leistungsindikatoren.

Hinweis

Ihr Computer möglicherweise unterschiedliche Namen oder Pfade für einige der Visual Studio-Benutzer Elemente der Benutzeroberfläche in den folgenden Anweisungen angezeigt. Diese Elemente sind von der jeweiligen Visual Studio-Version und den verwendeten Einstellungen abhängig. Weitere Informationen finden Sie unter Arbeiten mit Einstellungen.

So erstellen Sie eine neue Kategorie und Leistungsindikator zur Entwurfszeit

1. Server-Explorer öffnen Sie und erweitern Sie den Knoten für den Server, den Sie anzeigen möchten.

   Hinweis

   Wenn der gewünschte Server nicht aufgeführt ist, müssen Sie es hinzufügen.Weitere Informationen finden Sie unter SO WIRD'S GEMACHT: Zugriff und Initialize Server Explorer/Database Explorer.

2. Klicken Sie mit der rechten Maustaste auf den Knoten Leistungsindikatoren und neue Kategorie erstellen wählen.

   Das Dialogfeld Performance Counter Builder mit angezeigt wird.

   Hinweis

   Die Leistungsindikatoren zugreifen möchten, müssen Sie Mitglied der Sicherheitsgruppe sein, der Zugriff auf Leistungsindikatoren (z. B. die Gruppe Systemmonitorbenutzer) hat.Darüber hinaus erhalten Sie möglicherweise Eingabeaufforderungen auf Windows Vista Wenn Sie versuchen, eine Aktion durchzuführen, die erhöhte Rechte erfordert, selbst wenn Sie unter administrative Berechtigungen ausgeführt werden.

3. Geben Sie einen Namen und eine Beschreibung für die Kategorie erstellt werden soll.

   Hinweis

   Wenn Sie den Namen einer bereits vorhandenen Kategorie angeben, wird ein Fehler ausgelöst.Zum Überschreiben einer vorhandenen Leistungsindikatorkategorie müssen Sie zuerst mithilfe der Delete-Methode die Kategorie löschen und dann eine neue Kategorie hinzufügen.

4. Folgendermaßen Sie im Rahmen Counter List Builder vor:

   1. Klicken Sie auf die Schaltfläche Neu .

   2. Geben Sie im Rahmen Leistungsindikator einen Namen für den Leistungsindikator, den Sie in der Kategorie erstellen möchten.

   3. Wählen Sie einen Typ aus der Typ Dropdown-Liste.

   4. Geben Sie eine Beschreibung für den Leistungsindikator.

5. Wiederholen Sie die Schritt 4 für jeden Leistungsindikator, den Sie in dieser Kategorie erstellen möchten.

   Tipp

   Bevor Sie das Dialogfeld zu schließen, können Sie einer der Leistungsindikatoren in der Liste Leistungsindikatoren auswählen und ihre Werte bearbeiten oder löschen Sie die Leistungsindikatoren.

   Hinweis

   Standardmäßig Leistungsindikatoren und Kategorien im Dialogfeld erstellen Lese-/ Schreibzugriff allerdings sind die Interaktion mit Ihnen über eine Instanz der Komponente PerformanceCounter wird nur-Lese-beschränkt werden, sofern Sie nichts anderes angeben.

Um eine neue Kategorie und eine Reihe von Leistungsindikatoren programmgesteuert zu erstellen

1. Eine Auflistung von CounterCreationDataCollection-Typ erstellen.

2. Erstellen Sie die Leistungsindikatoren, die Sie als Objekte vom Typ „ CounterCreationData erstellen, und legen die erforderlichen Eigenschaften möchten.

3. CounterCreationData Objekte der Auflistung hinzugefügt durch Aufrufen der Auflistung Add-Methode.

4. Rufen Sie die Create -Methode der Klasse PerformanceCounterCategory, und übergeben Sie der Auflistung zu.

   Das folgende Beispiel veranschaulicht eine Reihe von Leistungsindikatoren erstellen und diese an die Kategorie übergeben, beim Erstellen:

                               ' Create a collection of type CounterCreationDataCollection.
                               Dim CounterDatas AsNew CounterCreationDataCollection()
   ' Create the counters and set their properties.Dim cdCounter1 AsNew CounterCreationData()
   Dim cdCounter2 AsNew CounterCreationData()
   cdCounter1.CounterName = "MyCounter1"
   cdCounter1.CounterHelp = "help string"
   cdCounter1.CounterType = PerformanceCounterType.NumberOfItems64
   cdCounter2.CounterName = "MyCounter2"
   cdCounter2.CounterHelp = "help string 2"
   cdCounter2.CounterType = PerformanceCounterType.NumberOfItems64
   ' Add both counters to the collection.
   CounterDatas.Add(cdCounter1)
   CounterDatas.Add(cdCounter2)
   ' Create the category and pass the collection to it.
   PerformanceCounterCategory.Create("Multi Counter Category",
       "Category help", PerformanceCounterCategoryType.SingleInstance,
       CounterDatas)
   

                               // Create a collection of type CounterCreationDataCollection.
           System.Diagnostics.CounterCreationDataCollection CounterDatas =
              new System.Diagnostics.CounterCreationDataCollection();
           // Create the counters and set their properties.
           System.Diagnostics.CounterCreationData cdCounter1 =
              new System.Diagnostics.CounterCreationData();
           System.Diagnostics.CounterCreationData cdCounter2 =
              new System.Diagnostics.CounterCreationData();
           cdCounter1.CounterName = "Counter1";
           cdCounter1.CounterHelp = "help string1";
           cdCounter1.CounterType = System.Diagnostics.PerformanceCounterType.NumberOfItems64;
           cdCounter2.CounterName = "Counter2";
           cdCounter2.CounterHelp = "help string 2";
           cdCounter2.CounterType = System.Diagnostics.PerformanceCounterType.NumberOfItems64;
           // Add both counters to the collection.
           CounterDatas.Add(cdCounter1);
           CounterDatas.Add(cdCounter2);
           // Create the category and pass the collection to it.
           System.Diagnostics.PerformanceCounterCategory.Create(
               "Multi Counter Category", "Category help",
               PerformanceCounterCategoryType.SingleInstance, CounterDatas);
   

Siehe auch

Aufgaben

SO WIRD'S GEMACHT: Erstellen von Leistungsindikatorkategorien

Referenz

SO WIRD'S GEMACHT: Zugriff und Initialize Server Explorer/Database Explorer

Konzepte

Kategorie- und Indikatorverwaltung