instrumentationManifest 要素

マニフェストのルート ノード。

<xs:element name="instrumentationManifest">
    <xs:complexType>
        <xs:complexContent>
            <xs:extension
                base="InstrumentationManifestType"
            >
                <xs:choice
                    maxOccurs="3"
                >
                    <xs:choice>
                        <xs:element name="metadata"
                            type="MetadataType"
                         />
                        <xs:element name="instrumentation"
                            type="InstrumentationType"
                         />
                    </xs:choice>
                    <xs:element name="localization"
                        type="LocalizationType"
                     />
                    <xs:any
                        processContents="lax"
                        minOccurs="0"
                        maxOccurs="unbounded"
                        namespace="##other"
                     />
                </xs:choice>
            </xs:extension>
        </xs:complexContent>
    </xs:complexType>
</xs:element>

子要素

要素	Type	説明
計測	InstrumentationType	このセクションでは、1 つ以上のイベント プロバイダーと、それらがログに記録するイベントを定義します。
ローカライズ	LocalizationType	このセクションでは、コンシューマーが表示に使用するローカライズされたメッセージ文字列を定義します。 たとえば、このセクションには、プロバイダーの名前のローカライズされたメッセージ文字列、定義するイベント、およびチャネル、タスク、オペコードなど、定義したイベント属性が含まれます。
メタデータ	MetadataType	このセクションでは、他のマニフェストで使用できるメタデータ型を定義します。 例については、Windows SDK の \Include フォルダーに含まれるWinmeta.xml ファイルを参照してください。

解説

instrumentationManifest 要素には、次の名前空間が含まれている必要があります。

xmlns="https://schemas.microsoft.com/win/2004/08/events" xmlns:win="https://manifests.microsoft.com/win/2004/08/windows/events" xmlns:xs="https://www.w3.org/2001/XMLSchema"

マニフェストには、インストルメンテーション セクションとローカライズ セクションが含まれている必要があります。 インストルメンテーション セクションとメタデータ セクションは相互に排他的です (両方を同じマニフェストで定義することはできません)。 メタデータ セクションを含むマニフェストを作成することはできますが、サービスでは使用されません。サービスが認識する唯一のメタデータは、Winmeta.xml ファイルにあるメタデータです。

例

次の例は、完全に定義されたインストルメンテーション マニフェストのスケルトンを示しています。

<instrumentationManifest
    xmlns="http://schemas.microsoft.com/win/2004/08/events" 
    xmlns:win="https://manifests.microsoft.com/win/2004/08/windows/events"
    xmlns:xs="https://www.w3.org/2001/XMLSchema"    
    >

    <instrumentation>
        <events>
            <provider ...>
                <channels>
                    <importChanel .../>
                    <channel .../>
                </channels>
                <levels>
                <level .../>
                </levels>
                <tasks>
                    <task .../>
                </tasks>
                <opcodes>
                    <opcode .../>
                </opcodes>
                <keywords>
                    <keyword .../>
                </keywords>
                <filters>
                    <filter .../>
                </filters>
                <maps>
                    <valueMap ...>
                        <map .../>
                    </valueMap>
                    <bitMap ...>
                        <map .../>
                    </bitMap>
                </maps>
                <namedQueries>
                    <patternMap ...>
                        <map .../>
                    </patternMap>  
                </namedQueries>
                <templates>
                    <template ...>
                        <data .../>
                        <UserData>
                            <!-- valid XML fragment -->
                        </UserData>
                    </template>
                </templates>
                <events>
                    <event .../>
                </events>
            </provider>
        </events>
    </instrumentation>

    <localization>
        <resources ...>
            <stringTable>
                <string .../>
            </stringTable>
        </resources>
    </localization>

</instrumentationManifest>

要件

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