Partilhar via

Habilitando e visualizando rastreamentos WDTF

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

Como coletar e salvar rastreamentos WDTF

Para começar a recolher rastreios WDTF

  1. No computador de teste, abra uma janela de prompt de comando com privilégios elevados (Executar como administrador) e digite 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. Reinicie 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 parar de coletar rastreamentos WDTF e salvar arquivos de log

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

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

  2. Reinicie 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 ser muito grandes em tamanho. 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 visualizar rastreamentos WDTF

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

Para exibir rastreamentos 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 arquivo separado por vírgulas (CSV).

    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 para determinados períodos de tempo. Você pode filtrar os rastreamentos para examinar os registos feitos por certos componentes WDTF.

Configurando programaticamente os níveis de rastreamento WDTF

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

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ê mesmo pode configurar globalmente esses níveis 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 Desligado. Não é fornecido rastreamento.
1 Baixo
2 Médio. Este 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 Restabelece o objeto ao seu nível inicial de rastreio.

Quando estiveres a depurar utilizando conteúdo de rastreamento, considera definir os níveis de rastreamento para 1 para todos os objetos e, em seguida, aumentar significativamente os níveis de rastreamento para os objetos que estiveres a examinar.

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

  • Last updated on