counterSet Complex Type

Definiert eine Liste von Indikatoren, die logisch miteinander 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 bereitstellt.
Strukturen	man:structs	Eine Liste von Strukturelementen, die Werte für die in diesem Leistungsindikatorsatz definierten Indikatoren enthalten.

Attributes

Name	type	BESCHREIBUNG
description	xs:string	Eine kurze Beschreibung des Zählersatzes.
guid	man:GUIDType	Eine GUID, die den Zählersatz eindeutig identifiziert. Die Registrierung des Zählersatzes schlägt fehl, wenn die GUID bereits registriert ist. Um einen registrierten Zählersatz zu aktualisieren, müssen Sie zuerst den Zählersatz deinstallieren und dann erneut registrieren.
instances		Bestimmt, ob der Leistungsindikatorsatz mehrere Instanzen enthalten kann. Im Folgenden werden die möglichen Werte aufgelistet: Einzelnen Definiert einen Zählersatz, in dem nur ein instance der Leistungsindikatoren im Zählersatz vorhanden sein kann. Geben Sie diesen Wert an, wenn die Indikatoren systemweite Messungen bereitstellen, z. B. physischer Arbeitsspeicher. Dies ist die Standardeinstellung. Mehrere Definiert einen Leistungsindikatorsatz, in dem mehrere Instanzen der Leistungsindikatoren im Leistungsindikatorsatz vorhanden sein können. Geben Sie diesen Wert an, wenn die Indikatoren instance Messungen bereitstellen, z. B. Prozessorzeit pro Prozess. globalAggregate Definiert einen einzelnen instance Zählersatz, in dem die Leistungsindikatoren im Zählersatz aus verschiedenen aktiven Quellen aggregiert werden müssen. Sie können beispielsweise einen Leistungsindikatorsatz erstellen, der einen Zähler enthält, der die Anzahl der Lesevorgänge für datenträger für eine Festplatte zählt. Wenn der Computer über drei Festplatten verfügt und ein Consumer die Anzahl der Datenträgerlesevorgänge abfragt, ruft PERFLIB die Anzahl der Lesevorgänge von jedem Datenträger ab und summiert die einzelnen Werte. multipleAggregate Definiert einen Zählersatz mit mehreren instance, in dem die Leistungsindikatoren im Zählersatz für alle Instanzen dieses Zählers aggregiert werden müssen. Sie könnten beispielsweise einen Leistungsindikatorsatz für eine Multithreadanwendung erstellen, die einen Zähler enthält, der die Threadleistung misst (jeder Thread würde auf eine instance des Indikatorsatzes verweisen). Wenn ein Consumer den Gesamtindikator für die Threadausführungszeit abfragt, summiert PERFLIB die gesamte Threadausführungszeit der einzelnen instance. globalAggregateHistory Definiert einen einzelnen instance Zählersatz, dessen Zählerwerte für die Lebensdauer des Consumers zwischengespeichert werden. Beachten Sie, dass alle Leistungsindikatoren im Leistungsindikatorsatz zwischengespeichert werden. Um nur bestimmte Leistungsindikatoren zwischenzuspeichern, schmücken Sie diese Leistungsindikatoren mit dem Verlaufsattribut. Mithilfe des Datenträgerlesebeispiels aus globalAggregate würden alle Zählerwerte im Indikatorsatz zwischengespeichert. Wenn ein Datenträger nicht verfügbar wäre, wäre der letzte zwischengespeicherte Wert für die Gesamtanzahl der von diesem Datenträger gelesenen Bytes weiterhin für die Consumeranwendung verfügbar.
name		Der Anzeigename des Zählersatzes. Muss kleiner als 1.024 Zeichen sein. Beim Namen wird die Groß- und Kleinschreibung berücksichtigt.
Symbol	man:CSymbolType	Ein symbolischer Name, der den Zählersatz identifiziert. Das CTRPP-Tool erstellt eine GUID-Variable, die Sie verwenden können, wenn Sie Funktionen aufrufen, die die Zählersatz-GUID erfordern (z. B. PerfCreateInstance). Der Variablename hat das Format symbolnameGuid. Wenn Sie beim Aufrufen von CTRPP das Argument -prefix einschließen, wird die Präfixzeichenfolge am Anfang des symbolischen Namens hinzugefügt.
uri	xs:anyURI	Ein eindeutiger einheitlicher Ressourcenbezeichner, mit dem Benutzer von einem beliebigen Speicherort aus auf die Leistungsindikatoren im Leistungsindikatorsatz zugreifen können.

Anforderungen

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