counterSet Complex Type

Define una lista de contadores relacionados lógicamente.

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

Elemento Tipo Descripción
counter man:counter Define un contador que proporciona el proveedor.
Estructuras man:structs Lista de elementos struct que contienen valores para los contadores definidos en este conjunto de contadores.

Atributos

Nombre Tipo Descripción
description xs:string Una breve descripción del conjunto de contadores.
guid man:GUIDType GUID que identifica de forma única el conjunto de contadores. Se produce un error en el registro del conjunto de contadores si el GUID ya está registrado. Para actualizar un conjunto de contadores registrado, primero debe desinstalar el conjunto de contadores y volver a registrarlo.
instances Determina si el conjunto de contadores puede contener varias instancias. A continuación se enumeran los valores posibles:
soltero
Define un conjunto de contadores donde solo puede existir una instancia de los contadores del conjunto de contadores. Especifique este valor si los contadores proporcionan medidas para todo el sistema, como la memoria física. Este es el valor predeterminado.
Múltiples
Define un conjunto de contadores donde pueden existir varias instancias de los contadores del conjunto de contadores. Especifique este valor si los contadores proporcionan medidas por instancia, como el tiempo de procesador por proceso.
globalAggregate
Define un único conjunto de contadores de instancia en el que los contadores del conjunto de contadores se deben agregar desde varios orígenes activos. Por ejemplo, podría crear un conjunto de contadores que contenga un contador que cuente el número de lecturas de disco de un disco duro. Si el equipo tiene tres discos duros y un consumidor consulta el número de lecturas de disco, PERFLIB obtendrá el número de lecturas de cada disco y sumará sus valores individuales.
multipleAggregate
Define un conjunto de contadores de varias instancias donde los contadores del conjunto de contadores deben agregarse en todas las instancias de ese contador. Por ejemplo, podría crear un conjunto de contadores para una aplicación multiproceso que contenga un contador que mide el rendimiento de los subprocesos (cada subproceso haría referencia a una instancia del conjunto de contadores). Cuando un consumidor consulta el contador de tiempo total de ejecución de subprocesos, PERFLIB sumará el tiempo total de ejecución del subproceso de cada instancia.
globalAggregateHistory
Define un único conjunto de contadores de instancia cuyos valores de contador se almacenan en caché durante la vigencia del consumidor. Tenga en cuenta que todos los contadores del conjunto de contadores se almacenan en caché. Para almacenar en caché solo contadores específicos, decora esos contadores con el atributo history.
Con el ejemplo de lectura de disco de globalAggregate, todos los valores de contador del conjunto de contadores se almacenarían en caché. Si un disco deja de estar disponible, el último valor almacenado en caché para el total de bytes leídos por ese disco seguirá estando disponible para la aplicación consumidora.
name Nombre para mostrar del conjunto de contadores. Debe tener menos de 1024 caracteres. El nombre distingue mayúsculas de minúsculas.
símbolo man:CSymbolType Nombre simbólico que identifica el conjunto de contadores. La herramienta CTRPP crea una variable GUID que puede usar al llamar a funciones que requieren el GUID del conjunto de contadores (por ejemplo, PerfCreateInstance). El nombre de la variable tiene el formato Guid de nombre simbólico.
Si incluye el argumento -prefix al llamar a CTRPP, la cadena de prefijo se agrega al principio del nombre simbólico.
uri xs:anyURI Identificador único de recursos uniforme que permite a los usuarios acceder a los contadores del conjunto de contadores desde cualquier ubicación.

Requisitos

Requisito Value
Cliente mínimo compatible
Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible
Windows Server 2008 [solo aplicaciones de escritorio]