ChannelPublishingType 複合型

チャネルが使用するセッションのログ記録プロパティを定義します。

<xs:complexType name="ChannelPublishingType">
    <xs:sequence
        minOccurs="0"
    >
        <xs:element name="level"
            type="UInt8Type"
            default="0"
            minOccurs="0"
         />
        <xs:element name="keywords"
            type="UInt64Type"
            default="0"
            minOccurs="0"
         />
        <xs:element name="controlGuid"
            type="GUIDType"
            minOccurs="0"
         />
        <xs:element name="bufferSize"
            type="UInt32Type"
            minOccurs="0"
         />
        <xs:element name="minBuffers"
            type="UInt32Type"
            minOccurs="0"
         />
        <xs:element name="fileMax"
            type="UInt32Type"
            minOccurs="0"
         />
        <xs:element name="maxBuffers"
            type="UInt32Type"
            minOccurs="0"
         />
        <xs:element name="latency"
            type="UInt32Type"
            minOccurs="0"
         />
        <xs:element name="clockType"
            default="SystemTime"
            minOccurs="0"
        >
            <xs:simpleType>
                <xs:restriction
                    base="xs:string"
                >
                    <xs:enumeration
                        value="SystemTime"
                     />
                    <xs:enumeration
                        value="QPC"
                     />
                </xs:restriction>
            </xs:simpleType>
        </xs:element>
        <xs:element name="sidType"
            minOccurs="0"
        >
            <xs:simpleType>
                <xs:restriction
                    base="xs:string"
                >
                    <xs:enumeration
                        value="None"
                     />
                    <xs:enumeration
                        value="Publishing"
                     />
                </xs:restriction>
            </xs:simpleType>
        </xs:element>
        <xs:any
            processContents="lax"
            minOccurs="0"
            maxOccurs="unbounded"
            namespace="##other"
         />
    </xs:sequence>
    <xs:anyAttribute
        processContents="lax"
        namespace="##other"
     />
</xs:complexType>

子要素

要素	Type	説明
Buffersize	UInt32Type	各バッファーに割り当てるメモリの量 (キロバイト単位)。 比較的低いイベント レートが予想される場合は、バッファー サイズをメモリ ページ サイズに設定する必要があります。 イベント レートが比較的高い場合は、より大きなバッファー サイズを指定し、バッファーの最大数を増やす必要があります。 バッファー サイズは、バッファーが埋まる速度に影響し、フラッシュする必要があります。 バッファー サイズが小さいほど必要なメモリは少なくなりますが、バッファーをフラッシュする必要がある速度が高くなります。 分析チャネルとデバッグ チャネルの既定のバッファー サイズは 4 KB で、管理と運用の場合は 64 KB です。
clockType		各イベントのタイム スタンプをログに記録するときに使用するクロック解像度。 SystemTime または QPC を指定できます。 SystemTime は低解像度 (10 ミリ秒) のタイム スタンプを提供しますが、取得するコストは比較的低くなります。 既定値は SystemTime です。 クエリ パフォーマンス カウンター (QPC) は高解像度 (100 ナノ秒) のタイム スタンプを提供しますが、取得コストは比較的高くなります。 イベントレートが高い場合、またはコンシューマーが異なるバッファーのイベントをマージする場合は、QPC を実行する必要があります。
controlGuid	GUIDType	WPP イベントを含む ETW セッションのセッション GUID を識別します。 この設定は、Debug 型のチャネルでのみ使用できます。 キーワードを 0 (0x0000000000000000) に設定すると、これらのチャネルを完全に有効にすることはできません。 キーワードを 0xffffffffffffffff に設定して有効にする必要があります。
fileMax	UInt32Type	チャネルが有効になっているときにサービスで新しいログ ファイルを作成する最大回数 (コンピューターの再起動時を含む)。 値が 0 または 1 の場合、チャネルが有効になり、前のイベントが失われるたびに、サービスによってログ ファイルが上書きされます。 値が 1 より大きい場合、イベントを保持するためにチャネルが有効になるたびに、サービスによって新しいログ ファイルが作成されます。 既定値は 1 で、指定できる最大値は 16 です。 サービスは、各ファイル名に 0 から fileMax 1 までの 3 桁の 10 進数を追加します。 たとえば、 filename.etl.xxx。xxx は 3 桁の 10 進数です。 ファイルは %windir%\System32\winevt\Logs にあります。
キーワード	UInt64Type	チャネルに書き込まれるイベントのカテゴリを決定するビットマスク。 keywords 属性の値が 0 の場合、プロバイダーが書き込むすべてのイベントがチャネルに書き込まれます。それ以外の場合は、キーワードビットマスクに含まれるキーワード (keyword)を定義したイベントのみがチャネルに書き込まれます。 既定値は 0 です。 controlGuid 属性が設定されているデバッグ チャネルでは、 keywords 属性を0xFFFFFFFFFFFFFFFFに設定する必要があります。 セッションでは、プロバイダーが有効になると、キーワード値がプロバイダーに渡されます。
遅延	UInt32Type	バッファーをフラッシュするまでの待機時間 (ミリ秒単位)。 ゼロの場合、ETW はバッファーがいっぱいになるとすぐにバッファーをフラッシュします。 0 以外の場合、ETW は、バッファーがいっぱいでない場合でも、値に基づいてイベントを含むすべてのバッファーをフラッシュします。 通常、バッファーがいっぱいになったときにのみバッファーをフラッシュする必要があります。 バッファーを強制的にフラッシュすると、バッファー領域が不足しているログ ファイルのファイル サイズが大きくなる可能性があります。 既定値は、管理ログと操作ログの場合は 1 秒、分析ログとデバッグ ログの場合は 5 秒です。
レベル	UInt8Type	チャネルに書き込むイベントの重大度レベル。 サービスは、指定した値以下のレベル値を持つチャネルにイベントを書き込みます。 既定値は 0 です。これは、任意のレベル値を持つイベントをログに記録することを意味します。 セッションでは、プロバイダーが有効になると、レベル値がプロバイダーに渡されます。
maxBuffers	UInt32Type	セッションに割り当てるバッファーの最大数。 通常、この値はバッファーの最小数に 20 を加えた値です。 この値は、minBuffers に指定された値以上である必要があります。 分析チャネルとデバッグ チャネルのバッファーの既定の最大数は 10 KB で、管理と運用の場合は 64 KB です。
minBuffers	UInt32Type	セッションに割り当てるバッファーの最小数。 既定値は 0 です。
sidType		チャネルに書き込まれる各イベントにプリンシパルのセキュリティ識別子 (SID) を含めるかどうかを決定します。 イベントに SID を含めるには、この属性を "Publishing" に設定します。 SID は、イベントの書き込み時のスレッド ID に基づいて設定されます。 イベントに SID を含める必要がない場合は、この属性を "None" に設定します。 既定値は "Publishing" です。

解説

この公開情報は、分析チャネルとデバッグ チャネルの種類、またはカスタム分離を指定する任意のチャネルに指定できます。

レベルとキーワードは指定できますが、そのチャネルのプロバイダーから受け取るイベントはこれらだけであると考える必要があります。

バッファーがいっぱいになると、ETW はバッファーをログ ファイルにフラッシュします。 バッファーがフラッシュできるよりも高速に入力されると、指定された最大数まで、新しいバッファーが割り当てられ、セッションのバッファー プールに追加されます。 この制限を超えると、バッファーが使用可能になるまで、セッションは受信イベントを破棄します。

要件

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