Partager via

Activation et affichage des traces WDTF

  • Article

Le suivi WDTF fait référence aux événements de création de rapports qui se produisent en interne dans des objets WDTF. Étant donné que WDTF est fortement instrumenté, tous les objets WDTF fournissent des informations de suivi au fur et à mesure 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 des 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 programmation les niveaux de trace WDTF.

Comment collecter et enregistrer des traces WDTF

Pour commencer à collecter des traces WDTF

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

  2. Redémarrez l'ordinateur.

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

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

  1. 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"

  2. Redémarrez l'ordinateur.

  3. 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 de très grande taille. 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

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

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

  3. Ouvrez les fichiers CSV dans Microsoft Excel afin de pouvoir utiliser les fonctionnalités de filtrage d’Excel pour filtrer les traces collectées. Vous pouvez filtrer les traces pour certaines périodes. Vous pouvez filtrer les traces pour examiner les traces journalisées par certains composants WDTF.

Configuration programmatique des niveaux de trace WDTF

Tous les objets WDTF fournissent des informations de suivi au fur et à mesure de leur exécution.

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

Pour plus d’informations sur la façon de définir le TTraceLevel par défaut pour une interface, consultez la référence de Windows Device Testing Framework.

Pour obtenir une description détaillée des types de traces inclus dans chaque TTraceLevel, consultez l’interface ITracer . Vous pouvez configurer ces niveaux vous-même à l’aide du chemin TraceLevel du registre ITracer.

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

Level Description
0 désactivé. Aucun suivi n’est fourni.
1 Faible
2 Moyenne. 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 le niveau de trace initial de l’objet.

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 WPP