FileMax

Article
08/17/2022

The maximum number of instances of the log file that ETW creates. This element applies to the file mode autologger configuration only. For more information about FileMax, refer to Configuring and Starting an AutoLogger Session

Element Hierarchy

<WindowsPerformanceRecorder>
- <Profiles>
  - <SystemCollector>
    - <FileMax>
  - <EventCollector>
    - <FileMax>
  - <HeapEventCollector>
    - <FileMax>
  - <HypervisorEventCollector>
    - <FileMax>
  - <Profile>
    - <Collectors>
      - <SystemCollectorId>
        
        <FileMax>
      - <EventCollectorId>
        
        <FileMax>
      - <HeapEventCollectorId>
        
        <FileMax>
      - <HypervisorEventCollectorId>
        
        <FileMax>

Syntax

<FileMax Operation               = "Set" | "Add" | “Remove”
         Value                   = unsignedLong>
</FileMax>

Attributes and Elements

Attributes

Attribute	Description	Data type	Required	Default
Operation	Indicates whether FileMax should be set or added.	This attribute can have one of the following values: Set Add Remove	No	Set
Value	Indicates the maximum number of instances of the log file that ETW creates. Maximum value is 16.	unsignedLong	Yes

Child Elements

None.

Parent Elements

Element	Description
EventCollector	Represents an event collector.
EventCollectorId	Represents an event collector identifier.
HeapEventCollector	Represents a heap event collector.
HeapEventCollectorId	Represents a heap event collector identifier.
SystemCollector	Represents a system collector.
SystemCollectorId	Represents a system collector identifier.
HypervisorCollector	Represents a hypervisor collector.
HypervisorCollectorId	Represents a hypervisor collector identifier.

Remarks

This element is used only for file mode recording.

Example

The following examples show how this element is used in event collector definitions.

When you set up the autologger with this EventCollector, ETW will create the trace file with different file name at every boot, for example <sessionname>.etl.0001. The maximum instances of the files are five.

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

HypervisorEventCollector