Conceitos do TraceView

Este tópico explica os conceitos usados no TraceView.

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

Grupo de Sessões de Rastreamento

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

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

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

Espaço de trabalho

Em TraceView, um espaço de trabalho é 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 espaços de trabalho, você pode exibir um log usado com freqüência ou iniciar uma sessão de rastreamento cuidadosamente configurada em uma etapa rápida.

Um espaço de trabalho inclui:

• Todas as propriedades da sessão de rastreamento, incluindo os buffers, os sinalizadores, o nível e o local do log de rastreamento.

• A localização do arquivo de símbolo do banco de dados do programa (PDB), do arquivo de formato de mensagem de rastreamento (TMF) ou do caminho de pesquisa TMF.

• O caminho e os nomes de arquivo do arquivo de listagem e do arquivo de resumo do TraceView

• Filtros

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

Para obter mais informações, consulte Usando espaços de trabalho 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 que os provedores geram. Você pode fazer isso de qualquer uma das seguintes maneiras:

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

• Localize o arquivo de símbolos PDB para o código-fonte que inclui fornecedores de rastreamento de software WPP. O 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 estão armazenados.

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

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

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

• Selecione uma Sessão de Rastreamento do Kernel NT e depois escolha um ou mais eventos do sistema operacional para rastrear.

Definir o caminho de pesquisa 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, você deve especificar um diretório no qual o TraceView pode encontrar os arquivos TMF ou deve localizar os arquivos TMF para as mensagens de rastreamento do provedor.

O TraceView suporta 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. O TraceView verifica todos os ficheiros TMF no diretório especificado e associa o GUID da mensagem gerada ao nome do ficheiro TMF. Os arquivos TMF devem estar localizados no diretório especificado. O 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, porque o TraceView não pode encontrá-lo em um diretório.

Se os arquivos TMF especificados ou aqueles que o TraceView encontra no diretório especificado não corresponderem às mensagens de rastreamento geradas pelo provedor de rastreamento, o 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 a partir de um arquivo de símbolo PDB, em uma janela de prompt de comando, use Tracepdb.