Depurar seu aplicativo com arquivos de log do IntelliTrace (.iTrace)

Artigo
02/26/2013

Você pode iniciar uma sessão de depuração do IntelliTrace diretamente de um arquivo de log do IntelliTrace (.iTrace).Esse arquivo contém exceções, solicitações da Web, threads, etapas de teste, módulos e outras informações do sistema que o IntelliTrace registra durante a execução do seu aplicativo.

Inspeção IntelliTrace em ação:

Coletando e analisando dados do IntelliTrace em produção para depuração (vídeo do Channel 9)
Desenvolvendo, testando e depurando produtos para o SharePoint (vídeo do Channel 9)

Requisitos

Um arquivo .iTrace de uma das seguintes fontes:
- Uma sessão do IntelliTrace no Visual Studio Ultimate.Consulte Gravar execução de código com o IntelliTrace para depuração no Visual Studio.
- Uma sessão de teste no Microsoft Test Manager.Isso anexa um arquivo .iTrace a um item de trabalho do Team Foundation Server.Consulte Como: coletar dados de IntelliTrace para ajudar a depurar problemas de difícil.
- O coletor autônomo para aplicativos que estejam sendo executados fora do Visual Studio.Consulte Coletar dados do IntelliTrace fora do Visual Studio com o coletor autônomo.
- Visual Studio 2012.1: aplicativos monitorados pelo System Center 2012 Service Pack 1 (SP1) - Operations Manager com IntelliTrace Profiling Management Pack.Consulte Como configurar a integração com o IntelliTrace no System Center 2012.

Visual Studio Ultimate em um computador de desenvolvimento ou em outro computador para abrir arquivos .iTrace

Observação
Para depurar com o IntelliTrace e percorrer o código, você deverá ter os arquivos de origem e os arquivos de símbolo correspondentes.Verifique se os arquivos de símbolo estão no caminho do símbolo do Visual Studio.Caso contrário, o Visual Studio não poderá resolver os locais de origem e não mostrará a mensagem "Símbolos não localizados". Consulte Localizar símbolo (.pdb), origem e arquivos binários.

Para depurar com o IntelliTrace e percorrer o código, você deverá ter os arquivos de origem e os arquivos de símbolo correspondentes.Verifique se os arquivos de símbolo estão no caminho do símbolo do Visual Studio.Caso contrário, o Visual Studio não poderá resolver os locais de origem e não mostrará a mensagem "Símbolos não localizados". Consulte Localizar símbolo (.pdb), origem e arquivos binários.

O que você deseja fazer?

Abrir um arquivo de log do IntelliTrace
Leia o arquivo de log do IntelliTrace
Iniciar a depuração de um arquivo de log do IntelliTrace

Abrir um arquivo de log do IntelliTrace

Em um computador com o Visual Studio Ultimate, abra o arquivo .iTrace.

Clique duas vezes no arquivo .iTrace fora do Visual Studio ou abra o arquivo de dentro do Visual Studio.

- ou -
Se o arquivo .iTrace estiver anexado a um item de trabalho do Team Foundation Server, siga estas etapas no item de trabalho:
- Em Todos os Links, localize o arquivo .iTrace.Abra-o.
  
  - ou -
- Em Etapas de Reprodução, escolha o link IntelliTrace.

Dica
Se você fechou o arquivo .iTrace durante a depuração, poderá reabri-lo facilmente.Vá para o menu Depurar, escolha IntelliTrace, Mostrar Resumo de Log.Você também pode escolher Mostrar Resumo de Log na janela IntelliTrace .Isso só estará disponível durante a depuração com o IntelliTrace.

Leia o arquivo de log do IntelliTrace

Algumas das seções a seguir no arquivo .iTrace só aparecerão se você tiver coletado dados de uma origem em particular, por exemplo, o Test Manager ou aplicativos do SharePoint 2010 com o coletor autônomo.

Seção	Contém	Origem de coleta (Visual Studio Ultimate, Test Manager, coletor autônomo)
Análise	Somente para aplicativos do SharePoint 2010.Esta seção permite que você examine eventos do IntelliTrace e do SharePoint, como eventos do depurador, eventos de ULS, exceções e outros dados que o coletor registrou.	Coletor autônomo para Visual Studio 2012.1
Lista de threads	Threads executados durante a coleta	Todas as fontes
Solicitações da Web	Solicitações da Web que foram enviadas para um pool de aplicativos do IIS.Esses dados são semelhantes aos dados coletados em arquivos de log do IIS W3C.	Coletor autônomo: somente aplicativos da Web hospedados no IIS
Dados de exceção	Exceções que são lançadas pelo aplicativo durante a coleta, incluindo a pilha de chamadas completa para cada exceção	Todas as fontes
Dados de teste	Etapas de teste e seus resultados de uma sessão de teste	Test Manager
Informações do sistema	Configurações e especificações do sistema host	Todas as fontes
Módulos	Os módulos carregados durante a coleta	Todas as fontes

