次の方法で共有


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>

要素