Buffer

Articolo
07/17/2024

Descrive il numero di buffer da allocare all'avvio di una sessione o la percentuale di memoria totale da allocare per la sessione, a seconda del valore dell'attributo PercentageOfTotalMemory .

Gerarchia degli elementi

< WindowsPerformanceRecorder>
- < Profili>
  - < SystemCollector>
    - < Buffer>
  - < EventCollector>
    - < Buffer>
  - < HeapEventCollector>
    - < Buffer>
  - < Profilo>
    - < Collezionisti>
      - < SystemCollectorId>
        
        < Buffer>
      - < EventCollectorId>
        
        < Buffer>
      - < HeapEventCollectorId>
        
        < Buffer>

Sintassi

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

Attributi ed elementi

Attributi

Attributo	Descrizione	Tipo di dati	Richiesto	Predefinito
MaximumBufferSpace	Indica la dimensione massima del buffer, in megabyte, che verrà utilizzata per la raccolta. Questo valore si applica solo quando PercentageOfTotalMemory è `true`.	unsignedLong	No
Operazione	Indica se i buffer devono essere impostati o aggiunti.	Questo attributo può avere uno dei valori seguenti: Set Add Rimuovi	No	Set
PercentageOfTotalMemory	Se impostato su `true`, limita la quantità di memoria che può essere utilizzata al valore di Value.	Boolean	No	false
Valore	Indica il numero di buffer o se PercentageOfTotalMemory è impostato su `true`, la percentuale di memoria per i buffer.	unsignedLong	Sì

Elementi figlio

Nessuno.

Elementi padre

Elemento	Descrizione
EventCollector	Rappresenta un agente di raccolta eventi.
EventCollectorId	Rappresenta un identificatore dell'agente di raccolta eventi.
HeapEventCollector	Rappresenta un agente di raccolta eventi heap.
HeapEventCollectorId	Rappresenta un identificatore dell'agente di raccolta eventi heap.
SystemCollector	Rappresenta un agente di raccolta di sistema.
SystemCollectorId	Rappresenta un identificatore dell'agente di raccolta di sistema.

Commenti

Questo elemento viene usato solo per l'acquisizione in memoria.

Esempio

Negli esempi seguenti viene illustrato come viene usato questo elemento nelle definizioni dell'agente di raccolta eventi e dell'agente di raccolta eventi di sistema.

Il primo esempio imposta la dimensione del buffer su 512 KB e limita la quantità totale di memoria utilizzata al 3%. Il secondo esempio imposta 64 buffer di 128 KB ciascuno.

<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>