Usando dados do IntelliTrace salvos (C#, Visual Basic, C++)Using saved IntelliTrace data (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).Go to specific points in your application's execution when you start debugging from an IntelliTrace log (.iTrace) file. 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.This file can contain performance events, exceptions, threads, test steps, modules, and other system info that IntelliTrace records while your app runs.

Certifique-se de que você tenha:Make sure that you have:

O que você deseja fazer?What do you want to do?

Abrir um log do IntelliTraceOpen an IntelliTrace log

Em um computador com Visual Studio Enterprise, abra o arquivo. iTrace.On a computer with Visual Studio Enterprise, open the .iTrace file.

  • Clique duas vezes no arquivo .iTrace fora do Visual Studio ou abra o arquivo de dentro do Visual Studio.Double-click the .iTrace file outside Visual Studio, or open the file from inside Visual Studio.

    - ou –- or -

  • Se o arquivo .iTrace estiver anexado a um item de trabalho do Team Foundation Server, siga estas etapas no item de trabalho:If the .iTrace file is attached to a Team Foundation Server work item, follow these steps in the work item:

    • Em Todos os Links, localize o arquivo .iTrace.Under All Links, find the .iTrace file. Abra-o.Open it.

      - ou –- or -

    • Em Etapas de Reprodução, escolha o link IntelliTrace.Under Repro Steps, choose the IntelliTrace link.

Dica

Se você fechou o arquivo IntelliTrace durante a depuração, poderá reabri-lo facilmente.If you closed the IntelliTrace file during debugging, you can reopen it easily. Vá para o menu Depurar, escolha IntelliTrace, Mostrar Resumo do Log.Go to the Debug menu, choose IntelliTrace, Show Log Summary. Você também pode escolher Mostrar Resumo do Log na janela IntelliTrace.You can also choose Show Log Summary in the IntelliTrace window. Isso só estará disponível durante a depuração com o IntelliTrace.This is available only while debugging with IntelliTrace.

Entender o log do IntelliTraceUnderstand the IntelliTrace log

Algumas das seções a seguir no arquivo. iTrace aparecerão somente se você coletou dados de uma fonte específica, por exemplo, de aplicativos do SharePoint.Some of the following sections in the .iTrace file appear only if you collected data from a particular source, for example, from SharePoint applications.

SeçãoSection ContémContains Origem de coletaCollection Source
Violações de desempenhoPerformance Violations Eventos de desempenho com chamadas de função que excedam o limite configuradoPerformance events with function calls that exceed the configured threshold Microsoft Monitoring Agent, um coletor autônomo ou com o System Center 2012 R2 Operations Manager para aplicativos Web ASP.NET hospedados no IISMicrosoft Monitoring Agent, either standalone collector or with System Center 2012 R2 Operations Manager for ASP.NET web apps hosted on IIS
Dados de exceçãoException Data Exceções, incluindo toda a pilha de chamadas para cada exceçãoExceptions, including the full call stack for each exception Todas as fontesAll sources
AnalisaAnalysis Somente para aplicativos do SharePoint 2010 e do SharePoint 2013.For SharePoint 2010 and SharePoint 2013 applications only. 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.Diagnose IntelliTrace and SharePoint events, such as debugger events, ULS events, unhandled exceptions, and other data that the Microsoft Monitoring Agent recorded. Microsoft Monitoring Agent, um coletor autônomo ou com o System Center 2012 R2 Operations ManagerMicrosoft Monitoring Agent, either standalone collector or with System Center 2012 R2 Operations Manager
Informações do sistemaSystem Info Configurações e especificações do sistema hostSettings and specifications of the host system Todas as fontesAll sources
Lista de threadsThreads List Threads executados durante a coletaThreads that ran during collection Todas as fontesAll sources
MódulosModules Módulos que o processo de destino carregou na ordem em que foram carregados.Modules that the target process loaded in the order that they loaded. Todas as fontesAll sources
Solicitação da WebWeb Request Dados de solicitação da Web para aplicativos Web do IIS de produção e SharePoint 2010 e SharePoint 2013Web request data for production IIS web applications and SharePoint 2010 and SharePoint 2013 Microsoft Monitoring Agent e o coletor autônomoMicrosoft Monitoring Agent and the standalone collector

Aqui estão algumas dicas para ajudar a localizar informações sobre cada seção:Here's some tips to help you find information in each section:

  • Escolha um cabeçalho de coluna para classificar dados.Choose a column header to sort data.

  • Use a caixa de pesquisa para filtrar dados.Use the search box to filter data. A pesquisa de texto sem formatação funciona em todas as colunas, exceto nas colunas de tempo.Plain text search works across all columns except the time columns. Você também pode filtrar pesquisas para uma coluna específica com um filtro por coluna.You can also filter searches to a specific column with one filter per column. Digite o nome da coluna sem espaços, dois-pontos (:) e o valor de pesquisa.Type the column name with no spaces, a colon (:), and the search value. Depois disso, use um ponto-e-vírgula (;) para adicionar outro valor de coluna e de pesquisa.Follow this with a semicolon (;) to add another column and search value.

    Por exemplo, para localizar os eventos de desempenho que tenham a palavra "lento" na coluna Descrição, digite:For example, to find performance events that have the word "slow" in the Description column, type:

    Description:slow

Iniciar depuração a partir de um log do IntelliTraceStart debugging from an IntelliTrace log

Violações de desempenhoPerformance Violations

Revise os eventos de desempenho que foram registrados para seu aplicativo.Review the performance events that were recorded for your app. Você pode ocultar esses eventos que não ocorrem com frequência.You can hide those events that don't happen often.

Para iniciar a depuração de um evento de desempenhoTo start debugging from a performance event
  1. Em Violações de Desempenho, revise os eventos de desempenho gravados, o tempo de execução total e outras informações dos eventos.Under Performance Violations, review the recorded performance events, their total execution times, and other event information. Em seguida, verifique um pouco mais os métodos que foram chamados durante um evento de desempenho específico.Then dig deeper into the methods that were called during a specific performance event.

    Exibir detalhes do evento de desempenhoView performance event details

    Você também pode clicar duas vezes no evento.You can also just double-click the event.

  2. Na página de eventos, revise o tempo de execução dessas chamadas.On the event page, review the execution times for these calls. Localize uma chamada lenta na árvore de execução.Find a slow call in the execution tree.

    As chamadas mais lentas aparecem em sua própria seção quando você tem várias chamadas, aninhadas ou de outra maneira.The slowest calls appear in their own section when you have multiple calls, nested or otherwise.

  3. Expanda essa chamada para revisar qualquer chamada e aninhada e os valores de parâmetro gravados nesse momento.Expand that call to review any nested calls and parameter values that were recorded at that point in time.

    (Teclado: para mostrar ou ocultar uma chamada aninhada, pressione a tecla Seta para a direita ou Seta para a esquerda, respectivamente.(Keyboard: To show or hide a nested call, press the Right Arrow or Left Arrow key respectively. Para mostrar e ocultar valores de parâmetro para uma chamada aninhada, pressione a tecla Espaço.)To show and hide parameter values for a nested call, press the Space key.)

    Comece a depuração pela chamada.Start debugging from the call.

    Iniciar a depuração da chamada de métodoStart debugging from method call

    Você também pode simplesmente clicar duas vezes na chamada ou pressionar a tecla Enter.You can also just double-click the call or press the Enter key.

    Se o método estiver no código do aplicativo, o Visual Studio irá para esse método.If the method is in your application code, Visual Studio goes to that method.

    Ir para o código do aplicativo do evento de desempenhoGo 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.Now you can review other recorded values, the call stack, step through your code, or use the IntelliTrace window to move backwards or forwards "in time" between other methods that were called during this performance event.

Dados de exceçãoException Data

Revise as exceções acionadas e que foram registradas para seu aplicativo.Review the exceptions that were thrown and recorded for your app. 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.You can group exceptions that have the same type and call stack so that you see only the most recent exception.

Para iniciar a depuração a partir de uma exceçãoTo start debugging from an exception
  1. Em Dados da Exceção, revise os eventos de exceção gravados, seus tipos, mensagens e quando as exceções aconteceram.Under Exception Data, review the recorded exception events, their types, messages, and when the exceptions happened. Para se aprofundar no código, comece com a depuração do evento mais recente em um grupo de exceções.To dig deeper into the code, start debugging from the most recent event in a group of exceptions.

    Iniciar Depuração do evento de exceçãoStart debugging from exception event

    Você também pode clicar duas vezes no evento.You can also just double-click the event. Se os eventos não estiverem agrupados, escolha Depurar Este Evento.If the events aren't grouped, choose Debug This Event.

    Se a exceção ocorreu no código do aplicativo, o Visual Studio irá para o local onde a exceção ocorreu.If the exception happened in your application code, Visual Studio goes to where the exception happened.

    Ir para o código do aplicativo a partir de um evento de exceçãoGo 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.Now you can review other recorded values, the call stack, or use the IntelliTrace window to move backwards or forwards "in time" between other recorded events, related code, and the values recorded at those points in time.

    ColunaColumn ExibeShows the
    TipoType Tipo .NET da exceção.NET type of the exception
    Mensagem Mais Recente para exceções agrupadas ou Mensagem para exceções não agrupadasNewest Message for grouped exceptions or Message for ungrouped exceptions A mensagem fornecida pela exceçãoThe message provided by the exception
    Contagem para exceções agrupadasCount for grouped exceptions O número de vezes em que a exceção foi acionadaThe number of times the exception was thrown
    ID do Thread para exceções não agrupadasThread ID for ungrouped exceptions ID do thread que acionou a exceçãoID of the thread that threw the exception
    Horário do Evento Mais Recente ou Hora do EventoNewest Event Time or Event Time Carimbo de data/hora registrado quando a exceção foi acionadaTime stamp recorded when the exception was thrown
    Pilha de chamadasCall Stack Pilha de chamadas para uma exceção.Call stack for an exception.

    Para ver a pilha de chamadas, escolha uma exceção na lista.To see the call stack, choose an exception in the list. A pilha de chamadas aparece abaixo da lista de exceções.The call stack appears below the exception list.

AnalisaAnalysis

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.Diagnose problems with SharePoint 2010 and SharePoint 2013 applications by using a SharePoint correlation ID or review any unhandled exceptions that Microsoft Monitoring Agent found.

  • Use uma ID de correlação do SharePoint para localizar sua solicitação da Web e eventos correspondentes.Use a SharePoint correlation ID to find its matching web request and events. Escolha um evento e inicie a depuração no ponto onde e quando o evento ocorreu.Choose an event and then start debugging at the point where and when the event happened.

  • 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.If Microsoft Monitoring Agent found unhandled exceptions, choose an exception and then start debugging at the point where and when the exception happened.

Iniciar depuração com uma ID de correlação do SharePointStart debugging with a SharePoint correlation ID
  1. Copie a ID de correlação do SharePoint de sua origem.Copy the SharePoint correlation ID from its source.

    Por exemplo:For example:

    Erro do IntelliTrace - SharePoint - ID de correlaçãoIntelliTrace - 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.Open the .iTrace file, then go to Analysis and enter the SharePoint correlation ID to review the matching web request and recorded events.

    Log do IntelliTrace - Insira a ID de correlação do SharePointIntelliTrace log - Enter SharePoint correlation ID

  3. Sob Eventos de Solicitação, examine os eventos.Under Request Events, examine the events. A partir da parte superior, os eventos aparecem na ordem em que aconteceram.Starting from the top, events appear in the order that they happened.

    1. Escolha um evento para ver seus detalhes.Choose an event to see its details.

    2. Escolha Iniciar Depuração para iniciar depuração no ponto onde o evento aconteceu.Choose Start Debugging to start debugging at the point where the event happened.

      Arquivo de log do IntelliTrace - exibir eventos de + de solicitação da WebIntelliTrace log file - View web request + events

    Você pode ver esses tipos de eventos do SharePoint com eventos do IntelliTrace:You can see these kinds of SharePoint events along with IntelliTrace events:

  • Eventos de perfil de usuárioUser profile events

    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.These events happen when SharePoint loads a user profile and when user profile properties are read or changed.

  • Eventos do ULS (Unified Logging System)Unified Logging System (ULS) events

    O Microsoft Monitoring Agent registra um subconjunto de eventos ULS do SharePoint ULS e destes campos:Microsoft Monitoring Agent records a subset of SharePoint ULS events and these fields:

    Campo do IntelliTraceIntelliTrace field Campo do ULS do SharePointSharePoint ULS field
    IDID EventIDEventID
    LevelLevel LevelLevel
    ID da categoriaCategory ID ID da categoriaCategory ID
    CategoriaCategory CategoriaCategory
    ÁreaArea ProductProduct
    SaídaOutput MensagemMessage
    ID de CorrelaçãoCorrelation ID ID de CorrelaçãoCorrelation ID
Iniciar depuração a partir de uma exceção sem tratamentoStart debugging from an unhandled exception
  1. Escolha uma ID de correlação do SharePoint para uma exceção.Choose a SharePoint correlation ID for an exception. As exceções são agrupadas por tipo e pilha de chamadas.Exceptions are grouped by type and call stack.

  2. (Opcional) Expanda Pilha de Chamadas para ver a pilha de chamadas para um grupo de exceções.(Optional) Expand Call Stack to see the call stack for a group of exceptions.

  3. Escolha Exceção da Depuração para iniciar a depuração no ponto onde e quando a exceção aconteceu.Choose Debug Exception to start debugging at the point where and when the exception happened.

    Log do IntelliTrace - exceções não tratadas do SharePointIntelliTrace log - SharePoint unhandled exceptions

    Para obter instruções, consulte Walkthrough: Depurando um aplicativo do SharePoint usando o IntelliTrace.For a walkthrough, see Walkthrough: Debugging a SharePoint Application by Using IntelliTrace. Para os tipos de dados que o agente registra, consulte recursos do IntelliTrace.For the kinds of data that the agent records, see IntelliTrace Features.

Lista de threadsThreads List

Examine os threads registrados executados no processo de destino.Examine the recorded threads that ran in the target process. Você pode iniciar a depuração do primeiro evento válido do IntelliTrace em um thread selecionado.You can start debugging from the first valid IntelliTrace event in a selected thread.

Para iniciar a depuração de um thread específicoTo start debugging from a specific thread
  1. Em Lista de Threads, escolha um thread.Under Threads List, choose a thread.

  2. Na parte inferior da Lista de Threads, escolha Iniciar Depuração.At the bottom of Threads List, choose Start Debugging. Você também pode clicar duas vezes em um thread.You can also double-click a thread.

    Para iniciar a depuração de onde o aplicativo começa, clique duas vezes em Thread Principal.To start debugging from where the app begins, double-click Main Thread. Consulte recursos do IntelliTrace.See IntelliTrace Features.

    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.Thread data that the user creates might be more useful than threads that a server creates and manages for IIS-hosted Web apps.

ColunaColumn ExibeShows the
IDID Número de ID do threadThread ID number
NomeName Nome do thread.Thread name. Os threads sem nome aparecem como " <No Name> ".Unnamed threads appear as "<No Name>".
Start TimeStart Time A hora em que o thread foi criadoTime the thread was created
Hora de términoEnd Time A hora em que o thread foi concluídoTime the thread was completed
Para iniciar a depuração de uma etapa específica do testeTo start debugging from a specific test step
  1. Expanda Grade de Etapas do Teste.Expand Test Steps Grid. Escolha uma etapa do teste.Choose a test step.

  2. Na parte inferior da Grade de Etapas do Teste, escolha Iniciar Depuração.At the bottom of Test Steps Grid, choose Start Debugging. Você também pode clicar duas vezes em uma etapa de teste.You can also double-click a test step.

    Isso inicia a depuração do primeiro evento válido do IntelliTrace após a etapa selecionada do teste.This starts debugging from the first valid IntelliTrace event after the selected test step.

    Quando houver dados de teste, o IntelliTrace tentará resolver a compilação do Team Foundation Server associada usada para executar o teste.When test data exists, IntelliTrace tries to resolve the associated Team Foundation Server build that was used to perform the test run. Se a compilação for encontrada, os símbolos associados ao aplicativo serão resolvidos automaticamente.If the build is found, the associated symbols for the app are resolved automatically.

CampoField ExibeShows the
Sessão de testeTest Session Sessões de teste que foram registradas.Test sessions that were recorded. Normalmente, há apenas uma.Typically, there is only one. Esta lista estará vazia se os dados de teste tiverem sido criados usando um teste exploratório manual.This list is empty if test data was created using a manual exploratory test.
Caso de testeTest Case Casos de teste da sessão de teste selecionada.Test cases from the selected test session. Esta lista estará vazia se os dados de teste tiverem sido criados usando um teste exploratório manual.This list is empty if test data was created using a manual exploratory test.
Grade de etapas do testeTest Steps Grid Etapas de teste que foram registradas com o resultado de teste de aprovação ou de falhaTest steps that were recorded with the test result of pass or fail

Informações do sistemaSystem Info

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.This section shows you details about the system that hosted the app, for example, hardware, operating system, environmental and process-specific information.

MódulosModules

Esta seção mostra os módulos que o processo de destino carregou.This section shows you the modules that the target process loaded. Os módulos aparecem na ordem em que foram carregados.Modules appear in the order that they loaded.

ColunaColumn ExibeShows the
Nome do móduloModule Name Nome do arquivo do móduloModule file name
Caminho do MóduloModule Path Local do disco onde o módulo foi carregadoDisk location where the module was loaded
ID do móduloModule ID O identificador exclusivo do módulo que é específico da versão e que contribui para os arquivos de símbolo (PDB) correspondentes.Unique identifier of the module that is version-specific and contributes to the matching symbol (PDB) files. Consulte localizando arquivos de símbolo (. pdb) e arquivos de origem.See Finding symbol (.pdb) files and source files.

Onde posso obter mais informações?Where can I get more information?

Usar o coletor autônomo do IntelliTraceUsing the IntelliTrace stand-alone collector

Recursos do IntelliTraceIntelliTrace Features

Coletar mais dados de diagnóstico em testes manuaisCollect more diagnostic data in manual tests

IntelliTraceIntelliTrace

FórunsForums

Depurador do Visual StudioVisual Studio Debugger

DiretrizesGuidance

Teste para Entrega Contínua com o Visual Studio 2012 – Capítulo 6: Caixa de ferramentas de testeTesting for Continuous Delivery with Visual Studio 2012 - Chapter 6: A Testing Toolbox