Compartilhar via

Habilitando e exibindo rastreamentos WDTF

  • Artigo

Rastreamento WDTF refere-se a eventos de relatório que ocorrem internamente em objetos WDTF. Como o WDTF é fortemente instrumentado, todos os objetos WDTF fornecem informações de rastreamento à medida que são executados. O WDTF manipula o rastreamento usando o Rastreamento de Software WPP. Esse tipo de rastreamento é um formato padronizado que você pode ler usando ferramentas do WDK, incluindo TraceView. Este tópico aborda como usar Logman e Tracefmt para exibir rastreamentos de tempo de execução do WDTF. Este tópico também discute como você pode configurar programaticamente os níveis de rastreamento do WDTF.

Como coletar e salvar rastreamentos do WDTF

Para começar a coletar rastreamentos do WDTF

  1. No computador de teste, abra uma janela do Prompt de Comando com privilégios elevados (Executar como administrador) e insira os seguintes comandos:

    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. Reinicialize o computador.

Consulte Logman (Logman.exe) para obter informações sobre outras opções. Para obter informações sobre como criar uma temporada de rastreamento, consulte Configurando e iniciando uma sessão do AutoLogger.

Para interromper a coleta de rastreamentos do WDTF e salvar arquivos de log

  1. Você pode parar de coletar rastreamentos WDTF e excluir o coletor de dados com os seguintes comandos:

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

  2. Reinicialize o computador.

  3. Copie os arquivos de log do computador de teste para outro computador para análise posterior.

    Os arquivos de log ETL coletados podem ter um tamanho muito grande. Para obter melhores resultados, copie os arquivos de log do computador de teste (por exemplo, c:\WDTF_Traces\TraceFile.etl) para outro computador. Em seguida, você pode excluir os arquivos de log do computador de teste.

Como exibir rastreamentos WDTF

A exibição de rastreamentos WDTF requer a formatação dos arquivos ETL. As etapas a seguir mostram como usar Tracefmt.exe para converter os arquivos ETL em arquivos de texto ou CSV.

Para exibir rastreamentos do WDTF

  1. Por exemplo, o comando a seguir converte o arquivo ETL que foi salvo como c:\WDTF_Traces\TraceFile.etl em texto.

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

  2. O comando a seguir converte o arquivo ETL que foi salvo como c:\WDTF_Traces\TraceFile.etl em CSV (arquivo separado por vírgulas).

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

  3. Abra os arquivos CSV no Microsoft Excel para que você possa usar os recursos de filtragem do Excel para filtrar os rastreamentos coletados. Você pode filtrar os rastreamentos por determinados períodos de tempo. Você pode filtrar os rastreamentos para examinar rastreamentos registrados por determinados componentes do WDTF.

Configurando programaticamente os níveis de rastreamento do WDTF

Todos os objetos WDTF fornecem informações de rastreamento à medida que são executados.

O WDTF fornece um conjunto de níveis configuráveis de TTraceLevel . Para obter informações sobre como definir o TTraceLevel de uma instância de objeto específica em tempo de execução, consulte o método ITracing::SetTraceLevel .

Para obter informações sobre como definir o TTraceLevel padrão para uma interface, consulte a Referência da Estrutura de Teste de Dispositivo do Windows.

Para obter uma descrição detalhada dos tipos de rastreamentos incluídos em cada TTraceLevel, consulte a interface ITracer . Você pode configurar globalmente esses níveis por conta própria usando o TraceLevel Path do Registro do ITracer.

A tabela a seguir descreve os níveis de rastreamento que você pode definir.

Nível Descrição
0 Desativado. Nenhum rastreamento é fornecido.
1 Baixo
2 Média: Esse nível é o nível padrão de rastreamento.
3 Alto
4 Completa. Todas as informações de rastreamento são relatadas.
5-8 Níveis personalizados.
9 Define o objeto de volta para seu nível de rastreamento inicial.

Ao depurar usando o conteúdo de rastreamento, considere definir os níveis de rastreamento como 1 para todos os objetos e, em seguida, definir níveis de rastreamento muito mais altos para os objetos que você está examinando.

Para obter mais informações sobre níveis de rastreamento, consulte a interface ITracer .

Configurando e iniciando uma sessão do AutoLogger
Logman
Tracefmt
TraceView
Rastreamento de Software WPP