Partilhar via


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

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:

O que você deseja fazer?

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
  1. 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.

    View performance event details

    Você também pode clicar duas vezes no evento.

  2. 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.

  3. 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.

    Start debugging from method call

    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.

    Go to application code from performance event

    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
  1. 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
  1. Copie a ID de correlação do SharePoint de sua origem.

    Por exemplo:

    IntelliTrace - SharePoint error - correlation ID

  2. 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.

    IntelliTrace log - Enter SharePoint correlation ID

  3. 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.

      IntelliTrace log file - View web request + events

    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
  1. Escolha uma ID de correlação do SharePoint para uma exceção. As exceções são agrupadas por tipo e pilha de chamadas.

  2. (Opcional) Expanda Pilha de Chamadas para ver a pilha de chamadas para um grupo de exceções.

  3. Escolha Exceção da Depuração para iniciar a depuração no ponto onde e quando a exceção aconteceu.

    IntelliTrace log - SharePoint unhandled exceptions

    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
  1. Em Lista de Threads, escolha um thread.

  2. 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
  1. Expanda Grade de Etapas do Teste. Escolha uma etapa do teste.

  2. 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.

Onde posso obter mais informações?

Usar o coletor autônomo do IntelliTrace

Recursos do IntelliTrace

Coletar mais dados de diagnóstico em testes manuais

IntelliTrace

Fóruns

Depurador do Visual Studio