Abilitazione e visualizzazione di tracce WDTF

  • Articolo

La traccia WDTF fa riferimento a eventi che si verificano internamente all'interno degli oggetti WDTF. Poiché WDTF è fortemente instrumentato, tutti gli oggetti WDTF forniscono informazioni di traccia durante l'esecuzione. WDTF gestisce la traccia usando WPP Software Tracing. Questo tipo di traccia è un formato standardizzato che è possibile leggere usando gli strumenti WDK, tra cui TraceView. Questo argomento illustra come usare Logman e Tracefmt per visualizzare le tracce di runtime WDTF. Questo argomento illustra anche come configurare a livello di codice i livelli di traccia WDTF.

Come raccogliere e salvare le tracce WDTF

Per iniziare a raccogliere tracce WDTF

  1. Nel computer di test aprire una finestra del prompt dei comandi con privilegi elevati (Esegui come amministratore) e immettere i comandi seguenti:

    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. Riavviare il computer.

Per informazioni su altre opzioni, vedere Logman (Logman.exe). Per informazioni sulla creazione di una stagione di traccia, vedere Configurazione e avvio di una sessione autoLogger.

Per interrompere la raccolta di tracce WDTF e salvare i file di log

  1. È possibile interrompere la raccolta di tracce WDTF ed eliminare l'agente di raccolta dati con i comandi seguenti:

    logman.exe -stop -ets WDTF
logman.exe delete "autosession\WDTF"

  2. Riavviare il computer.

  3. Copiare i file di log dal computer di test a un altro computer per un'analisi successiva.

    I file di log ETL raccolti possono essere molto grandi. Per ottenere risultati ottimali, copiare i file di log dal computer di test( ad esempio c:\WDTF_Traces\TraceFile.etl) in un altro computer. È quindi possibile eliminare i file di log dal computer di test.

Come visualizzare le tracce WDTF

La visualizzazione di tracce WDTF richiede la formattazione dei file ETL. La procedura seguente illustra come usare Tracefmt.exe per convertire i file ETL in file di testo o CSV.

Per visualizzare le tracce WDTF

  1. Ad esempio, il comando seguente converte il file ETL salvato come c:\WDTF_Traces\TraceFile.etl nel testo.

    Tracefmt.exe –r http://msdl.microsoft.com/download/symbols c:\WDTF_Traces\TraceFile.etl -o OutputTxtFile.txt

  2. Il comando seguente converte il file ETL salvato come c:\WDTF_Traces\TraceFile.etl in file delimitato da virgole (CSV).

    Tracefmt.exe –r http://msdl.microsoft.com/download/symbols c:\WDTF_Traces\TraceFile.etl -csv –o OutputCsvFile.csv

  3. Aprire i file CSV in Microsoft Excel in modo da poter usare le funzionalità di filtro di Excel per filtrare le tracce raccolte. È possibile filtrare le tracce per determinati periodi di tempo. È possibile filtrare le tracce per esaminare le tracce registrate da determinati componenti WDTF.

Configurazione a livello di codice dei livelli di traccia WDTF

Tutti gli oggetti WDTF forniscono informazioni di traccia durante l'esecuzione.

WDTF offre un set di livelli TTraceLevel configurabili. Per informazioni su come impostare TTraceLevel di un'istanza di oggetto specifica in fase di esecuzione, vedere il metodo ITracing::SetTraceLevel .

Per informazioni su come impostare il TTraceLevel predefinito per un'interfaccia, vedere Informazioni di riferimento su Windows Device Testing Framework.

Per una descrizione dettagliata dei tipi di tracce incluse in ogni TTraceLevel, vedere l'interfaccia ITracer . È possibile configurare questi livelli a livello globale usando il percorso TraceLevel del Registro di sistema ITracer.

La tabella seguente descrive i livelli di traccia che è possibile impostare.

Level Descrizione
0 Disattiva. Non viene fornita alcuna traccia.
1 Basso
2 Media. Questo livello è il livello predefinito di traccia.
3 Alto
4 Modello di recupero con registrazione completa. Vengono segnalate tutte le informazioni di traccia.
5-8 Livelli personalizzati.
9 Imposta nuovamente l'oggetto sul relativo livello di traccia iniziale.

Quando si esegue il debug usando il contenuto di traccia, è consigliabile impostare i livelli di traccia su 1 per tutti gli oggetti e quindi impostare i livelli di traccia molto più alti per gli oggetti esaminati.

Per altre informazioni sui livelli di traccia, vedere l'interfaccia ITracer .

Configurazione e avvio di una sessione autoLogger
Logman
Tracefmt
TraceView
Traccia software WPP