Suivi d’événements

Objectif

Le suivi d’événements pour Windows (ETW) offre aux programmeurs d’applications la possibilité de démarrer et d’arrêter des sessions de suivi d’événements, d’instrumenter une application pour fournir des événements de trace et d’utiliser 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, consultez Suivi logiciel WPP et ajout de suivi d’événements à des pilotes Kernel-Mode dans le Kit de pilotes Windows (WDK).

Le cas échéant

Utilisez ETW lorsque vous souhaitez instrumenter votre application, journaliser les événements utilisateur ou 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 du 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 en tant que 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 ajoutées au suivi d’événements dans chaque version.
À propos du suivi d’événements	Informations générales sur le suivi d’événements.
Utilisation du suivi d’événements	Rubriques liées aux tâches qui décrivent comment utiliser l’API ETW.
Informations de référence sur le suivi d’événements	Descriptions détaillées des fonctions ETW et d’autres éléments de programmation.