tipo complesso counterSet

  • Articolo

Definisce un elenco di contatori correlati logicamente.

<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>

Elementi figlio

Elemento Tipo Descrizione
Contatore man:counter Definisce un contatore fornito dal provider.
Strutture man:structs Elenco di elementi struct che contengono valori per i contatori definiti in questo set di contatori.

Attributi

Nome Tipo Descrizione
description xs:string Breve descrizione del set di contatori.
guid man:GUIDType GUID che identifica in modo univoco il set di contatori. La registrazione del set di contatori ha esito negativo se il GUID è già registrato. Per aggiornare un set di contatori registrato, è prima necessario disinstallare il set di contatori e quindi registrarlo di nuovo.
instances Determina se il set di contatori può contenere più istanze. Di seguito sono elencati i valori possibili:
Singolo
Definisce un set di contatori in cui è possibile esistere solo un'istanza dei contatori nel set di contatori. Specificare questo valore se i contatori forniscono misurazioni a livello di sistema, ad esempio memoria fisica. Questo è il valore predefinito.
Più
Definisce un set di contatori in cui possono esistere più istanze dei contatori nel set di contatori. Specificare questo valore se i contatori forniscono misurazioni per istanza, ad esempio il tempo del processore per processo.
globalAggregate
Definisce un singolo set di contatori dell'istanza in cui i contatori nel set di contatori devono essere aggregati da varie origini attive. Ad esempio, è possibile creare un set di contatori contenente un contatore che conta il numero di letture su disco per un disco rigido. Se il computer ha tre dischi rigidi e query consumer per il numero di letture su disco, PERFLIB otterrà il numero di letture da ogni disco e somma i singoli valori.
multipleAggregate
Definisce un set di contatori di più istanze in cui i contatori nel set di contatori devono essere aggregati in tutte le istanze di tale contatore. Ad esempio, è possibile creare un set di contatori per un'applicazione multi thread che contiene un contatore che misura le prestazioni del thread (ogni thread fa riferimento a un'istanza del set di contatori). Quando un consumer esegue una query sul contatore totale del tempo di esecuzione del thread, PERFLIB somma il tempo di esecuzione totale del thread da ogni istanza.
globalAggregateHistory
Definisce un singolo set di contatori di istanze i cui valori contatori vengono memorizzati nella cache per la durata del consumer. Si noti che tutti i contatori nel set di contatori vengono memorizzati nella cache. Per memorizzare nella cache solo contatori specifici, decorare questi contatori con l'attributo cronologia.
Usando l'esempio di lettura del disco da globalAggregate, tutti i valori dei contatori nel set di contatori verranno memorizzati nella cache. Se un disco non è disponibile, l'ultimo valore memorizzato nella cache per i byte totali letti da tale disco sarebbe comunque disponibile per l'applicazione consumer.
name Nome visualizzato del set di contatori. Deve essere minore di 1.024 caratteri. Per il nome è prevista la distinzione tra maiuscole e minuscole.
simbolo man:CSymbolType Nome simbolico che identifica il set di contatori. Lo strumento CTRPP crea una variabile GUID che è possibile usare quando si chiamano funzioni che richiedono il GUID del set di contatori, ad esempio PerfCreateInstance. Il nome della variabile è del formato, nome simbolicoGuid.
Se si include l'argomento -prefix quando si chiama CTRPP, la stringa di prefisso viene aggiunta all'inizio del nome simbolico.
Uri xs:anyURI Identificatore univoco di risorsa uniforme che consente agli utenti di accedere ai contatori nel set di contatori da qualsiasi posizione.

Requisiti

Requisito Valore
Client minimo supportato
 Windows Vista [solo app desktop]
Server minimo supportato
 Windows Server 2008 [solo app desktop]