counterSet Complex Type

Definiert eine Liste von Leistungsindikatoren, die logisch verknüpft sind.

<xs:complexType name="counterSet">
    <xs:sequence>
        <xs:element name="structs"
            type="man:structs"
            minOccurs="0"
            maxOccurs="1"
         />
        <xs:element name="counter"
            type="man:counter"
            minOccurs="1"
            maxOccurs="unbounded"
         />
    </xs:sequence>
    <xs:attribute name="symbol"
        type="man:CSymbolType"
        use="required"
     />
    <xs:attribute name="guid"
        type="man:GUIDType"
        use="required"
     />
    <xs:attribute name="uri"
        type="xs:anyURI"
        use="required"
     />
    <xs:attribute name="name"
        use="required"
    >
        <xs:simpleType>
            <xs:restriction
                base="xs:string"
            >
                <xs:maxLength
                    value="1023"
                 />
            </xs:restriction>
        </xs:simpleType>
    </xs:attribute>
    <xs:attribute name="description"
        type="xs:string"
        use="required"
     />
    <xs:attribute name="instances"
        use="optional"
        default="single"
    >
        <xs:simpleType>
            <xs:restriction
                base="xs:string"
            >
                <xs:enumeration
                    value="single"
                 />
                <xs:enumeration
                    value="multiple"
                 />
                <xs:enumeration
                    value="globalAggregate"
                 />
                <xs:enumeration
                    value="multipleAggregate"
                 />
                <xs:enumeration
                    value="globalAggregateHistory"
                 />
            </xs:restriction>
        </xs:simpleType>
    </xs:attribute>
</xs:complexType>

Untergeordnete Elemente

Element type Beschreibung
Zähler man:counter Definiert einen Zähler, den der Anbieter bietet.
Strukturen man:structs Eine Liste von Strukturelementen, die Werte für die in diesem Indikatorsatz definierten Leistungsindikatoren enthalten.

Attributes

Name type BESCHREIBUNG
description xs:string Eine kurze Beschreibung des Indikatorsets.
guid man:GUIDType Eine GUID, die den Indikatorsatz eindeutig identifiziert. Die Registrierung des Indikatorsets schlägt fehl, wenn die GUID bereits registriert ist. Um einen registrierten Indikatorsatz zu aktualisieren, müssen Sie zuerst den Indikatorsatz deinstallieren und dann erneut registrieren.
instances Bestimmt, ob der Indikatorsatz mehrere Instanzen enthalten kann. Im Folgenden werden die möglichen Werte aufgeführt:
Einzelnen
Definiert einen Indikatorsatz, in dem nur eine Instanz der Leistungsindikatoren im Indikatorsatz vorhanden sein kann. Geben Sie diesen Wert an, wenn die Leistungsindikatoren systemweite Messungen bereitstellen, z. B. physischer Speicher. Dies ist die Standardoption.
Mehrere
Definiert einen Indikatorsatz, in dem mehrere Instanzen der Leistungsindikatoren im Indikatorsatz vorhanden sein können. Geben Sie diesen Wert an, wenn die Leistungsindikatoren instanzspezifische Messungen bereitstellen, z. B. Prozessorzeit pro Prozess.
globalAggregate
Definiert einen einzelnen Instanzzählersatz, in dem die Leistungsindikatoren im Indikatorsatz aus verschiedenen aktiven Quellen aggregiert werden müssen. Beispielsweise können Sie einen Leistungsindikatorsatz erstellen, der einen Zähler enthält, der die Anzahl der Datenträgerlesedaten für eine Festplatte zählt. Wenn der Computer über drei Festplatten verfügt und ein Consumer die Anzahl der Datenträgerlesedaten abfragt, erhält PERFLIB die Anzahl der Lese- und Summenwerte von jedem Datenträger.
multipleAggregate
Definiert einen Zählersatz mit mehreren Instanzen, bei dem die Leistungsindikatoren im Leistungsindikatorsatz für alle Instanzen dieses Indikators aggregiert werden müssen. Beispielsweise können Sie einen Indikatorsatz für eine Multithreadanwendung erstellen, die einen Zähler enthält, der die Threadleistung misst (jeder Thread würde auf eine Instanz des Indikatorsets verweisen). Wenn ein Consumer den Gesamtzähler für die Threadausführungszeit abfragt, summiert PERFLIB die gesamte Threadausführungszeit jeder Instanz.
globalAggregateHistory
Definiert einen einzelnen Instanzzählersatz, dessen Zählerwerte für die Lebensdauer des Consumers zwischengespeichert werden. Beachten Sie, dass alle Leistungsindikatoren im Indikatorsatz zwischengespeichert werden. Um nur bestimmte Leistungsindikatoren zwischenspeichern zu können, sollten Sie diese Leistungsindikatoren mit dem Verlaufsattribut auskennen.
Mithilfe des Beispiels zum Lesen des Datenträgers aus globalAggregate werden alle Indikatorwerte im Indikatorsatz zwischengespeichert. Wenn ein Datenträger nicht mehr verfügbar ist, ist der zuletzt zwischengespeicherte Wert für die gesamtzahl der von diesem Datenträger gelesenen Bytes weiterhin für die Consumeranwendung verfügbar.
name Der Anzeigename des Indikatorsets. Muss kleiner als 1.024 Zeichen sein. Beim Namen wird die Groß- und Kleinschreibung berücksichtigt.
Symbol man:CSymbolType Ein symbolischer Name, der den Indikatorsatz identifiziert. Das CTRPP-Tool erstellt eine GUID-Variable, die Sie beim Aufrufen von Funktionen verwenden können, die die Indikatorsatz-GUID erfordern (z. B. PerfCreateInstance). Der Variablenname hat das Formular Symbolischer Name GUID.
Wenn Sie das Argument -prefix beim Aufrufen von STRPPangeben, wird die Präfixzeichenfolge am Anfang des symbolischen Namens hinzugefügt.
uri xs:anyURI Ein eindeutiger einheitlicher Ressourcenbezeichner, mit dem Benutzer von einem beliebigen Ort aus auf die Leistungsindikatoren im Indikatorsatz zugreifen können.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows Nur [ Vista-Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows Nur Server [ 2008-Desktop-Apps]