Iniciar a depuração de um arquivo de log do IntelliTrace

Na maioria das seções, você pode examinar eventos ou outros itens, escolher um item e então escolher Iniciar Depuração.Isso inicia uma sessão de depuração do IntelliTrace no ponto onde e quando um evento aconteceu.

Dica
Para classificar dados, escolha os cabeçalhos de coluna.Para filtrar dados, use a caixa de pesquisa.A pesquisa de texto sem formatação funciona em todas as colunas, exceto nas colunas de tempo.Na seção Solicitações da Web, você também pode filtrar pesquisas para a coluna específica.

Análise

Esta seção só aparecerá para aplicativos do SharePoint 2010 se você tiver registrado dados com o coletor no Visual Studio 2012.1.Consulte Coletar dados do IntelliTrace fora do Visual Studio com o coletor autônomo.

Esta seção permite que você realize estas tarefas:

Use uma identificação de correlação do SharePoint para localizar sua solicitação da Web e eventos correspondentes.Você pode escolher um evento e então iniciar a depuração no ponto onde e quando o evento ocorreu.
Examine todas as exceções sem tratamento que o coletor encontrou.Você pode escolher uma exceção e então iniciar a depuração no ponto onde e quando a exceção ocorreu.

Observação
Se for exibida a mensagem "Símbolos não encontrados", o Visual Studio não poderá resolver os locais de origem.Verifique se os arquivos de símbolo do aplicativo (.pdb) estão no caminho do símbolo do Visual Studio.Consulte Localizar símbolo (.pdb), origem e arquivos binários.

Iniciar a depuração com uma identificação de correlação do SharePoint

Copie a identificação de correlação do SharePoint de sua origem.

Por exemplo:
No arquivo .iTrace, em Análise, você pode inserir a identificação de correlação do SharePoint.Isso permite que você encontre a solicitação correspondente e veja seus eventos registrados.
Sob Eventos de solicitação, examine os eventos.A partir da parte superior, os eventos aparecem na ordem em que aconteceram.
1. Escolha um evento para ver seus detalhes.
2. Escolha Iniciar Depuração para iniciar depuração no ponto onde o evento aconteceu.

Você pode ver esses tipos de eventos do SharePoint juntamente com eventos do IntelliTrace:

Eventos de perfil de usuário

Esses eventos ocorrem quando o SharePoint carrega um perfil de usuário e quando as propriedades de perfil de usuário são lidas ou modificadas.

Eventos do ULS (Unified Logging System)

O coletor autônomo registra um subconjunto de eventos do SharePoint ULS e destes campos:

Campo do IntelliTrace	Campo do SharePoint ULS
Id	EventID
Nível	Nível
Id da Categoria	Id da Categoria
Categoria	Categoria
Área	Produto
Saída	Message (Mensagem)
Identificação de correlação	Identificação de correlação

Iniciar a depuração de uma exceção sem tratamento

Escolha uma identificação de correlação do SharePoint para uma exceção.As exceções são agrupadas por tipo e pilha de chamadas.
(Opcional) Expanda Pilha de Chamadas para ver a pilha de chamadas para um grupo de exceções.
Escolha Depurar Exceção para iniciar a depuração no ponto onde e quando a exceção aconteceu.

Para obter uma explicação passo-a-passo, consulte Instruções passo a passo: depurando um aplicativo do SharePoint usando o IntelliTrace.Para os tipos de dados que o coletor registra, consulte Gravar execução de código com o IntelliTrace para depuração no Visual Studio.

Lista de threads

Esta seção mostra os threads registrados executados no processo de destino.Você pode iniciar a depuração do primeiro evento válido do IntelliTrace em um thread selecionado.

Para iniciar a depuração de um thread específico

Em Lista de Threads, escolha um thread.
Na parte inferior da Lista de Threads, escolha Iniciar Depuração.Você também pode clicar duas vezes em um thread.

Para iniciar a depuração de onde o aplicativo começa, clique duas vezes em Thread Principal.Consulte Gravar execução de código com o IntelliTrace para depuração no Visual Studio.

Os dados do thread que o usuário cria podem ser mais úteis do que os threads que um servidor cria e gerencia para aplicativos da Web hospedados pelo IIS.

Coluna	Mostra
ID	Número de identificação do thread
Nome	Nome do thread.Threads sem nome aparecem como "<Sem Nome>".
Hora de Início	A hora em que o thread foi criado.
Hora de Fim	A hora em que o thread foi concluído.

