Buffers

Artigo
07/17/2024

Descreve o número de buffers a serem alocados ao iniciar uma sessão ou o percentual da memória total a ser alocada para a sessão, dependendo do valor do atributo PercentageOfTotalMemory .

Hierarquia de elementos

< WindowsPerformanceRecorder>
- < Perfis>
  - < SystemCollector>
    - < Buffers>
  - < EventCollector>
    - < Buffers>
  - < HeapEventCollector>
    - < Buffers>
  - < Perfil>
    - < Colecionadores>
      - < SystemCollectorId>
        
        < Buffers>
      - < EventCollectorId>
        
        < Buffers>
      - < HeapEventCollectorId>
        
        < Buffers>

Syntax

<Buffers Operation               = "Set" | "Add" | “Remove”
         Value                   = unsignedLong
         PercentageOfTotalMemory = Boolean
         MaximumBufferSpace      = unsignedLong >
</Buffers>

Atributos e elementos

Atributos

Atributo	Descrição	Tipo de dados	Obrigatório	Padrão
MaximumBufferSpace	Indica o tamanho máximo do buffer, em megabytes, que será usado para coleção. Esse valor só se aplica quando PercentageOfTotalMemory é `true`.	unsignedLong	Não
Operação	Indica se os buffers devem ser definidos ou adicionados.	Esse atributo pode ter um dos seguintes valores: Definir Adicionar Remover	Não	Definir
PercentageOfTotalMemory	Quando definido `true`como , limita a quantidade de memória que pode ser consumida ao valor de Value.	Boolean	Não	false
Valor	Indica o número de buffers ou se PercentageOfTotalMemory está definido `true`como , o percentual de memória para os buffers.	unsignedLong	Sim

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 de heap.
HeapEventCollectorId	Representa um identificador de coletor de eventos de heap.
SystemCollector	Representa um coletor de sistema.
SystemCollectorId	Representa um identificador do coletor do sistema.

Comentários

Esse elemento é usado apenas para captura na memória.

Exemplo

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

O primeiro exemplo define o tamanho do buffer como 512 KB e limita a quantidade total de memória consumida a 3%. O segundo exemplo define 64 buffers de 128 KB cada.

<SystemCollector
  Id="WPRSystemCollector"
  Name="NT Kernel Logger"
  FileName="WPRKernel.etl">
  <BufferSize
    Value="512"/> 
  <Buffers
    Value="3"
    PercentageOfTotalMemory="true"/>
</SystemCollector>

<EventCollector
  Id="WPREventCollector"
  Name="WPR Event Collector"
  FileName="somefilename.etl">
  <BufferSize
    Value="128"/>
  <Buffers
    Value="64"/>
</EventCollector>