MaximumFileSize

發行項
07/17/2024

設定追蹤檔案的大小上限， (.etl) 。如果屬性 FileMode 是 Sequential 追蹤，當檔案大小達到指定大小時停止。 FileMode如果屬性為 Circular ，則檔案會保留最新的事件。

元素階層

< WindowsPerformanceRecorder>
- < 配置檔>
  - < SystemCollector>
    - < MaximumFileSize>
  - < EventCollector>
    - < MaximumFileSize>
  - < HeapEventCollector>
    - < MaximumFileSize>
  - < HypervisorEventCollector>
    - < MaximumFileSize>
  - < 配置檔>
    - < 收藏家>
      - < SystemCollectorId>
        
        < MaximumFileSize>
      - < EventCollectorId>
        
        < MaximumFileSize>
      - < HeapEventCollectorId>
        
        < MaximumFileSize>
      - < HypervisorEventCollectorId>
        
        < MaximumFileSize>

Syntax

<MaximumFileSize Operation               = "Set" | "Add" | “Remove”
         Value                   = unsignedLong
         FileMode = "Circular" | "Sequential">
</MaximumFileSize>

屬性和項目

屬性

屬性	描述	資料類型	必要	預設
運算	指出是否應該設定或新增 MaximumFileSize。	此屬性可以有下列其中一個值：集合加移除	No	集合
值	指出 MB 的 MaximumFileSize 數目。	unsignedLong	Yes
FileMode	當設定為 `Sequential` 追蹤到達指定大小時停止時。	String	No	圓形

子元素

無。

父項目

元素	描述
EventCollector	表示事件收集器。
EventCollectorId	表示事件收集器識別碼。
HeapEventCollector	表示堆積事件收集器。
HeapEventCollectorId	表示堆積事件收集器識別碼。
SystemCollector	表示系統收集器。
SystemCollectorId	表示系統收集器識別碼。
HypervisorCollector	表示 Hypervisor 收集器。
HypervisorCollectorId	表示 Hypervisor 收集器識別碼。

備註

這個專案僅用於檔案模式擷取。

範例

下列範例示範如何在事件收集器定義中使用這個專案。

此範例會將 40 個緩衝區設定為 128 KB，並將檔案大小上限設定為 100 MB。當檔案大小達到 100 MB 時，追蹤會話不會藉由保留最新的事件資料來停止。

<EventCollector Id="EventCollector_MultimediaEx" Name="WPDiet MultimediaEx">
  <BufferSize Value="128"/>
  <Buffers Value="40"/>
  <MaximumFileSize Value="100" FileMode="Circular"/>
</EventCollector>

HypervisorEventCollector