Compartilhar via


Tipo complexo counterSet

Define uma lista de contadores que estão logicamente relacionados.

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

Elementos filho

Elemento Type Descrição
contador man:counter Define um contador que o provedor fornece.
Estruturas man:structs Uma lista de elementos de struct que contêm valores para os contadores definidos neste conjunto de contadores.

Atributos

Nome Tipo Descrição
descrição xs:string Uma breve descrição do conjunto de contadores.
guid man:GUIDType Um GUID que identifica exclusivamente o conjunto de contadores. O registro do conjunto de contadores falhará se o GUID já estiver registrado. Para atualizar um conjunto de contadores registrado, primeiro você deve desinstalar o conjunto de contadores e registrá-lo novamente.
instances Determina se o conjunto de contadores pode conter várias instâncias. O seguinte lista os valores possíveis:
Único
Define um conjunto de contadores em que apenas uma instância dos contadores no conjunto de contadores pode existir. Especifique esse valor se os contadores fornecerem medidas em todo o sistema, como memória física. Esse é o padrão.
Vários
Define um conjunto de contadores em que várias instâncias dos contadores no conjunto de contadores podem existir. Especifique esse valor se os contadores fornecerem medidas por instância, como o tempo do processador por processo.
globalAggregate
Define um único conjunto de contadores de instância em que os contadores no conjunto de contadores devem ser agregados de várias fontes ativas. Por exemplo, você pode criar um conjunto de contadores que contém um contador que conta o número de leituras de disco para um disco rígido. Se o computador tiver três discos rígidos e uma consulta de consumidor para o número de leituras de disco, o PERFLIB obterá o número de leituras de cada disco e somará seus valores individuais.
multipleAggregate
Define um conjunto de contadores de várias instâncias em que os contadores no conjunto de contadores devem ser agregados em todas as instâncias desse contador. Por exemplo, você pode criar um conjunto de contadores para um aplicativo multi-threaded que contém um contador que mede o desempenho do thread (cada thread se refere a uma instância do conjunto de contadores). Quando um consumidor consulta o contador de tempo de execução total do thread, o PERFLIB somará o tempo total de execução do thread de cada instância.
globalAggregateHistory
Define um único conjunto de contadores de instância cujos valores de contador são armazenados em cache durante o tempo de vida do consumidor. Observe que todos os contadores no conjunto de contadores são armazenados em cache. Para armazenar em cache apenas contadores específicos, decore esses contadores com o atributo de histórico.
Usando o exemplo de leitura de disco de globalAggregate, todos os valores de contador no conjunto de contadores seriam armazenados em cache. Se um disco ficar indisponível, o último valor armazenado em cache para o total de bytes lidos por esse disco ainda estará disponível para o aplicativo consumidor.
name O nome de exibição do conjunto de contadores. Deve ter menos de 1.024 caracteres. O nome diferencia maiúsculas de minúsculas.
símbolo man:CSymbolType Um nome simbólico que identifica o conjunto de contadores. A ferramenta CTRPP cria uma variável GUID que você pode usar ao chamar funções que exigem o GUID do conjunto de contadores (por exemplo, PerfCreateInstance). O nome da variável é do formulário, simbolismoGuid.
Se você incluir o argumento -prefix ao chamar CTRPP, a cadeia de caracteres de prefixo será adicionada ao início do nome simbólico.
uri xs:anyURI Um identificador de recurso uniforme exclusivo que permite que os usuários acessem os contadores no conjunto de contadores de qualquer local.

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
Windows Server 2008 [somente aplicativos da área de trabalho]