Solicitações da Web

Esta seção mostra solicitações da Web registradas que foram enviadas para um pool de aplicativos do IIS.Você pode escolher uma solicitação da Web para examinar os eventos registrados para a solicitação.Então você poderá iniciar a depuração a partir de um evento específico.

Por padrão, as solicitações da Web aparecem de cima para baixo na ordem em que chegam ao servidor.

Para ver os eventos registrados para uma solicitação específica da Web

Em Solicitações da Web, escolha uma solicitação da Web.

Na parte inferior de Solicitações da Web, escolha Detalhes da Solicitação.Você também pode clicar duas vezes na solicitação da Web.

A página Detalhes da Solicitação abre para a solicitação da Web selecionada e mostra os eventos do IntelliTrace registrados para essa solicitação.A partir da parte superior, os eventos aparecem na ordem em que aconteceram.Filtre eventos ao escolher uma opção da lista de categorias ou ao usar a caixa de pesquisa.Consulte Gravar execução de código com o IntelliTrace para depuração no Visual Studio.

Dica
A página Detalhes da Solicitação é aberta em uma guia de visualização.Este guia é substituída por uma nova página Detalhes da Solicitação quando você escolhe outra solicitação da Web.Para preservar a guia da visualização, escolha Promover na guia.A próxima solicitação da Web será aberta em uma nova guia de visualização.

Para iniciar a depuração de um evento específico

Em Eventos de Solicitação, escolha um evento.

Na parte inferior da Eventos de Solicitação, escolha Iniciar Depuração.Você também pode clicar duas vezes em um evento.

Dica
Se o arquivo .iTrace incluir informações de chamada de função, você poderá percorrer o código a partir do local do evento.Você também pode consultar valores de parâmetro e de retorno. Para coletar informações de chamada: No Visual Studio Ultimate, configure o IntelliTrace para coletar informações de chamada.Consulte Gravar execução de código com o IntelliTrace para depuração no Visual Studio. Para o coletor coletor autônomo do IntelliTrace, use o plano de coleta collection_plan.ASP.NET.tr ace.xml ou um plano de coleta personalizado.Consulte Coletar dados do IntelliTrace fora do Visual Studio com o coletor autônomo. Se for exibida a mensagem "Símbolos não encontrados", o Visual Studio não poderá resolver os locais de origem.Verifique se os arquivos de símbolo do aplicativo da Web (.pdb) estão no caminho do símbolo do Visual Studio.Consulte Localizar símbolo (.pdb), origem e arquivos binários.

Se o arquivo .iTrace incluir informações de chamada de função, você poderá percorrer o código a partir do local do evento.Você também pode consultar valores de parâmetro e de retorno.

Para coletar informações de chamada:

No Visual Studio Ultimate, configure o IntelliTrace para coletar informações de chamada.Consulte Gravar execução de código com o IntelliTrace para depuração no Visual Studio.
Para o coletor coletor autônomo do IntelliTrace, use o plano de coleta collection_plan.ASP.NET.tr ace.xml ou um plano de coleta personalizado.Consulte Coletar dados do IntelliTrace fora do Visual Studio com o coletor autônomo.

Se for exibida a mensagem "Símbolos não encontrados", o Visual Studio não poderá resolver os locais de origem.Verifique se os arquivos de símbolo do aplicativo da Web (.pdb) estão no caminho do símbolo do Visual Studio.Consulte Localizar símbolo (.pdb), origem e arquivos binários.

Coluna	Mostra
Método	Método HTTP enviado com a solicitação
URL de destino	URL de destino enviada com a solicitação
Tempo Decorrido (ms)	Tempo em milissegundos entre o servidor que recebe a solicitação e o resultado que sai do servidor
Status	Código de status HTTP retornado no resultado
ID da Sessão	ID da Sessão usada pelo IIS para diferenciar usuários. O valor de ID da Sessão é apenas um inteiro crescente usado para diferenciar entre usuários da sessão e não está relacionado ao conceito ASP.NET de SessionID.Dessa forma, solicitações da Web que têm a mesma ID da Sessão pertencem à mesma sessão do usuário.
IP do Cliente	Endereço IP registrado pelo IIS para a solicitação enviada
Agente do Usuário	Valor da cadeia de caracteres do agente de usuário enviado com a solicitação HTTP
Hora de Início	Hora em que o servidor recebeu a solicitação
Hora de Fim	Hora em que o servidor respondeu ao cliente

Para ver os dados de uma perspectiva do usuário, filtre e agrupe as solicitações da Web.Por exemplo:
- Para localizar falhas, filtre as solicitações por Status.
- Para ver tendências ou o comportamento do usuário, agrupe as falhas por URL de Destino ou por ID da Sessão.
Você também pode filtrar pesquisas para uma coluna específica.Digite o nome da coluna sem espaços, dois-pontos e o valor de pesquisa.

