Compartilhar via

Conceitos de TraceView

  • Artigo

Este tópico explica os conceitos usados no TraceView.

Para obter informações sobre conceitos comuns às ferramentas de rastreamento no WDK, consulte Conceitos da ferramenta de rastreamento.

Grupo de Sessão de Rastreamento

TraceView permite combinar exibições de log de rastreamento ou sessões de rastreamento em tempo real em um grupo de sessão de rastreamento e gerenciá-las como se fossem uma única sessão. Quando logs de rastreamento ou sessões estão no mesmo grupo de sessão de rastreamento, suas mensagens são combinadas em uma lista de mensagens de rastreamento.

Por padrão, cada sessão de rastreamento é membro de um grupo de sessão de rastreamento que consiste apenas nessa sessão de rastreamento.

Para obter informações sobre como criar grupos de sessão de rastreamento, consulte Agrupando sessões de rastreamento.

Espaço

Em TraceView, um workspace é um conjunto de propriedades de sessão de rastreamento e propriedades de exibição de log de rastreamento que você pode salvar e reutilizar. Com workspaces, você pode exibir um log usado com frequência ou iniciar uma sessão de rastreamento cuidadosamente configurada em uma etapa rápida.

Um workspace inclui:

Quando você abre o workspace para uma sessão de rastreamento em tempo real, TraceView inicia uma nova sessão de rastreamento com as propriedades salvas e as configurações. Quando você abre o workspace para uma exibição de log de rastreamento, o log aparece exatamente como você o configurou.

Para obter mais informações, consulte Usando workspaces traceview.

Especificando provedores de rastreamento

Para criar uma sessão de rastreamento, você deve identificar os provedores de rastreamento e localizar as instruções de formatação para as mensagens de rastreamento binário geradas pelos provedores. Você pode fazer isso de qualquer uma das seguintes maneiras:

  • Localize o binário executável para o código-fonte que alinha os provedores. TraceView pode extrair todas as informações necessárias para habilitar e formatar TraceLogging e eventos ETW manifestados. Ele também tentará localizar o arquivo de símbolo PDB para habilitar quaisquer provedores de rastreamento de software WPP .

  • Localize o arquivo de símbolo PDB para o código-fonte que inclui provedores de rastreamento de software WPP . TraceView pode extrair do arquivo PDB todas as informações necessárias para identificar os provedores e formatar suas mensagens de rastreamento.

  • Localize um arquivo GUID de controle (.ctl) para o provedor e especifique o arquivo TMF ou o caminho para um diretório onde os arquivos TMF são armazenados.

  • Insira o GUID de controle do provedor e especifique o arquivo TMF ou o caminho para um diretório em que os arquivos TMF são armazenados.

    Se você inserir um nome de provedor precedido por um asterisco (por exemplo *SampleProvider, ), TraceView transformará automaticamente o nome em um GUID usando um algoritmo padrão. Nem todos os provedores seguem esse padrão, mas muitos, como provedores escritos usando . Classe EventSource do NET, faça.

  • Selecione um provedor registrado na lista que TraceView monta e especifique o arquivo TMF ou o caminho para um diretório em que os arquivos TMF são armazenados.

  • Selecione uma Sessão de Rastreamento do Agente do Kernel NT e selecione um ou mais eventos do sistema operacional a serem rastreados.

Definir o caminho de pesquisa do TMF e selecionar opções de arquivos TMF

Ao habilitar provedores WPP, a menos que você tenha o arquivo de símbolo PDB para o provedor, especifique um diretório no qual TraceView possa encontrar os arquivos TMF ou localizar os arquivos TMF para as mensagens de rastreamento do provedor.

O TraceView dá suporte a dois métodos:

  • Use a opção Definir Caminho de Pesquisa TMF quando não tiver certeza de quais arquivos TMF usar para o provedor de rastreamento. TraceView pesquisa todos os arquivos TMF no diretório especificado e corresponde ao GUID da mensagem gerada para o nome do arquivo TMF. Os arquivos TMF devem estar localizados no diretório especificado. TraceView não pesquisa recursivamente.

  • Use a opção Selecionar arquivos TMF quando souber qual arquivo TMF usar para o provedor de rastreamento ou quando os arquivos TMF necessários estiverem em diretórios diferentes. Você também deve usar essa opção se o nome do arquivo TMF não for um GUID de mensagem, pois TraceView não pode encontrá-lo em um diretório.

Se os arquivos TMF especificados ou aqueles localizados pelo TraceView no diretório especificado não corresponderem às mensagens de rastreamento geradas pelo provedor de rastreamento, TraceView não poderá formatar as mensagens. Em vez disso, ele exibe o GUID da mensagem de rastreamento e a seguinte mensagem de erro:

No Format Information found.

Para criar arquivos TMF de um arquivo de símbolo PDB, em uma janela do Prompt de Comando, use Tracepdb.