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	説明
counter	man:counter	プロバイダーが提供するカウンターを定義します。
構造 体	man:structs	このカウンター セットで定義されているカウンターの値を含む構造体要素の一覧。

属性

名前	型	説明
description	xs:string	カウンター セットの簡単な説明。
guid	man:GUIDType	カウンター セットを一意に識別する GUID。 GUID が既に登録されている場合、カウンター セットの登録は失敗します。 登録されているカウンター セットを更新するには、まずカウンター セットをアンインストールしてから、もう一度登録する必要があります。
instances		カウンター セットに複数のインスタンスを含めることができるかどうかを判断します。 次に、使用可能な値を示します。 単一 カウンター セット内のカウンターのインスタンスが 1 つだけ存在できるカウンター セットを定義します。 物理メモリなどのシステム全体の測定値がカウンターによって提供される場合は、この値を指定します。 既定値です。 複数 カウンター セット内のカウンターの複数のインスタンスが存在できるカウンター セットを定義します。 カウンターでプロセスごとのプロセッサ時間など、インスタンスごとの測定値が提供される場合は、この値を指定します。 globalAggregate カウンター セット内のカウンターをさまざまなアクティブなソースから集計する必要がある 1 つのインスタンス カウンター セットを定義します。 たとえば、ハード ディスクのディスク読み取りの数をカウントするカウンターを含むカウンター セットを作成できます。 コンピューターに 3 つのハード ディスクがあり、コンシューマーがディスク読み取りの数を照会する場合、PERFLIB は各ディスクからの読み取りの数を取得し、個々の値を合計します。 multipleAggregate カウンター セット内のカウンターをそのカウンターのすべてのインスタンスにわたって集計する必要がある複数インスタンス カウンター セットを定義します。 たとえば、スレッドのパフォーマンスを測定するカウンターを含むマルチスレッド アプリケーションのカウンター セットを作成できます (各スレッドはカウンター セットのインスタンスを参照します)。 コンシューマーが合計スレッド実行時間カウンターを照会すると、PERFLIB は各インスタンスからのスレッドの合計実行時間を合計します。 globalAggregateHistory コンシューマーの有効期間中にカウンター値がキャッシュされる 1 つのインスタンス カウンター セットを定義します。 カウンター セット内のすべてのカウンターがキャッシュされることに注意してください。 特定のカウンターのみをキャッシュするには、それらのカウンターを history 属性で装飾します。 globalAggregate からディスク読み取りの例を使用すると、カウンター セット内のすべてのカウンター値がキャッシュされます。 1 つのディスクが使用できなくなった場合でも、そのディスクによって読み取られた合計バイト数の最後のキャッシュ値は、コンシューマー アプリケーションで引き続き使用できます。
name		カウンター セットの表示名。 1,024 文字未満にする必要があります。 名前の大文字と小文字は区別されます。
記号	man:CSymbolType	カウンター セットを識別するシンボリック名。 CTRPP ツールは、カウンター セット GUID (PerfCreateInstance など) を必要とする関数を呼び出すときに使用できる GUID 変数を作成します。 変数名は、 シンボリック名Guid という形式です。 CTRPP を呼び出すときに -prefix 引数を含めると、プレフィックス文字列がシンボリック名の先頭に追加されます。
uri	xs:anyURI	ユーザーが任意の場所からカウンター セット内のカウンターにアクセスできるようにする一意の UNIFORM リソース識別子。

要件

要件	値
サポートされている最小のクライアント	Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップ アプリのみ]