Comandos Tracefmt

Para usar o Tracefmt, digite os comandos em uma janela do Prompt de Comando. A sintaxe a seguir exibe os elementos de um comando Tracefmt.

Para exibir as mensagens de rastreamento em formato legível, o Tracefmt deve aplicar as instruções de formatação em um arquivo de formato de mensagem de rastreamento às mensagens de rastreamento. A sintaxe que você usa depende se você tem um arquivo TMF para o provedor de rastreamento ou se deseja que o Tracefmt crie um arquivo TMF.

Para fornecer um arquivo TMF ou um caminho para um diretório de arquivos TMF:

    tracefmt [EtlFile | -rt SessionName][-tmf TMFFile | -p TMFPath ] [Options]

Para criar um arquivo TMF:

    tracefmt [EtlFile | -rt SessionName]-i ImageFiles [-r SymbolPath ] [-p TmfPath ] [Options]

Para exibir a sintaxe na linha de comando.

    tracefmt -h | /?

Parâmetros

Arquivo Etl
Especifica o arquivo de log de rastreamento de eventos (.etl) que contém as mensagens de rastreamento. Digite o caminho (opcional) e nome de arquivo. O padrão é c:\logfile.etl.

-Rt Nome da sessão
Tempo real. Formata mensagens de rastreamento das sessões de rastreamento em tempo real especificadas, em vez de de um log de rastreamento.

SessionName é o nome da sessão de rastreamento. O padrão é NT Kernel Logger.

-tmf TMFFile
Especifica o caminho (opcional) e o nome do arquivo de um arquivo de formato de mensagem de rastreamento (.tmf) para as mensagens de rastreamento. O valor padrão é Default.tmf, um arquivo incluído no WDK.

-eu Arquivos de imagem
Direciona o Tracefmt para localizar os arquivos de símbolo PDB para os arquivos de imagem especificados e para criar um arquivo TMF a partir das instruções de formatação nos arquivos PDB.

ImageFiles representa o caminho e os nomes de arquivo de um ou mais arquivos binários (.exe, .dll ou .sys) para provedores de rastreamento. Use um ponto-e-vírgula (;) para separar os nomes dos arquivos de imagem.

-r Caminhos de Símbolos
Especifica a localização dos arquivos de símbolo PDB privados para os arquivos de imagem especificados em -i.

SymbolPaths representa um ou mais caminhos para diretórios que armazenam símbolos privados ou caminhos de servidor de símbolos. Use um ponto-e-vírgula (;) para separar os nomes dos caminhos. Os nomes de caminho em SymbolPaths podem incluir caracteres curinga, como um asterisco (*) para representar vários caracteres e um ponto de interrogação (?) para representar um único caractere.

Se você incluir -i em um comando, mas omitir -r, o Tracepdb procurará os arquivos PDB para as imagens especificadas nos caminhos especificados pela variável de ambiente %_NT_SYMBOL_PATH%. Se a variável de ambiente não estiver definida, o Tracepdb pesquisará no caminho do símbolo padrão, srv*\\\\symbols\\symbols.

-p TMFPath
Especifica o caminho para o diretório que armazena arquivos TMF.

Quando -p é usado sem -i, o Tracefmt pesquisa no caminho especificado por -p por um arquivo TMF existente. Se -p for omitido, o Tracefmt procurará o arquivo TMF no valor da variável de ambiente %TRACE_FORMAT_SEARCH_PATH%, se estiver definida. Caso contrário, o Tracefmt tentará aplicar as instruções de formatação no arquivo Default.tmf.

Quando -p é usado com -i, o Tracefmt coloca o arquivo TMF criado no diretório especificado por -p. Se -p for omitido, o Tracefmt colocará o arquivo TMF no diretório especificado pelo valor da variável de ambiente %TRACE_FORMAT_SEARCH_PATH%, se estiver configurado. Caso contrário, o Tracefmt colocará o arquivo no diretório local.

-h | /?
Exibe a ajuda.

-o Arquivo de saída
Especifica nomes alternativos para o arquivo de saída Tracefmt e o arquivo de mensagem de resumo Tracefmt. Os valores padrão são FmfFile.txt (para o arquivo de saída) e FmtSum.txt.sum (para o arquivo de resumo) no diretório local.

OutputFile é um caminho e um nome de arquivo com uma extensão de nome de arquivo .txt, como c:\traces\trace.txt.

Se você usar esse parâmetro com as opções -displayonly ou -summaryonly , ele afetará apenas o arquivo de mensagem de resumo.

-csv
Formata o arquivo de saída do Tracefmt como um arquivo de comprimento variável (.csv) separado por vírgulas. Esse formato adiciona um prefixo detalhado e estruturado a cada mensagem, além do prefixo de mensagem de rastreamento padrão.

Essa opção afeta o arquivo de saída e a exibição de mensagens de rastreamento na janela do Prompt de Comando, se houver.

-csvcabeçalho
Adiciona uma linha de cabeçalhos de coluna descritivos ao arquivo CSV. Esse cabeçalho é especialmente útil para interpretar o prefixo estruturado que o Tracefmt adiciona aos arquivos CSV. Por padrão, os arquivos CSV do Tracefmt não têm cabeçalhos de coluna.

