카운터 복합 형식

아티클
06/12/2023

카운터를 정의합니다.

<xs:complexType name="counter">
    <xs:choice
        minOccurs="0"
        maxOccurs="1"
    >
        <xs:element name="counterAttributes"
            type="man:counterAttributes"
        >
            <xs:key name="uniqueCounterAttributeName">
                <xs:selector
                    xpath="./man:counterAttribute"
                 />
                <xs:field
                    xpath="@name"
                 />
            </xs:key>
        </xs:element>
    </xs:choice>
    <xs:attribute name="symbol"
        type="man:CSymbolType"
        use="optional"
     />
    <xs:attribute name="id"
        type="man:UInt32Type"
        use="required"
     />
    <xs:attribute name="uri"
        type="xs:anyURI"
        use="required"
     />
    <xs:attribute name="name"
        use="optional"
    >
        <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="optional"
     />
    <xs:attribute name="type"
        use="required"
    >
        <xs:simpleType>
            <xs:restriction
                base="xs:string"
            >
                <xs:enumeration
                    value="perf_counter_counter"
                 />
                <xs:enumeration
                    value="perf_counter_timer"
                 />
                <xs:enumeration
                    value="perf_counter_queuelen_type"
                 />
                <xs:enumeration
                    value="perf_counter_large_queuelen_type"
                 />
                <xs:enumeration
                    value="perf_counter_100ns_queuelen_type"
                 />
                <xs:enumeration
                    value="perf_counter_obj_time_queuelen_type"
                 />
                <xs:enumeration
                    value="perf_counter_bulk_count"
                 />
                <xs:enumeration
                    value="perf_counter_text"
                 />
                <xs:enumeration
                    value="perf_counter_rawcount"
                 />
                <xs:enumeration
                    value="perf_counter_large_rawcount"
                 />
                <xs:enumeration
                    value="perf_counter_rawcount_hex"
                 />
                <xs:enumeration
                    value="perf_counter_large_rawcount_hex"
                 />
                <xs:enumeration
                    value="perf_sample_fraction"
                 />
                <xs:enumeration
                    value="perf_sample_counter"
                 />
                <xs:enumeration
                    value="perf_counter_timer_inv"
                 />
                <xs:enumeration
                    value="perf_sample_base"
                 />
                <xs:enumeration
                    value="perf_average_timer"
                 />
                <xs:enumeration
                    value="perf_average_base"
                 />
                <xs:enumeration
                    value="perf_average_bulk"
                 />
                <xs:enumeration
                    value="perf_obj_time_timer"
                 />
                <xs:enumeration
                    value="perf_100nsec_timer"
                 />
                <xs:enumeration
                    value="perf_100nsec_timer_inv"
                 />
                <xs:enumeration
                    value="perf_counter_multi_timer"
                 />
                <xs:enumeration
                    value="perf_counter_multi_timer_inv"
                 />
                <xs:enumeration
                    value="perf_counter_multi_base"
                 />
                <xs:enumeration
                    value="perf_100nsec_multi_timer"
                 />
                <xs:enumeration
                    value="perf_100nsec_multi_timer_inv"
                 />
                <xs:enumeration
                    value="perf_raw_fraction"
                 />
                <xs:enumeration
                    value="perf_large_raw_fraction"
                 />
                <xs:enumeration
                    value="perf_raw_base"
                 />
                <xs:enumeration
                    value="perf_large_raw_base"
                 />
                <xs:enumeration
                    value="perf_elapsed_time"
                 />
                <xs:enumeration
                    value="perf_counter_delta"
                 />
                <xs:enumeration
                    value="perf_counter_large_delta"
                 />
                <xs:enumeration
                    value="perf_precision_system_timer"
                 />
                <xs:enumeration
                    value="perf_precision_100ns_timer"
                 />
                <xs:enumeration
                    value="perf_precision_object_timer"
                 />
                <xs:enumeration
                    value="perf_counter_composite"
                 />
            </xs:restriction>
        </xs:simpleType>
    </xs:attribute>
    <xs:attribute name="baseID"
        type="man:UInt32Type"
        use="optional"
     />
    <xs:attribute name="detailLevel"
        use="required"
    >
        <xs:simpleType>
            <xs:restriction
                base="xs:string"
            >
                <xs:enumeration
                    value="standard"
                 />
                <xs:enumeration
                    value="advanced"
                 />
            </xs:restriction>
        </xs:simpleType>
    </xs:attribute>
    <xs:attribute name="defaultScale"
        use="optional"
        default="0"
    >
        <xs:simpleType>
            <xs:restriction
                base="xs:integer"
            >
                <xs:minInclusive
                    value="-10"
                 />
                <xs:maxInclusive
                    value="10"
                 />
            </xs:restriction>
        </xs:simpleType>
    </xs:attribute>
    <xs:attribute name="aggregate"
        use="optional"
    >
        <xs:simpleType>
            <xs:restriction
                base="xs:string"
            >
                <xs:enumeration
                    value="sum"
                 />
                <xs:enumeration
                    value="avg"
                 />
                <xs:enumeration
                    value="max"
                 />
                <xs:enumeration
                    value="min"
                 />
                <xs:enumeration
                    value="undefined"
                 />
            </xs:restriction>
        </xs:simpleType>
    </xs:attribute>
    <xs:attribute name="perfTimeID"
        type="man:UInt32Type"
        use="optional"
     />
    <xs:attribute name="perfFreqID"
        type="man:UInt32Type"
        use="optional"
     />
    <xs:attribute name="multiCounterID"
        type="man:UInt32Type"
        use="optional"
     />
    <xs:attribute name="struct"
        type="man:CSymbolType"
        use="optional"
     />
    <xs:attribute name="field"
        type="man:CSymbolType"
        use="optional"
     />
