Suivi d’événements

Objectif

Suivi d’v nements pour Windows (ETW) fournit aux programmeurs d’applications la possibilité de démarrer et d’arrêter les sessions de suivi d’événements, d’instrumenter une application pour fournir des événements de trace et de consommer des événements de trace. Les événements de trace contiennent un en-tête d’événement et des données définies par le fournisseur qui décrivent l’état actuel d’une application ou d’une opération. Vous pouvez utiliser les événements pour déboguer une application et effectuer une analyse de la capacité et des performances.

Cette documentation est destinée aux applications en mode utilisateur qui souhaitent utiliser ETW. pour plus d’informations sur l’instrumentation des pilotes de périphérique qui s’exécutent en mode noyau, voir WPP Software tracing et ajout d’Event tracing to Kernel-Mode drivers in the Windows Driver Kit (WDK).

Le cas échéant

Utilisez ETW lorsque vous souhaitez instrumenter votre application, consigner des événements utilisateur ou de noyau dans un fichier journal, et consommer des événements à partir d’un fichier journal ou en temps réel.

Développeurs concernés

ETW est conçu pour les développeurs C et C++ qui écrivent des applications en mode utilisateur.

Conditions d’exécution

ETW est inclus dans Microsoft Windows 2000 et versions ultérieures. Pour plus d’informations sur les systèmes d’exploitation requis pour utiliser une fonction particulière, consultez la section Configuration requise de la documentation relative à la fonction.

Traiter les traces ETW dans le code .NET

Vous pouvez utiliser l' API .net TraceProcessing pour analyser les traces ETW pour vos applications et d’autres composants logiciels. cette API est utilisée en interne chez Microsoft pour analyser les données ETW produites par le système d’ingénierie Windows, et elle est également utilisée pour alimenter plusieurs tables dans Windows analyseur de performances. cette API est disponible sous la forme d’un package NuGet.

Pour plus d’informations, consultez cet article.

Contenu de cette section

Rubrique Description
Nouveautés du suivi d’événements
Nouvelles fonctionnalités qui ont été ajoutées au suivi d’événements dans chaque version.
À propos du suivi d’événements
Informations générales sur le suivi des événements.
Utilisation du suivi d’événements
Rubriques relatives aux tâches qui décrivent comment utiliser l’API ETW.
Référence de suivi d’événements
Description détaillée des fonctions ETW et d’autres éléments de programmation.