SystemCollector

描述啟用 Windows 事件追蹤 (ETW) 核心模式會話的設定。

元素階層

Syntax

<SystemCollector Id       = IdType
                 Base     = string
                 Name     = "NT Kernel Logger" | "Circular Kernel Context Logger"
                 Realtime = boolean>

  <!-- Child elements -->
  BufferSize,
  Buffers,
   StackCaching,
  MaximumFileSize,
  FileMax

</SystemCollector>

屬性和項目

屬性

屬性 描述 資料類型 必要 預設
Id 可唯一識別系統收集器。 必須至少有一個字元且不能包含冒號的字串, (:) 或空格。 Yes
基地 識別系統收集器的基底。 衍生收集器具有基底收集器的所有屬性。 您可以藉由在衍生收集器中明確指定它們來覆寫這些專案。 字串 No
名稱 表示系統收集器的名稱。 此屬性可以有下列其中一個值:
  • NT 核心記錄器
  • 迴圈核心內容記錄器
Yes
即時 指出收集器是否即時運作。 boolean No false

子元素

元素 描述 需求 預設
BufferSize 描述每個緩衝區的大小,以 KB 為單位。 選擇性,1。 128
緩衝區 描述啟動會話時要配置的緩衝區數目。 選擇性,1。 64
StackCaching 描述收集器的堆疊快取屬性。 選擇性,1。
MaximumFileSize 描述追蹤檔案大小上限。 選擇性,1。
FileMax 描述 ETW 為自動記錄器追蹤建立的記錄檔實例數目上限。 選擇性,1。

父項目

元素 描述
設定檔 表示收集器、提供者和設定檔的集合。

備註

系統收集器定義應該在事件收集器定義之前。

範例

下列程式碼範例會定義系統收集器。

<SystemCollector
  Id="WPRSystemCollector”
  Name="NT Kernel Logger"
  FileName="WPRKernel.etl">
  <BufferSize Value="512"/>
  <Buffers Value="3" PercentageOfTotalMemory="true"/>
</SystemCollector>

元素