Partager via


EventCollector

Représente un collecteur d’événements pour le profil.

Hiérarchie d’éléments

Syntaxe

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

Attributs et éléments

Attributs

Attribut Description Type de données Obligatoire Default
Id Identifie de manière unique le collecteur d’événements. Chaîne qui doit avoir au moins un caractère et ne peut pas contenir de deux-points (:) ou espaces. Oui
Base Identifie la base du collecteur d’événements. string Non
Nom Indique le nom de la session ETW. string Oui
FileName Indique le fichier dans lequel journaliser les événements. string Oui
Realtime Indique si le collecteur d’événements fonctionne en temps réel. boolean Non false
Privé Si la valeur est « true », indique une session en mode utilisateur qui s’exécute dans le même processus que son fournisseur d’événements. Si la valeur est « false », indique une session globale en mode utilisateur. boolean Non false
ProcessPrivate Si la valeur est « true », indique une session en mode utilisateur qui s’exécute dans le même processus que son fournisseur d’événements et doit être contrôlée uniquement par le processus qui a inscrit le fournisseur. Si la valeur est « false », indique une session globale en mode utilisateur. Utilisez cet attribut conjointement avec l’attribut Private . boolean Non false
Sécurisé Si la valeur est « true », indique que seuls les utilisateurs disposant de privilèges d’administration et de droits d’accès appropriés peuvent contrôler la session. Si la valeur est « false », indique que tous les utilisateurs peuvent contrôler la session. boolean Non false

Éléments enfants

Élément Description Condition requise Default
BufferSize Décrit la taille de chaque mémoire tampon, en Ko. Facultatif, 1. 128
Mémoires tampons Décrit le nombre de mémoires tampons à allouer au démarrage d’une session. Facultatif, 1. 64
StackCaching Décrit les attributs de mise en cache de pile des collecteurs. Facultatif, 1.
MaximumFileSize Décrit la taille maximale du fichier de trace. Facultatif, 1.
FileMax Décrit le nombre maximal d’instances du fichier journal créé par ETW pour la trace Autologger. Facultatif, 1.

Éléments parents

Élément Description
Profils Représente une collection de collecteurs, de fournisseurs et de profils.

Notes

Les définitions du collecteur système doivent précéder les définitions du collecteur d’événements.

Les collecteurs dérivés héritent de tous les attributs du collecteur de base, sauf s’ils sont explicitement spécifiés dans le collecteur dérivé. Pour plus d’informations, consultez Héritage.

Exemple

L’exemple de code suivant définit un collecteur d’événements avec 64 mémoires tampons de 128 Ko chacune.

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

Éléments