Freigeben über

EventCollector

  • Artikel

Stellt eine Ereignissammlung für das Profil dar.

Elementhierarchie

Syntax

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

Attribute und Elemente

Attribute

attribute BESCHREIBUNG Datentyp Erforderlich Standard
Id Identifiziert den Ereignissammler eindeutig. Zeichenfolge, die mindestens ein Zeichen haben muss und keine Doppelpunkte (:) oder Leerzeichen enthalten darf. Ja
Base Identifiziert die Basis der Ereignissammlung. Zeichenfolge Nein
Name Gibt den Namen der ETW-Sitzung an. Zeichenfolge Ja
FileName Gibt die Datei an, in der Ereignisse protokolliert werden sollen. Zeichenfolge Ja
Realtime Gibt an, ob die Ereignissammlung in Echtzeit ausgeführt wird. boolean Nein false
Privat Bei „true“ handelt es sich um eine Sitzung im Benutzermodus, die in demselben Prozess wie der Ereignisanbieter läuft. Bei „false“ handelt es sich um eine globale Sitzung im Benutzermodus. boolean Nein false
ProcessPrivate Bei „true“ handelt es sich um eine Sitzung im Benutzermodus, die in demselben Prozess wie der Ereignisanbieter läuft und nur von dem Prozess kontrolliert werden sollte, der den Anbieter registriert hat. Bei „false“ handelt es sich um eine globale Sitzung im Benutzermodus. Verwenden Sie dieses Attribut in Verbindung mit dem Attribut Private. boolean Nein false
Sicher Wenn auf „true“ festgelegt, gibt es an, dass nur Benutzer mit Administratorrechten und ordnungsgemäßen Zugriffsrechten die Sitzung steuern können. Bei „false“ können alle Benutzer die Sitzung steuern. boolean Nein false

Untergeordnete Elemente

Element BESCHREIBUNG Anforderung Standard
BufferSize Beschreibt die Größe jedes Puffers in KB. Optional, 1. 128
Puffer Beschreibt die Anzahl der Puffer, die beim Starten einer Sitzung zugewiesen werden sollen. Optional, 1. 64
StackCaching Beschreibt Stapel-Zwischenspeichern-Attribute von Kollektoren. Optional, 1.
MaximumFileSize Beschreibt die maximale Größe der Ablaufverfolgungsdatei. Optional, 1.
FileMax Beschreibt die maximale Anzahl von Instanzen der Protokolldatei, die ETW für die Autologger-Ablaufverfolgung erstellt. Optional, 1.

Übergeordnete Elemente

Element Beschreibung
Profiles Stellt eine Sammlung von Sammlern, Anbietern und Profilen dar.

Bemerkungen

Systemsammlerdefinitionen müssen Ereignissammlerdefinitionen vorausgehen.

Abgeleitete Sammler erben alle Attribute des Basissammlers, es sei denn, sie werden in dem abgeleiteten Sammlungsobjekt explizit angegeben. Weitere Informationen finden Sie unter Vererbung.

Beispiel

Im folgenden Codebeispiel wird ein Ereignissammler mit 64 Puffern von 128 KB definiert.

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

Elemente