EventCollector

表示設定檔的事件收集器。

元素階層

• < WindowsPerformanceRecorder>
  • < 配置 檔>
    • < EventCollector>

Syntax

<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>

屬性和項目

屬性

屬性	描述	資料類型	必要	預設
Id	唯一識別事件收集器。	必須至少有一個字元且不能包含冒號的字串， (：) 或空格。	Yes
基地	識別事件收集器的基底。	字串	No
名稱	指出 ETW 會話的名稱。	string	是
FileName	指出要記錄事件的檔案。	string	Yes
即時	指出事件收集器是否即時運作。	boolean	No	false
私人	如果設定為 「true」，表示在與其事件提供者相同的進程中執行的使用者模式會話。 如果設定為 「false」，表示全域使用者模式會話。	boolean	No	false
ProcessPrivate	如果設定為 「true」，表示在與其事件提供者相同的進程中執行的使用者模式會話，而且應該只由註冊提供者的進程式控制制。 如果設定為 「false」，表示全域使用者模式會話。 搭配 Private 屬性使用這個屬性。	boolean	No	false
安全	如果設定為 「true」，表示只有具有系統管理許可權和適當存取權限的使用者才能控制會話。 如果設定為 「false」，表示所有使用者都可以控制會話。	boolean	No	false

子元素

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

父項目

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

備註

系統收集器定義必須在事件收集器定義之前。

除非在衍生收集器中明確指定，否則衍生收集器會繼承基底收集器的所有屬性。 如需詳細資訊，請參閱繼承。

範例

下列程式碼範例會定義事件收集器，每個緩衝區 128 KB 為 64 個。

<EventCollector
  Id="WPREventCollector"
  Name="WPR Event Collector"
  FileName="somefilename.etl"> 
  <BufferSize
    Value="128"/> 
  <Buffers
    Value="64"/>
</EventCollector>

相關主題

元素