</xs:complexType>

자식 요소

요소	Type	설명
counterAttributes	man:counterAttributes	카운터 데이터가 소비자 애플리케이션에 표시되는 방법을 지정하는 고유 특성을 나열합니다.

특성

이름	형식	Description
aggregate	counterSet의 인스턴스 특성이 globalAggregate, multipleAggregate 또는 globalAggregateHistory인 경우 적용할 집계 함수입니다. 다음은 적용할 수 있는 가능한 집계 함수입니다. 최대 최대 카운터 값이 반환됩니다. 분 최소 카운터 값이 반환됩니다. 평균 평균 카운터 값이 반환됩니다. 합계 카운터 값의 합계가 반환됩니다. 정의 이 카운터를 집계하지 마세요.
baseID	man:UInt32Type	동일한 카운터 집합 내의 다른 카운터 식별자이며, 해당 값은 이 카운터의 값을 계산하는 데 사용됩니다. 다음 카운터 형식에는 기본 카운터가 필요합니다. PERF_AVERAGE_TIMER PERF_AVERAGE_BASE 기본 카운터가 필요합니다. PERF_AVERAGE_BULK PERF_AVERAGE_BASE 기본 카운터가 필요합니다. PERF_COUNTER_MULTI_TIMER_INV PERF_COUNTER_MULTI_BASE 기본 카운터가 필요합니다. PERF_LARGE_RAW_FRACTION PERF_LARGE_RAW_BASE 기본 카운터가 필요합니다. PERF_PRECISION_100NS_TIMER PERF_LARGE_RAW_BASE 기본 카운터가 필요합니다. PERF_RAW_FRACTION PERF_RAW_BASE 기본 카운터가 필요합니다. PERF_SAMPLE_FRACTION PERF_SAMPLE_BASE 기본 카운터가 필요합니다.
defaultScale	카운터 값(factor * counter value)에 적용할 배율 인수입니다. 크기 조정이 적용되지 않으면 기본값은 0입니다. 유효한 값의 범위는 10에서 10(0.00000000001에서 10000000000)입니다. 이 값이 0이면 배율 값은 1이고, 이 값이 1이면 배율 값은 10이고, 이 값이 1이면 배율 값은 .10이고, 등등.
description	xs:string	카운터에 대한 간단한 설명입니다. 카운터에 noDisplay 특성이 포함된 경우 이 특성을 지정할 필요가 없습니다.
detailLevel	카운터 세부 정보에 대한 대상 그룹을 지정합니다. 가능한 값은 다음과 같습니다. 표준 일반적인 사용자가 이해할 수 있는 카운터에 대한 세부 정보를 표시합니다. 고급 고급 사용자만 이해할 수 있는 카운터에 대한 세부 정보를 표시합니다.
필드(field)	man:CSymbolType	카운터 값이 포함된 구조체 내의 필드 이름입니다. 이 특성은 사용자 모드 공급자에 대해 허용되지 않습니다.
id	man:UInt32Type	카운터 집합 내에서 카운터를 식별하는 고유 번호입니다.
multiCounterID	man:UInt32Type	이 카운터의 값을 계산하는 데 승수 값을 사용하는 동일한 카운터 집합 내의 다른 카운터 식별자입니다. 다음 카운터 형식에는 승수 값이 필요합니다. 참조된 카운터는 PERF_COUNTER_RAWCOUNT 형식이어야 합니다. PERF_COUNTER_MULTI_TIMER PERF_COUNTER_MULTI_TIMER_INV PERF_100NSEC_MULTI_TIMER PERF_100NSEC_MULTI_TIMER_INV
name	카운터의 이름입니다. 이름은 고유하고 1,024자 미만이어야 합니다. 이름은 대/소문자를 구분합니다. 카운터에 noDisplay 특성이 포함된 경우 이 특성을 지정할 필요가 없습니다.
perfFreqID	man:UInt32Type	이 카운터의 값을 계산하는 데 빈도 값을 사용하는 동일한 카운터 집합 내의 다른 카운터 식별자입니다. 다음 카운터 형식에는 빈도가 필요합니다. PERF_COUNTER_LARGE_RAWCOUNT 카운터 형식에는 타임스탬프를 포함합니다. PERF_COUNTER_OBJECT_TIME_QUEUELEN_TYPE PERF_ELAPSED_TIME PERF_OBJ_TIME_TIMER PERF_PRECISION_OBJECT_TIMER
perfTimeID	man:UInt32Type	이 카운터의 값을 계산하는 데 타임스탬프를 사용하는 동일한 카운터 집합 내의 다른 카운터 식별자입니다. 다음 카운터 형식에는 타임스탬프를 요구합니다. PERF_COUNTER_LARGE_RAWCOUNT 카운터 형식에는 타임스탬프를 포함합니다. PERF_COUNTER_OBJECT_TIME_QUEUELEN_TYPE PERF_ELAPSED_TIME PERF_OBJ_TIME_TIMER PERF_PRECISION_OBJECT_TIMER
struct	man:CSymbolType	이 카운터 값을 포함하는 구조체 요소의 이름입니다. 이 특성은 사용자 모드 공급자에 대해 허용되지 않습니다.
기호	man:CSymbolType	카운터를 식별하는 기호 이름입니다. CTRPP 도구는 카운터 식별자가 필요한 함수를 호출할 때 사용할 수 있는 상수를 만듭니다(예: PerfIncrementULongCounterValue). 상수의 이름은 기호 이름입니다.
형식	카운터 형식의 이름입니다. 가능한 값은 위의 구문 블록을 참조하세요. 각 형식에 대한 자세한 내용은 Windows 2003 배포 가이드의 카운터 형식 을 참조하세요. 이름은 대/소문자 구분 사용 소문자입니다.
uri	xs:anyURI	사용자가 모든 위치에서 카운터 값을 검색할 수 있는 고유한 균일한 리소스 식별자입니다.

설명

이전 버전과의 호환성을 제공하려면 카운터 집합의 각 카운터에서 동일한 perfFreqID 및 perfTimeID 값을 지정해야 합니다.

요구 사항

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

다음을 통해 공유

카운터 복합 형식

자식 요소

특성

설명

요구 사항

피드백

피드백

추가 리소스