MaximumFileSize

Artigo
07/17/2024

Define o tamanho máximo do arquivo de rastreamento (.etl). Se o FileMode atributo for Sequential o rastreamento for interrompido quando o tamanho do arquivo atingir o tamanho especificado. Se o FileMode atributo for Circular, o arquivo manterá os eventos mais recentes.

Hierarquia de elementos

< WindowsPerformanceRecorder>
- < Perfis>
  - < SystemCollector>
    - < Maximumfilesize>
  - < EventCollector>
    - < Maximumfilesize>
  - < HeapEventCollector>
    - < Maximumfilesize>
  - < HypervisorEventCollector>
    - < Maximumfilesize>
  - < Perfil>
    - < Colecionadores>
      - < SystemCollectorId>
        
        < Maximumfilesize>
      - < EventCollectorId>
        
        < Maximumfilesize>
      - < HeapEventCollectorId>
        
        < Maximumfilesize>
      - < HypervisorEventCollectorId>
        
        < Maximumfilesize>

Syntax

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

Atributos e elementos

Atributos

Atributo	Descrição	Tipo de dados	Obrigatório	Padrão
Operação	Indica se MaximumFileSize deve ser definido ou adicionado.	Esse atributo pode ter um dos seguintes valores: Definir Adicionar Remover	Não	Definir
Valor	Indica o número de MaximumFileSize em MB.	unsignedLong	Sim
FileMode	Quando definido como `Sequential` o rastreamento é interrompido quando atinge o tamanho determinado.	String	Não	Circular

Elementos filho

Nenhum.

Elementos pai

Elemento	Descrição
EventCollector	Representa um coletor de eventos.
EventCollectorId	Representa um identificador do coletor de eventos.
HeapEventCollector	Representa um coletor de eventos heap.
HeapEventCollectorId	Representa um identificador de coletor de eventos heap.
SystemCollector	Representa um coletor de sistema.
SystemCollectorId	Representa um identificador do coletor do sistema.
HipervisorCollector	Representa um coletor de hipervisor.
HypervisorCollectorId	Representa um identificador de coletor de hipervisor.

Comentários

Esse elemento é usado apenas para captura do modo de arquivo.

Exemplo

Os exemplos a seguir mostram como esse elemento é usado em definições de coletor de eventos.

O exemplo define 40 buffers de 128 KB cada e o tamanho máximo do arquivo como 100 MB. A sessão de rastreamento não será interrompida quando o tamanho do arquivo atingir 100 MB mantendo os dados de evento mais recentes.

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

HypervisorEventCollector