EventCollector
Représente un collecteur d’événements pour le profil.
Hiérarchie d’éléments
-
<
WindowsPerformanceRecorder>
-
<
Profils>
- < EventCollector>
-
<
Profils>
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>