Por exemplo, para localizar as solicitações da Web que usaram o método GET com uma ID da Sessão, digite:

Method:GET;SessionId:2

Você pode usar um filtro por coluna.Para ver quais colunas que você pode filtrar, examine a dica de ferramenta da caixa de pesquisa Solicitações da Web.

Dados de exceção

Esta seção permite que você examine as exceções registradas que foram geradas por seu aplicativo.Por padrão, as exceções mais recentes aparecem na parte superior porque as exceções são classificadas por Hora do Evento em ordem decrescente.

Para iniciar a depuração de uma exceção específica

Em Dados de Exceção, escolha uma exceção.
Na parte inferior da Dados de Exceção, escolha Iniciar Depuração.Você também pode clicar duas vezes em uma exceção.

Isso inicia a depuração no momento em que a exceção foi lançada.

Dica
Procure várias exceções com o mesmo Tipo e ID do Thread e que apareçam em sequência.Isso é geralmente causado por uma exceção que foi lançada, detectada e então lançada novamente. Para ver se esse é o caso, escolha cada uma de essas exceções e examine a pilha de chamadas.Consulte se a pilha de chamadas aumenta ou diminui.Se a pilha menor for igual ao início da pilha de chamadas mais longa, e se a ID do Thread for igual, então é possível que a mesma exceção tenha sido lançada novamente.A exceção com a pilha de chamadas mais longa pode estar mais perto da origem do problema.

Procure várias exceções com o mesmo Tipo e ID do Thread e que apareçam em sequência.Isso é geralmente causado por uma exceção que foi lançada, detectada e então lançada novamente.

Para ver se esse é o caso, escolha cada uma de essas exceções e examine a pilha de chamadas.Consulte se a pilha de chamadas aumenta ou diminui.Se a pilha menor for igual ao início da pilha de chamadas mais longa, e se a ID do Thread for igual, então é possível que a mesma exceção tenha sido lançada novamente.A exceção com a pilha de chamadas mais longa pode estar mais perto da origem do problema.

Coluna	Mostra
Tipo	Tipo .NET da exceção
Message (Mensagem)	Mensagem fornecida pela exceção
Identificação do thread	ID do thread que lançou a exceção
HResult	O código de erro especificado na exceção.Disponível se esse valor tiver sido definido na exceção.
Hora do Evento	Carimbo de data/hora registrado quando a exceção foi lançada
Pilha de Chamadas	Pilha de chamadas para a exceção. Para ver a pilha de chamadas, escolha uma exceção na lista.A pilha de chamadas aparece abaixo da lista de exceções.

Dados de teste

Esta seção permite que você examine os dados que o Test Manager coleta ao testar seu aplicativo.

Para iniciar a depuração de uma etapa específica do teste

Expanda Grade de Etapas do Teste.Escolha uma etapa do teste.
Na parte inferior da Grade de Etapas do Teste, escolha Iniciar Depuração.Você também pode clicar duas vezes em uma etapa de teste.

Isso inicia a depuração do primeiro evento válido do IntelliTrace após a etapa selecionada do teste.

Quando houver dados de teste, o IntelliTrace tentará resolver a compilação do Team Foundation Server associada usada para executar o teste.Se a compilação for encontrada, os símbolos associados para o aplicativo serão resolvidos automaticamente.

Campo	Mostra
Sessão de teste	Sessões de teste que foram registrados.Normalmente, há apenas uma.Esta lista estará vazia se os dados de teste tiverem sido criados usando um teste exploratório manual.
Situação de teste	Situações de teste da sessão de teste selecionada.Esta lista estará vazia se os dados de teste tiverem sido criados usando um teste exploratório manual.
Grade de Etapas do Teste	Etapas de teste que foram registradas com o resultado de teste de aprovação ou de falha

Informações do sistema

Esta seção mostra detalhes sobre o sistema que hospedou o aplicativo, por exemplo, informações de hardware, do sistema operacional e específicas do ambiente e do processo.

Módulos

Esta seção mostra os módulos que o processo de destino carregou.Os módulos aparecem na ordem em que foram carregados.

Coluna	Mostra
Nome do Módulo	Nome do arquivo do módulo
Caminho do Módulo	Local do disco onde o módulo foi carregado
ID do Módulo	O identificador exclusivo de módulo que é específico da versão e que contribui para os arquivos de símbolo (PDB) correspondentes.Consulte [OBSOLETO] Como especificar locais de símbolos e o comportamento do carregamento.

Compartilhar via