EventCollector

  • Articolo

Rappresenta un agente di raccolta eventi per il profilo.

Gerarchia degli elementi

Sintassi

<EventCollector Id             = IdType
                Base           = string
                Name           = string
                FileName       = string
                Realtime       = boolean
                Private        = boolean
                ProcessPrivate = boolean
                Secure         = boolean>

  <!-- Child elements -->
  BufferSize,
  Buffers,
  StackCaching,
  MaximumFileSize,
  FileMax,
  FlushTimer,
  FlushThreshold
</EventCollector>

Attributi ed elementi

Attributi

Attributo Descrizione Tipo di dati Richiesto Predefinito
Id Identifica in modo univoco l'agente di raccolta eventi. Stringa che deve avere almeno un carattere e non può contenere due punti (:) o spazi. Sì
Base Identifica la base dell'agente di raccolta eventi. string No
Nome Indica il nome della sessione ETW. string Sì
FileName Indica il file a cui registrare gli eventi. string Sì
Realtime Indica se l'agente di raccolta eventi opera in tempo reale. boolean No false
Privata Se impostato su "true", indica una sessione in modalità utente eseguita nello stesso processo del provider di eventi. Se impostato su "false", indica una sessione in modalità utente globale. boolean No false
ProcessPrivate Se impostato su "true", indica una sessione in modalità utente eseguita nello stesso processo del provider di eventi e deve essere controllata solo dal processo registrato dal provider. Se impostato su "false", indica una sessione in modalità utente globale. Usare questo attributo insieme all'attributo Private . boolean No false
Sicuro Se impostato su "true", indica che solo gli utenti con privilegi amministrativi e diritti di accesso appropriati possono controllare la sessione. Se impostato su "false", indica che tutti gli utenti possono controllare la sessione. boolean No false

Elementi figlio

Elemento Descrizione Requisito Predefinito
BufferSize Descrive le dimensioni di ogni buffer, in KB. Facoltativo, 1. 128
Buffer Descrive il numero di buffer da allocare all'avvio di una sessione. Facoltativo, 1. 64
StackCaching Descrive gli attributi di memorizzazione nella cache dello stack degli agenti di raccolta. Facoltativo, 1.
Maximumfilesize Descrive le dimensioni massime del file di traccia. Facoltativo, 1.
FileMax Descrive il numero massimo di istanze del file di log creato da ETW per la traccia di Autologger. Facoltativo, 1.

Elementi padre

Elemento Descrizione
Profili Rappresenta una raccolta di agente di raccolta, provider e profili.

Commenti

Le definizioni dell'agente di raccolta di sistema devono precedere le definizioni dell'agente di raccolta eventi.

Gli agenti di raccolta derivati ereditano tutti gli attributi dell'agente di raccolta di base, a meno che non siano specificati in modo esplicito nell'agente di raccolta derivata. Per altre informazioni, vedere Ereditarietà.

Esempio

L'esempio di codice seguente definisce un agente di raccolta eventi con 64 buffer di 128 KB ciascuno.

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

Elementi