-csvquote
Duplica todas as aspas (") no arquivo CSV. Esse recurso foi projetado para aplicativos que exibem aspas somente quando elas estão entre aspas.

-exposição
Exibe as mensagens de rastreamento na janela do Prompt de Comando, além de gravá-las no arquivo de saída.

-somente exibição
Exibe as mensagens de rastreamento somente na janela do Prompt de Comando e não cria um arquivo de saída.

-sem resumo
Não cria um arquivo de mensagem de resumo.

-apenas resumo
Cria somente um arquivo de mensagem de resumo. Tracefmt não cria um arquivo de saída.

-sem prefixo
Omite o prefixo de mensagem de rastreamento. Essa opção afeta as mensagens de rastreamento no arquivo de saída e na exibição do Tracefmt.

-Contrata
Alta resolução. Exibe o número de microssegundos e nanossegundos no carimbo de data/hora da mensagem de rastreamento. Por padrão, apenas milissegundos são exibidos.

Use essa opção quando um valor de relógio do contador de desempenho for usado para o carimbo de data/hora da mensagem de rastreamento, em vez do temporizador do sistema, como quando o parâmetro Tracelog -UsePerfCounter é usado. Para obter informações sobre comandos Tracelog, consulte Sintaxe de comando Tracelog.

-Seq
Exibe os números de sequência locais ou globais no prefixo da mensagem de rastreamento. Se os números de sequência não foram registrados na mensagem, o campo não foi inicializado ou preenchido com zeros ou "f"s.

-Ods
Envia as mensagens de rastreamento formatadas para o depurador para exibição.

-Gmt
Exibe o carimbo de data/hora em cada mensagem de rastreamento no Horário de Greenwich (GMT).

Essa opção afeta apenas o arquivo de saída Tracefmt. Ele não converte os carimbos de data/hora no arquivo de log de rastreamento de eventos (.etl). O fuso horário do log de rastreamento é exibido quando você envia um comando Tracefmt.

-Utc
Exibe o carimbo de data/hora em cada mensagem de rastreamento no UTC (Tempo Universal Coordenado). O UTC é quase idêntico ao GMT, mas representa a meia-noite como zero.

Essa opção afeta apenas o arquivo de saída Tracefmt. Ele não converte os carimbos de data/hora no arquivo de log de rastreamento de eventos (.etl). O fuso horário do arquivo de log de rastreamento é exibido quando você envia um comando Tracefmt.

-traço
Exibe as ações do Tracefmt à medida que elas ocorrem. Essas informações são úteis quando a formatação está incorreta ou quando o Tracefmt relata um erro ou exceção.

A exibição do rastreamento pode ser extensa. Considere redirecionar a saída do Tracefmt para um arquivo de texto para exame posterior.

-v
Detalhado. Exibe informações detalhadas na janela do Prompt de Comando à medida que o Tracefmt processa cada bloco ou buffer de mensagens de rastreamento. Use essa opção quando suspeitar de danos ou inconsistências no arquivo.

Comentários

Localizando o arquivo TMF

Se você omitir o parâmetro -i , o Tracefmt usará os métodos a seguir para localizar o arquivo TMF. Os métodos são listados para que o Tracefmt os use.

• O parâmetro -tmf.

• O parâmetro -p.

• A variável de ambiente %TRACE_FORMAT_SEARCH_PATH%.

• Default.tmf, um arquivo incluído no WDK.

Se o Tracefmt não puder encontrar um arquivo TMF ou o arquivo TMF não incluir informações de formatação para as mensagens de rastreamento, o Tracefmt não poderá exibir as mensagens. Em vez disso, ele grava a seguinte mensagem de erro no lugar da mensagem de rastreamento

No Format Information found.

Exceção levantada

Se o Tracefmt não puder formatar um parâmetro de mensagem de rastreamento, ele gerará uma exceção e exibirá uma mensagem como:

*****FormatMessage Header(Header) of EventTrace, parameter 23 raised an exception*****

Se você vir uma exceção semelhante, revise a definição da mensagem no código-fonte, com atenção especial a todos os tipos de variáveis especificados pelo usuário. Para obter mais informações, consulte DoTraceMessage.

Arquivos TMF com nomes de arquivo não GUID

Se o nome do arquivo TMF não for um GUID de mensagem, você deverá usar o parâmetro -tmf para identificar o arquivo e inserir o caminho totalmente qualificado para o arquivo.

Formatando mensagens de rastreamento do NT Kernel Logger

Para formatar mensagens da sessão de rastreamento do Agente de Kernel NT ou de uma sessão de rastreamento do Agente Global, use o parâmetro -tmf para especificar o arquivo system.tmf, um arquivo de formato de mensagem de rastreamento incluído no WDK..

Formatando mensagens de rastreamento de sessões de rastreamento em tempo real

Quando você usa o parâmetro -rt (tempo real), o Tracefmt exibe uma mensagem confirmando que está no modo em tempo real e, em seguida, aguarda mensagens de rastreamento do provedor de rastreamento especificado. Ele não retorna ao prompt de comando até que a sessão de rastreamento seja interrompida.

Formatando carimbos de data/hora QPC

O Tracefmt não formata os valores do relógio do contador de desempenho do sistema (QueryPerformanceCounter) corretamente. Se você estiver usando esse tempo de alta resolução, use o Tracerpt, uma ferramenta incluída no Windows, para formatar as mensagens de rastreamento. Para obter mais informações, consulte a descrição do parâmetro -UsePerfCounter em Sintaxe do comando Tracelog.

Mensagens de rastreio fora de sequência

Se você exibir um arquivo de mensagem de rastreamento em um computador que executa o Windows XP, a exibição poderá mostrar mensagens de rastreamento fora de seqüência. Para corrigir esse problema, você pode usar a opção de número de sequência ao iniciar a sessão de rastreamento e exibir o rastreamento usando Tracefmt. Em seguida, você pode visualizar o rastreamento com o Traceview e classificar de acordo com o número de sequência. Você também pode exibir o rastreamento em um computador que executa o Windows Server 2003 ou versões posteriores do Windows.