Usar dados salvos do IntelliTrace (C#, Visual Basic, C++)

Artigo
04/10/2023

Vá para os pontos específicos da execução do aplicativo quando você iniciar a depuração de um arquivo de log do IntelliTrace (.iTrace). Esse arquivo pode conter eventos de desempenho, exceções, threads, etapas de teste, módulos e outras informações do sistema que o IntelliTrace registra durante a execução do seu aplicativo.

Certifique-se de que você tenha:

Arquivos de origem e arquivos de símbolo (.pdb) compatíveis com seu código de aplicativo. Caso contrário, o Visual Studio não pode resolver os locais de origem e mostra a mensagem "Símbolos não encontrados". Confira Especificar símbolo (.pdb) e arquivos de origem e Diagnosticar problemas após a implantação.
Visual Studio Enterprise (mas não edições Professional ou Community) em seu computador de desenvolvimento ou outro computador para abrir arquivos .iTrace

Um arquivo .iTrace de uma destas origens:

Origem	Consulte
Uma sessão do IntelliTrace no Visual Studio Enterprise (mas não nas edições Professional ou Community)	Recursos do IntelliTrace
Microsoft Monitoring Agent, sozinho ou com o System Center 2012 R2 Operations Manager, para aplicativos Web do ASP.NET e aplicativos do SharePoint em execução na implantação	- Diagnosticar problemas após a implantação - Novidades do System Center 2012 R2 Operations Manager

O que você deseja fazer?

Abrir um log do IntelliTrace
Noções básicas sobre o log do IntelliTrace
Iniciar depuração a partir de um log do IntelliTrace

Abrir um 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 IntelliTrace durante a depuração, poderá reabri-lo facilmente. Vá para o menu Depurar, escolha IntelliTrace, Mostrar Resumo do Log. Você também pode escolher Mostrar Resumo do Log na janela IntelliTrace. Isso só estará disponível durante a depuração com o IntelliTrace.

Compreender o 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, de aplicativos do SharePoint.

Seção	Contém	Origem de coleta
Violações de desempenho	Eventos de desempenho com chamadas de função que excedam o limite configurado	Microsoft Monitoring Agent, standalone collector ou com o System Center 2012 R2 Operations Manager para aplicativos Web do ASP.NET hospedados no IIS
Dados de exceção	Exceções, incluindo toda a pilha de chamadas para cada exceção	Todas as fontes
Análise	Somente para aplicativos do SharePoint 2010 e do SharePoint 2013. Diagnostique eventos do IntelliTrace e do SharePoint, como eventos do depurador, eventos de ULS, exceções não identificadas e outros dados que o Microsoft Monitoring Agent registrou.	Microsoft Monitoring Agent, standalone collector ou com o System Center 2012 R2 Operations Manager
Informações do sistema	Configurações e especificações do sistema host	Todas as fontes
Lista de threads	Threads executados durante a coleta	Todas as fontes
Módulos	Módulos que o processo de destino carregou na ordem em que foram carregados.	Todas as fontes
Solicitação da Web	Dados de solicitação da Web para aplicativos Web IIS de produção e SharePoint 2010 e SharePoint 2013	Microsoft Monitoring Agent e o standalone collector

Aqui estão algumas dicas para ajudar a localizar informações sobre cada seção:

Escolha um cabeçalho de coluna para classificar dados.
Use a caixa de pesquisa para filtrar dados. A pesquisa de texto sem formatação funciona em todas as colunas, exceto nas colunas de tempo. Você também pode filtrar pesquisas para uma coluna específica com um filtro por coluna. Digite o nome da coluna sem espaços, dois-pontos (:) e o valor de pesquisa. Depois disso, use um ponto-e-vírgula (;) para adicionar outro valor de coluna e de pesquisa.

Por exemplo, para localizar os eventos de desempenho que tenham a palavra "lento" na coluna Descrição, digite:

Description:slow

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

Violações de desempenho

Revise os eventos de desempenho que foram registrados para seu aplicativo. Você pode ocultar esses eventos que não ocorrem com frequência.

Para iniciar a depuração de um evento de desempenho

Em Violações de Desempenho, revise os eventos de desempenho gravados, o tempo de execução total e outras informações dos eventos. Em seguida, verifique um pouco mais os métodos que foram chamados durante um evento de desempenho específico.

Você também pode clicar duas vezes no evento.
Na página de eventos, revise o tempo de execução dessas chamadas. Localize uma chamada lenta na árvore de execução.

As chamadas mais lentas aparecem em sua própria seção quando você tem várias chamadas, aninhadas ou de outra maneira.
Expanda essa chamada para revisar qualquer chamada e aninhada e os valores de parâmetro gravados nesse momento.

(Teclado: para mostrar ou ocultar uma chamada aninhada, pressione a tecla Seta para a direita ou Seta para a esquerda, respectivamente. Para mostrar e ocultar os valores dos parâmetros de uma chamada aninhada, pressione a tecla Espaço).

Comece a depuração pela chamada.

Você também pode simplesmente clicar duas vezes na chamada ou pressionar a tecla Enter.

Se o método estiver no código do aplicativo, o Visual Studio irá para esse método.

Agora você pode revisar outros valores gravados, a pilha de chamadas, navegar por código, ou usar a janela do IntelliTrace para avançar ou retornar "no tempo" entre outros métodos que foram chamados durante esse evento de desempenho.

Dados de Exceção

Revise as exceções acionadas e que foram registradas para seu aplicativo. Você pode agrupar as exceções que tenham o mesmo tipo e a mesma pilha de chamadas de forma que você veja apenas a exceção mais recente.

Para iniciar a depuração a partir de uma exceção

Em Dados da Exceção, revise os eventos de exceção gravados, seus tipos, mensagens e quando as exceções aconteceram. Para se aprofundar no código, comece com a depuração do evento mais recente em um grupo de exceções.

Start debugging from exception event

Você também pode clicar duas vezes no evento. Se os eventos não estiverem agrupados, escolha Depurar Este Evento.

Se a exceção ocorreu no código do aplicativo, o Visual Studio irá para o local onde a exceção ocorreu.

Go to application code from an exception event

Agora você pode revisar outros valores gravados, a pilha de chamadas, ou usar a janela do IntelliTrace para avançar ou retornar "no tempo" entre outros eventos gravados, o código relativo e os valores gravados nesses momentos.

Coluna	Exibe
Tipo	Tipo .NET da exceção
Mensagem Mais Recente para exceções agrupadas ou Mensagem para exceções não agrupadas	A mensagem fornecida pela exceção
Contagem para exceções agrupadas	O número de vezes em que a exceção foi acionada
ID do Thread para exceções não agrupadas	ID do thread que acionou a exceção
Horário do Evento Mais Recente ou Hora do Evento	Carimbo de data/hora registrado quando a exceção foi acionada
Pilha de chamadas	Pilha de chamadas para uma 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.

Análise

Diagnostique problemas com os aplicativos do SharePoint 2010 e do SharePoint 2013 usando uma ID de correlação do SharePoint ou examine qualquer exceção sem tratamento encontrada pelo Microsoft Monitoring Agent.

Use uma ID de correlação do SharePoint para localizar sua solicitação da Web e eventos correspondentes. Escolha um evento e inicie a depuração no ponto onde e quando o evento ocorreu.
Se o Microsoft Monitoring Agent encontrou exceções sem tratamento, escolha uma exceção e inicie a depuração no ponto onde e quando a exceção ocorreu.

Iniciar depuração com uma ID de correlação do SharePoint

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

Por exemplo:
Abra o arquivo .iTrace, vá para Análise e digite a ID de correlação do SharePoint para revisar a solicitação da Web e os eventos registrados correspondentes.
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 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 alteradas.

Eventos do ULS (Unified Logging System)

O Microsoft Monitoring Agent registra um subconjunto de eventos ULS do SharePoint ULS e destes campos:

Campo do IntelliTrace	Campo do ULS do SharePoint
ID	EventID
Level	Level
ID da categoria	ID da categoria
Categoria	Categoria
Área	Product
Saída	Mensagem
ID de Correlação	ID de Correlação

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

Escolha uma ID 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 Exceção da Depuração para iniciar a depuração no ponto onde e quando a exceção aconteceu.

Para obter um passo a passo, confira Passo a passo: depurar um aplicativo do SharePoint usando o IntelliTrace. Para obter os tipos de dados que o agente registra, confira Recursos do IntelliTrace.

Lista de threads

Examine 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. Confira Funcionalidades do IntelliTrace.

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 Web hospedados pelo IIS.

Coluna	Exibe
ID	Número de ID do thread
Nome	Nome do thread. Threads sem nome aparecem como "<Sem nome>".
Start Time	A hora em que o thread foi criado
Hora de término	A hora em que o thread foi concluído

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 ao aplicativo serão resolvidos automaticamente.

Campo	Exibe
Sessão de teste	Sessões de teste que foram registradas. Normalmente, há apenas uma. Esta lista estará vazia se os dados de teste tiverem sido criados usando um teste exploratório manual.
Caso de teste	Casos 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	Exibe
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 do módulo que é específico da versão e que contribui para os arquivos de símbolo (PDB) correspondentes. Confira Arquivos de símbolo de localização (.pdb) e arquivos de origem.