MaximumFileSize

设置跟踪文件的最大文件大小 (.etl) 。 FileMode如果 属性为 Sequential ，则当文件大小达到给定大小时，跟踪将停止。 FileMode如果 属性为 Circular，则文件保留最新事件。

元素层次结构

• <WindowsPerformanceRecorder>
  • <Profiles>
    • <SystemCollector>
      • <MaximumFileSize>
    • <EventCollector>
      • <MaximumFileSize>
    • <HeapEventCollector>
      • <MaximumFileSize>
    • <HypervisorEventCollector>
      • <MaximumFileSize>
    • <Profile>
      • <Collectors>
        • <SystemCollectorId>
          • <MaximumFileSize>
        • <EventCollectorId>
          • <MaximumFileSize>
        • <HeapEventCollectorId>
          • <MaximumFileSize>
        • <HypervisorEventCollectorId>
          • <MaximumFileSize>

语法

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

特性和元素

特性

属性	说明	数据类型	必须	默认
操作	指示应设置还是添加 MaximumFileSize。	此属性可以具有以下值之一： 设置 添加 删除	否	设置
值	指示 MaximumFileSize 的数量（以 MB 为单位）。	unsignedLong	是
FileMode	设置为 Sequential 时，跟踪在达到给定大小时停止。	字符串	否	环形

子元素

无。

父元素

元素	说明
EventCollector	表示事件收集器。
EventCollectorId	表示事件收集器标识符。
HeapEventCollector	表示堆事件收集器。
HeapEventCollectorId	表示堆事件收集器标识符。
SystemCollector	表示系统收集器。
SystemCollectorId	表示系统收集器标识符。
HypervisorCollector	表示虚拟机监控程序收集器。
HypervisorCollectorId	表示虚拟机监控程序收集器标识符。

备注

此元素仅用于文件模式捕获。

示例

以下示例演示如何在事件收集器定义中使用此元素。

该示例将 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>

相关主题

元素

SystemCollector

EventCollector

HeapEventCollector

HypervisorEventCollector