EventCollector
プロファイルのイベント コレクターを表します。
要素の階層
-
<
WindowsPerformanceRecorder>
-
<
プロファイル>
- < EventCollector>
-
<
プロファイル>
構文
<EventCollector Id = IdType
Base = string
Name = string
FileName = string
Realtime = boolean
Private = boolean
ProcessPrivate = boolean
Secure = boolean>
<!-- Child elements -->
BufferSize,
Buffers,
StackCaching,
MaximumFileSize,
FileMax,
FlushTimer,
FlushThreshold
</EventCollector>
属性および要素
属性
属性 | 説明 | データ型 | 必須 | Default |
---|---|---|---|---|
Id | イベント コレクターを一意に識別します。 | 少なくとも 1 つの文字を含み、コロン (:) やスペースを含めることができない文字列。 | はい | |
Base | 基本となるイベント コレクターを識別します。 | string | いいえ | |
名前 | ETW セッションの名前を示します。 | string | はい | |
FileName | イベントのログを記録するファイルを示します。 | string | はい | |
Realtime | イベント コレクターがリアルタイムで動作するかどうかを示します。 | boolean | いいえ | false |
プライベート | "true" に設定した場合、イベント プロバイダーと同じプロセスで実行されるユーザーモード セッションを示します。 "false" に設定した場合、グローバル ユーザーモード セッションを示します。 | boolean | いいえ | false |
ProcessPrivate | "true" に設定した場合、イベント プロバイダーと同じプロセスで実行され、プロバイダーを登録したプロセスでのみ制御される必要があるユーザーモード セッションを示します。 "false" に設定した場合、グローバル ユーザーモード セッションを示します。 この属性は、Private 属性と組み合わせて使用します。 | boolean | いいえ | false |
セキュリティ保護 | "true" に設定した場合、管理特権と適切なアクセス権を持つユーザーのみがセッションを制御できることを示します。 "false" に設定した場合、すべてのユーザーがセッションを制御できることを示します。 | boolean | いいえ | false |
子要素
要素 | 説明 | 要件 | Default |
---|---|---|---|
BufferSize | 各バッファーのサイズ (KB 単位) を記述します。 | 省略可能、1。 | 128 |
Buffers | セッションの開始時に割り当てるバッファーの数を記述します。 | 省略可能、1。 | 64 |
StackCaching | コレクターのスタック キャッシュ属性を記述します。 | 省略可能、1。 | |
MaximumFileSize | トレース ファイルの最大サイズについて説明します。 | 省略可能、1。 | |
FileMax | 自動ロガー トレース用に ETW によって作成されるログ ファイルのインスタンスの最大数について説明します。 | 省略可能、1。 |
親要素
要素 | 説明 |
---|---|
Profiles | コレクター、プロバイダー、およびプロファイルのコレクションを表します。 |
注釈
システム コレクター定義は、イベント コレクター定義の前に配置する必要があります。
派生コレクターは、派生コレクターで明示的に指定されていない限り、基本コレクターのすべての属性を継承します。 詳細については、「継承」を参照してください。
例
次のコード例では、それぞれ 128 KB の 64 バッファーを持つイベント コレクターを定義します。
<EventCollector
Id="WPREventCollector"
Name="WPR Event Collector"
FileName="somefilename.etl">
<BufferSize
Value="128"/>
<Buffers
Value="64"/>
</EventCollector>