counterSet 복합 형식

  • 아티클

논리적으로 관련된 카운터 목록을 정의합니다.

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

자식 요소

요소 Type Description
카운터 man:counter 공급자가 제공하는 카운터를 정의합니다.
구조체 man:structs 이 카운터 집합에 정의된 카운터의 값을 포함하는 구조체 요소 목록입니다.

특성

이름 형식 Description
description xs:string 카운터 집합에 대한 간단한 설명입니다.
guid man:GUIDType 카운터 집합을 고유하게 식별하는 GUID입니다. GUID가 이미 등록된 경우 카운터 집합 등록이 실패합니다. 등록된 카운터 집합을 업데이트하려면 먼저 카운터 집합을 제거한 다음 다시 등록해야 합니다.
인스턴스 카운터 집합에 여러 인스턴스가 포함될 수 있는지 여부를 결정합니다. 다음은 가능한 값을 나열합니다.
단일
카운터 집합에 있는 카운터의 instance 하나만 존재할 수 있는 카운터 집합을 정의합니다. 카운터가 물리적 메모리와 같은 시스템 전체 측정값을 제공하는 경우 이 값을 지정합니다. 이것이 기본값입니다.
여러
카운터 집합에 카운터의 여러 인스턴스가 있을 수 있는 카운터 집합을 정의합니다. 카운터가 프로세스당 프로세서 시간과 같은 instance 단위 단위를 제공하는 경우 이 값을 지정합니다.
globalAggregate
카운터 집합의 카운터를 다양한 활성 원본에서 집계해야 하는 단일 instance 카운터 집합을 정의합니다. 예를 들어 하드 디스크에 대한 디스크 읽기 수를 계산하는 카운터가 포함된 카운터 집합을 만들 수 있습니다. 컴퓨터에 3개의 하드 디스크와 디스크 읽기 수에 대한 소비자 쿼리가 있는 경우 PERFLIB는 각 디스크에서 읽기 수를 가져오고 개별 값을 합산합니다.
multipleAggregate
카운터 집합의 카운터를 해당 카운터의 모든 인스턴스에서 집계해야 하는 여러 instance 카운터 집합을 정의합니다. 예를 들어 스레드 성능을 측정하는 카운터가 포함된 다중 스레드 애플리케이션에 대한 카운터 집합을 만들 수 있습니다(각 스레드는 카운터 집합의 instance 참조). 소비자가 총 스레드 실행 시간 카운터를 쿼리하면 PERFLIB는 각 instance 총 스레드 실행 시간을 합산합니다.
globalAggregateHistory
소비자의 수명 동안 카운터 값이 캐시되는 단일 instance 카운터 집합을 정의합니다. 카운터 집합의 모든 카운터는 캐시됩니다. 특정 카운터만 캐시하려면 해당 카운터를 기록 특성으로 데코레이트합니다.
globalAggregate의 디스크 읽기 예제를 사용하면 카운터 집합의 모든 카운터 값이 캐시됩니다. 하나의 디스크를 사용할 수 없게 되면 해당 디스크에서 읽은 총 바이트의 마지막 캐시된 값은 소비자 애플리케이션에서 계속 사용할 수 있습니다.
name 카운터 집합의 표시 이름입니다. 1,024자 미만이어야 합니다. 이름은 대/소문자를 구분합니다.
기호 man:CSymbolType 카운터 집합을 식별하는 기호 이름입니다. CTRPP 도구는 카운터 집합 GUID(예: PerfCreateInstance)가 필요한 함수를 호출할 때 사용할 수 있는 GUID 변수를 만듭니다. 변수 이름은 기호 이름Guid 형식입니다.
CTRPP를 호출할 때 -prefix 인수를 포함하는 경우 접두사 문자열이 기호 이름의 시작 부분에 추가됩니다.
uri xs:anyURI 사용자가 모든 위치에서 카운터 집합의 카운터에 액세스할 수 있는 고유한 균일한 리소스 식별자입니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트
 Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버
 Windows Server 2008 [데스크톱 앱만 해당]