Activation et affichage des traces WDTF

2025-04-17

WdTF Tracing fait référence aux événements rapportés qui se produisent en interne au sein des objets WDTF. Étant donné que WDTF est fortement instrumenté, tous les objets WDTF fournissent des informations de traçage lors de leur exécution. WDTF gère le suivi à l’aide du suivi logiciel WPP. Ce type de suivi est un format standardisé que vous pouvez lire à l’aide d’outils WDK, y compris TraceView. Cette rubrique explique comment utiliser Logman et Tracefmt pour afficher les traces d’exécution WDTF. Cette rubrique explique également comment configurer par programme les niveaux de trace WDTF.

Comment collecter et enregistrer des traces WDTF

Pour commencer à collecter des traces WDTF

Sur l’ordinateur de test, ouvrez une fenêtre d’invite de commandes avec des privilèges élevés (Exécuter en tant qu’administrateur) et entrez les commandes suivantes :

logman.exe create trace "autosession\WDTF" -p {6210f559-c7f7-4d2f-b674-4bc9315cecc7} 0xffffffff 0xff -o c:\WDTF_Traces\TraceFile.etl
reg add HKLM\SYSTEM\CurrentControlSet\Control\WMI\Autologger\WDTF /v LogFileMode /t REG_DWORD /d 1 /f
reg add HKLM\SYSTEM\CurrentControlSet\Control\WMI\Autologger\WDTF /v FileMax /t REG_DWORD /d 16 /f
reg add HKLM\SYSTEM\CurrentControlSet\Control\WMI\Autologger\WDTF /v MaxFileSize /t REG_DWORD /d 0 /f

Redémarrez l'ordinateur.

Pour plus d’informations sur d’autres options, consultez Logman (Logman.exe). Pour plus d’informations sur la création d’une saison de trace, consultez Configuration et démarrage d’une session d’autologger.

Pour arrêter la collecte des traces WDTF et enregistrer les fichiers journaux

Vous pouvez arrêter la collecte des traces WDTF et supprimer le collecteur de données avec les commandes suivantes :
```
logman.exe -stop -ets WDTF
logman.exe delete "autosession\WDTF"
```
Redémarrez l'ordinateur.
Copiez les fichiers journaux de l’ordinateur de test vers un autre ordinateur pour une analyse ultérieure.

Les fichiers journaux ETL collectés peuvent être très volumineux. Pour obtenir de meilleurs résultats, copiez les fichiers journaux de l’ordinateur de test (par exemple, c :\WDTF_Traces\TraceFile.etl) sur un autre ordinateur. Vous pouvez ensuite supprimer les fichiers journaux de l’ordinateur de test.

Comment afficher les traces WDTF

L’affichage des traces WDTF nécessite la mise en forme des fichiers ETL. Les étapes suivantes montrent comment utiliser Tracefmt.exe pour convertir les fichiers ETL en fichiers texte ou CSV.

Pour afficher les traces WDTF

Par exemple, la commande suivante convertit le fichier ETL qui a été enregistré en tant que c :\WDTF_Traces\TraceFile.etl en texte.
```
Tracefmt.exe –r http://msdl.microsoft.com/download/symbols c:\WDTF_Traces\TraceFile.etl -o OutputTxtFile.txt
```
La commande suivante convertit le fichier ETL qui a été enregistré en tant que c :\WDTF_Traces\TraceFile.etl en fichier séparé par des virgules (CSV).
```
Tracefmt.exe –r http://msdl.microsoft.com/download/symbols c:\WDTF_Traces\TraceFile.etl -csv –o OutputCsvFile.csv
```
Ouvrez les fichiers CSV dans Microsoft Excel pour pouvoir utiliser des fonctionnalités de filtrage d’Excel pour filtrer les traces collectées. Vous pouvez filtrer les traces pendant certaines périodes. Vous pouvez filtrer les traces pour examiner celles enregistrées par certains composants WDTF.

Configuration programmatique des niveaux de trace WDTF

Tous les objets WDTF fournissent des informations de suivi à mesure qu’ils s’exécutent.

WDTF fournit un ensemble de niveaux TTraceLevel configurables. Pour plus d’informations sur la définition de TTraceLevel d’une instance d’objet spécifique au moment de l’exécution, consultez la méthode ITracing ::SetTraceLevel .

Pour plus d’informations sur la définition du TTraceLevel par défaut pour une interface, consultez la référence de l’infrastructure de test d’appareil Windows.

Pour obtenir une description détaillée des types de traces inclus dans chaque TTraceLevel, consultez l’interface ITracer . Vous pouvez configurer ces niveaux globalement en utilisant le chemin TraceLevel du registre ITracer.

Le tableau suivant décrit les niveaux de trace que vous pouvez définir.

Niveau	Description
0	désactivé. Aucun suivi n’est fourni.
1	Faible
2	Moyen. Ce niveau est le niveau par défaut du suivi.
3	Élevé
4	Complet. Toutes les informations de suivi sont signalées.
5-8	Niveaux personnalisés.
9	Rétablit l'objet à son niveau de trace initial.

Lorsque vous déboguez à l’aide du contenu de trace, envisagez de définir les niveaux de trace sur 1 pour tous les objets, puis de définir des niveaux de trace beaucoup plus élevés pour les objets que vous examinez.

Pour plus d’informations sur les niveaux de trace, consultez l’interface ITracer .

Configuration et démarrage d’une session AutoLogger
Logman
Tracefmt
TraceView
Suivi logiciel avec WPP

Partager via