MaximumFileSize

Artículo
06/20/2023

Establece el tamaño máximo del archivo de seguimiento (.etl). Si el FileMode atributo es Sequential el seguimiento se detiene cuando el tamaño del archivo alcanza el tamaño especificado. Si el FileMode atributo es Circular, el archivo mantiene los eventos más recientes.

Jerarquía de elementos

<WindowsPerformanceRecorder>
- <Perfiles>
  - <SystemCollector>
    - <MaximumFileSize>
  - <EventCollector>
    - <MaximumFileSize>
  - <HeapEventCollector>
    - <MaximumFileSize>
  - <HypervisorEventCollector>
    - <MaximumFileSize>
  - <Perfil>
    - <Coleccionistas>
      - <SystemCollectorId>
        
        <MaximumFileSize>
      - <EventCollectorId>
        
        <MaximumFileSize>
      - <HeapEventCollectorId>
        
        <MaximumFileSize>
      - <HypervisorEventCollectorId>
        
        <MaximumFileSize>

Sintaxis

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

Atributos y elementos

Atributos

Atributo	Descripción	Tipo de datos	Obligatorio	Valor predeterminado
operación	Indica si MaximumFileSize se debe establecer o agregar.	Este atributo puede tener uno de los siguientes valores: Set Sumar Quitar	No	Set
Valor	Indica el número de MaximumFileSize en MB.	unsignedLong	Sí
FileMode	Cuando se establece en `Sequential` el seguimiento se detiene cuando alcanza el tamaño especificado.	String	No	Circular

Elementos secundarios

Ninguno.

Elementos primarios

Elemento	Descripción
EventCollector	Representa un recopilador de eventos.
EventCollectorId	Representa un identificador del recopilador de eventos.
HeapEventCollector	Representa un recopilador de eventos del montón.
HeapEventCollectorId	Representa un identificador del recopilador de eventos del montón.
SystemCollector	Representa un recopilador del sistema.
SystemCollectorId	Representa un identificador del recopilador del sistema.
HipervisorCollector	Representa un recopilador de hipervisores.
HypervisorCollectorId	Representa un identificador del recopilador de hipervisor.

Comentarios

Este elemento solo se usa para la captura del modo de archivo.

Ejemplo

En los ejemplos siguientes se muestra cómo se usa este elemento en las definiciones del recopilador de eventos.

En el ejemplo se establecen 40 búferes de 128 KB cada uno y el tamaño máximo de archivo en 100 MB. La sesión de seguimiento no se detendrá cuando el tamaño del archivo alcance 100 MB manteniendo los datos de eventos más recientes.

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

HypervisorEventCollector