Prefixo de mensagem de rastreamento

Tracefmt adiciona um prefixo a cada mensagem de rastreamento que consiste em dados armazenados no arquivo de log de rastreamento de eventos (.etl) e no arquivo de formato de mensagem de rastreamento (.tmf).

O Tracefmt inclui elementos de dados específicos por padrão, mas os usuários podem adicionar e remover elementos alterando a variável de ambiente %TRACE_FORMAT_PREFIX%, uma cadeia de caracteres que especifica uma definição de mensagem compatível com FormatMessage.

O formato do prefixo de mensagem de rastreamento padrão é o seguinte:

[%9!d!]%8!04X!.%3!04X!::%4!s! [%1!s!]

que produz o seguinte prefixo:

[CPUNumber]ProcessID.ThreadID :: SystemTime [MessageGUIDFriendlyName]

Cada variável %n representa um parâmetro descrito na tabela a seguir.

Identificador de variável de prefixo	Tipo de variável	Descrição
%1	string	O nome amigável do GUID da mensagem da mensagem de rastreamento. Por padrão, o nome amigável de um GUID de mensagem é o nome do diretório no qual o provedor de rastreamento foi criado. Para alterar o nome amigável do GUID da mensagem, use o parâmetro -p com Tracewpp ou com a macro RUN_WPP. Para obter mais informações, consulte Opções de Run_WPP.
%2	string	Arquivo de origem e número de linha. Essa variável representa o nome amigável da mensagem de rastreamento. Por padrão, o nome amigável de uma mensagem de rastreamento é o nome do arquivo de origem e o número de linha do código que gerou a mensagem de rastreamento.
%3	ULONG	ID de thread. Identifica o thread que gerou a mensagem de rastreamento.
%4	string	Carimbo de data/hora da hora em que a mensagem de rastreamento foi gerada.
%5	string	Hora do kernel. Exibe o tempo de execução decorrido para a instrução do modo kernel, em tiques de CPU, no momento em que a mensagem de rastreamento foi gerada.
%6	string	Hora do usuário. Exibe o tempo de execução decorrido para a instrução do modo de usuário, em tiques de CPU, no momento em que a mensagem de rastreamento foi gerada.
%7	LONG	Número de sequência. Exibe o número de sequência local ou global da mensagem de rastreamento. Os números de sequência local, que são exclusivos apenas para essa sessão de rastreamento, são o padrão.
%8	ULONG	ID do processo. Identifica o processo que gerou a mensagem de rastreamento.
%9	ULONG	Número da CPU. Identifica a CPU na qual a mensagem de rastreamento foi gerada.
%! FUNC!	string	Nome da função. Exibe o nome da função que gerou a mensagem de rastreamento.
%! SINALIZADORES!	string	Exibe o nome dos sinalizadores de rastreamento que habilitam a mensagem de rastreamento. (Como a macro DoTraceMessage inverte os sinalizadores e os argumentos de nível, as mensagens geradas por DoTraceMessage exibem o valor do nível de rastreamento neste campo.)
%! NÍVEL!	string	Exibe o valor do nível de rastreamento que habilita a mensagem de rastreamento. (Como a macro DoTraceMessage inverte os sinalizadores e os argumentos de nível, as mensagens geradas por DoTraceMessage exibem o nome dos sinalizadores de rastreamento neste campo.)
%! COMPNAME!	string	Nome do componente. Exibe o nome do componente do provedor que gerou a mensagem de rastreamento. O nome do componente será exibido somente se for especificado no código de rastreamento.
%! SUBCOMP!	string	Nome do subcomponente. Exibe o nome do subcomponente do provedor que gerou a mensagem de rastreamento. O nome do componente será exibido somente se for especificado no código de rastreamento.

O símbolo dentro de pontos de exclamação é um caractere de conversão que especifica a formatação e a precisão da variável. Por exemplo, %8!04X! especifica a ID do processo representada como um número hexadecimal sem sinal de quatro dígitos. Esses caracteres de conversão devem ser incluídos.

Para alterar os elementos, a ordem ou a formatação do prefixo de mensagem de rastreamento, use a variável de ambiente %TRACE_FORMAT_PREFIX%. Para obter um exemplo, consulte Exemplo 7: personalizando o prefixo de mensagem de rastreamento.

Para obter um exemplo de conteúdo em um arquivo TMF, consulte Formatação de mensagens de rastreamento do exemplo tracedrv.

Além disso, o parâmetro -csv adiciona um prefixo detalhado não configurável a cada mensagem de rastreamento antes do prefixo Tracefmt padrão. Para obter uma descrição dos campos no prefixo CSV, use o parâmetro -csvheader .