Angeben eines Indikatorpfads

Das System verwendet Leistungsindikatoren, um Leistungsdaten zu sammeln. Jeder Leistungsindikator wird durch seinen Namen und seinen Pfad oder Speicherort eindeutig identifiziert. Die Syntax eines Indikatorpfads lautet:

\\Computer\PerfObject(ParentInstance/ObjectInstance#InstanceIndex)\Counter

Das Computer-Element gibt den Namen oder die IP-Adresse des Computers an, von dem Sie Leistungsdaten abfragen möchten. Der Computername ist optional, wenn sich der Zähler auf dem lokalen Computer befindet.

Das PerfObject-Element gibt das abzufragende Leistungsobjekt an. Ein Leistungsobjekt kann eine physische Komponente wie Prozessoren, Datenträger und Arbeitsspeicher oder ein Systemobjekt wie Prozesse und Threads sein. Jedes Systemobjekt ist mit einem funktionalen Element innerhalb des Computers verknüpft und verfügt über eine Reihe von Standardindikatoren, die ihm zugewiesen sind. Auf jedem Computer ist möglicherweise ein anderer Satz von Leistungsobjekten und Leistungsindikatoren installiert, da Anwendungen eigene Leistungsobjekte und Leistungsindikatoren installieren können. Eine Liste der auf Ihrem Computer installierten Leistungsobjekte und Leistungsindikatoren finden Sie im Dialogfeld Leistungsindikatoren hinzufügen im Leistungstool auf Ihrem Computer. Diese Objekte werden auch im Dialogfeld PDH-Durchsuchen aufgeführt (siehe Browserindikatoren). Eine Liste der Systemleistungsobjekte und Leistungsindikatoren finden Sie unter Leistungsindikatoren nach Objekt.

ParentInstance, ObjectInstance und InstanceIndex sind im Pfad enthalten, wenn mehrere Instanzen des Objekts vorhanden sein können. Prozesse und Threads sind beispielsweise mehrere instance-Objekte, da mehrere Prozesse oder Threads gleichzeitig ausgeführt werden können. Wenn ein Objekt mehrere instance haben kann, muss der Zählerpfad ein Objekt instance angeben.

Das Format der instance verwandten Elementen hängt vom Objekttyp ab. Wenn das Objekt über einfache Instanzen verfügt, ist das Format nur der in Klammern eingeschlossene instance Name. Beispiel:

(Explorer)

Wenn die instance dieses Objekts auch einen übergeordneten instance Namen erfordert, muss der übergeordnete instance Name vor dem objekt instance und durch einen schrägen Schrägstrich getrennt sein. Beispielsweise gehören Threads zu Prozessen. Wenn Sie ein Threadobjekt abfragen, müssen Sie auch den Prozess angeben, zu dem es gehört, wie im folgenden Beispiel gezeigt:

(Explorer/0)

Wenn das Objekt über mehrere Instanzen mit der gleichen Namenszeichenfolge verfügt, können sie sequenziell indiziert werden, indem der instance Index angegeben wird, dem ein Pfundzeichen vorangestellt ist. Instanzindizes sind 0-basiert. Wenn Sie die erste instance abfragen möchten, schließen Sie #0 nicht ein, geben Sie einfach den namen der instance an. Um die zweite instance anzugeben, verwenden Sie #1, um die dritte instance anzugeben, #2 usw. Beispiel:

(Explorer/0#1)

Das Counter-Element gibt den Leistungsindikator an, den Sie für das angegebene Leistungsobjekt abfragen möchten.

PDH verwendet die folgenden Sonderzeichen in einem Zählerpfad. Anbieter sollten diese Zeichen nicht in ihren Namen verwenden. Wenn ein Anbieter diese Sonderzeichen verwendet, kann PDH den vollständigen Zählerpfad nicht analysieren, um die Namen des Indikators und der Instanzen abzurufen.

Zeichen	Beschreibung
\	Generisches Trennzeichen für Computer, Objekt und Zähler.
(	Anfang des instance Namens.
)	Ende von instance Namen.
/	Trennt instance und übergeordnete instance.
#n	Identifiziert ein bestimmtes Vorkommen eines gleichnamigen instance.
*	Platzhalterzeichen.

 

Die folgenden Beispiele zeigen die möglichen Formate für Zählerpfade:

• \\computer\object(parent/instance#index)\counter
• \\computer\object(parent/instance)\counter
• \\computer\object(instance#index)\counter
• \\computer\object(instance)\counter
• \\computer\object\counter
• \object(parent/instance#index)\counter
• \object(parent/instance)\counter
• \object(instance#index)\counter
• \object(instance)\counter
• \object\counter

Verwenden von Wildcardzeichen

Indikatorpfade dürfen nur ein Wildcardzeichen für den namen des instance enthalten, wie im folgenden Beispiel gezeigt.

\Process(*)\% Processor Time

Rufen Sie PdhExpandWildCardPath auf, um den Wildcard in eine Liste von Indikatorenpfaden zu erweitern, die Instanzen enthalten, die auf dem Computer oder in der Protokolldatei gefunden wurden.