Depure seus aplicativos com o Aplicativo Azure insights no Visual StudioDebug your applications with Azure Application Insights in Visual Studio

No Visual Studio (versão 2015 e posterior), pode analisar o desempenho e diagnosticar problemas de depuração e produção na sua aplicação Web ASP.NET, com a telemetria do Application Insights do Azure.In Visual Studio (2015 and later), you can analyze performance and diagnose issues in your ASP.NET web app both in debugging and in production, using telemetry from Azure Application Insights.

Se criou a aplicação Web ASP.NET com o Visual Studio 2017 ou posterior, já tem o SDK do Application Insights.If you created your ASP.NET web app using Visual Studio 2017 or later, it already has the Application Insights SDK. Caso contrário, se ainda não o tiver feito, adicione o Application Insights à sua aplicação.Otherwise, if you haven't done so already, add Application Insights to your app.

Para monitorizar a aplicação quando estiver a ser produzida, vê normalmente a telemetria do Application Insights no portal do Azure, onde pode definir alertas e aplicar ferramentas de monitorização poderosas.To monitor your app when it's in live production, you normally view the Application Insights telemetry in the Azure portal, where you can set alerts and apply powerful monitoring tools. Mas, para a depuração, também pode procurar e analisar a telemetria no Visual Studio.But for debugging, you can also search and analyze the telemetry in Visual Studio. Você pode usar o Visual Studio para analisar a telemetria de seu site de produção e das execuções de depuração no computador de desenvolvimento.You can use Visual Studio to analyze telemetry both from your production site and from debugging runs on your development machine. Em último caso, pode analisar as execuções das depurações, mesmo que ainda não tenha configurado o SDK para enviar telemetria para o portal do Azure.In the latter case, you can analyze debugging runs even if you haven't yet configured the SDK to send telemetry to the Azure portal.

Depurar o projetoDebug your project

Execute a aplicação Web no modo de depuração local com o F5.Run your web app in local debug mode by using F5. Abra páginas diferentes para gerar alguma telemetria.Open different pages to generate some telemetry.

No Visual Studio, você vê uma contagem dos eventos que foram registrados pelo módulo Application Insights em seu projeto.In Visual Studio, you see a count of the events that have been logged by the Application Insights module in your project.

No Visual Studio, o botão do Application Insights é apresentado durante a depuração.

Clique neste botão para procurar a sua telemetria.Click this button to search your telemetry.

A janela Pesquisa do Application Insights mostra os eventos que foram registados.The Application Insights Search window shows events that have been logged. (Se você tiver entrado no Azure ao configurar Application Insights, poderá pesquisar os mesmos eventos no portal do Azure.)(If you signed in to Azure when you set up Application Insights, you can search the same events in the Azure portal.)

Clique com o botão direito do rato no projeto e escolha Application Insights, Pesquisa

Nota

Depois de selecionar ou desmarcar filtros, clique no botão Pesquisar no fim do campo de pesquisa de texto.After you select or deselect filters, click the Search button at the end of the text search field.

A pesquisa de texto livre funciona em todos campos dos eventos.The free text search works on any fields in the events. Por exemplo, procurar parte do URL de uma página; ou o valor de uma propriedade como a cidade do cliente; ou palavras específicas no registo de rastreio.For example, search for part of the URL of a page; or the value of a property such as client city; or specific words in a trace log.

Clique em qualquer evento para ver as respetivas propriedades detalhadas.Click any event to see its detailed properties.

Para pedidos para a sua aplicação Web, pode clicar para o código.For requests to your web app, you can click through to the code.

Em Detalhes do Pedido, clique no código

Pode ainda abrir os itens relacionados para ajudar a diagnosticar os pedidos falhados ou as exceções.You can also open related items to help diagnose failed requests or exceptions.

Em Detalhes do Pedido, desloque para baixo para itens relacionados

Exibir exceções e solicitações com falhaView exceptions and failed requests

Apresentação de relatórios de exceção na janela de Pesquisa.Exception reports show in the Search window. (Em alguns tipos mais antigos da aplicação ASP.NET, tem de configurar a monitorização de exceção para ver as exceções que são processadas pelo framework.)(In some older types of ASP.NET application, you have to set up exception monitoring to see exceptions that are handled by the framework.)

Clique numa exceção para obter um rastreio de pilha.Click an exception to get a stack trace. Se abrir o código da aplicação no Visual Studio, pode clicar no rastreio de pilha para a linha relevante do código.If the code of the app is open in Visual Studio, you can click through from the stack trace to the relevant line of the code.

Rastreio de pilha de exceção

Exibir resumos de solicitação e exceção no códigoView request and exception summaries in the code

Na linha de lente de código acima de cada método de manipulador, você verá uma contagem das solicitações e exceções registradas por Application Insights nas últimas 24 h.In the Code Lens line above each handler method, you see a count of the requests and exceptions logged by Application Insights in the past 24 h.

Rastreio de pilha de exceção

Nota

O Código Lente mostra os dados do Application Insights apenas se tiver configurado a sua aplicação para enviar telemetria para o portal do Application Insights.Code Lens shows Application Insights data only if you have configured your app to send telemetry to the Application Insights portal.

Saiba mais sobre o Application Insights no Código LenteMore about Application Insights in Code Lens

Tendências é uma ferramenta para visualizar a forma como a aplicação se comporta ao longo do tempo.Trends is a tool for visualizing how your app behaves over time.

Selecione Explorar Tendências de Telemetria no botão da barra de ferramentas do Application Insights ou na janela Pesquisa do Application InsightsChoose Explore Telemetry Trends from the Application Insights toolbar button or Application Insights Search window. Escolha uma das cinco consultas comuns para começar.Choose one of five common queries to get started. Pode analisar os diferentes conjuntos de dados com base em tipos de telemetria, intervalos de tempo e outras propriedades.You can analyze different datasets based on telemetry types, time ranges, and other properties.

Para localizar anomalias nos seus dados, escolha uma das opções anómalas na lista pendente "Tipo de Vista".To find anomalies in your data, choose one of the anomaly options under the "View Type" dropdown. As opções de filtragem na parte inferior da janela facilitam a maximização de subconjuntos específicos da sua telemetria.The filtering options at the bottom of the window make it easy to hone in on specific subsets of your telemetry.

Tendências

Mais informações sobre as Tendências.More about Trends.

Monitorização localLocal monitoring

(A partir do Visual Studio 2015 atualização 2) Se você não tiver configurado o SDK para enviar telemetria para o portal de Application Insights (para que não haja nenhuma chave de instrumentação em ApplicationInsights. config), a janela de diagnóstico exibirá a telemetria da sessão de depuração mais recente.(From Visual Studio 2015 Update 2) If you haven't configured the SDK to send telemetry to the Application Insights portal (so that there is no instrumentation key in ApplicationInsights.config) then the diagnostics window displays telemetry from your latest debugging session.

Esta ação é desejável se já tiver publicado uma versão anterior da aplicação.This is desirable if you have already published a previous version of your app. De certeza que não quer que a telemetria das suas sessões de depuração seja misturada com a telemetria no portal do Application Insights da aplicação publicada.You don't want the telemetry from your debugging sessions to be mixed up with the telemetry on the Application Insights portal from the published app.

Também poderá ser útil se tiver alguma telemetria personalizada que pretende depurar antes de enviar a telemetria ao portal.It's also useful if you have some custom telemetry that you want to debug before sending telemetry to the portal.

  • A princípio, configurei totalmente Application Insights para enviar telemetria ao Portal. Mas agora eu gostaria de ver a telemetria somente no Visual Studio.At first, I fully configured Application Insights to send telemetry to the portal. But now I'd like to see the telemetry only in Visual Studio.

    • Nas Definições da janela Pesquisa, encontrará uma opção para procurar o diagnóstico local, mesmo se a sua aplicação enviar telemetria para o portal.In the Search window's Settings, there's an option to search local diagnostics even if your app sends telemetry to the portal.
    • Para parar a telemetria sendo enviada ao portal, comente a linha <instrumentationkey>... de ApplicationInsights. config. Quando você estiver pronto para enviar telemetria para o portal novamente, remova a marca de comentário.To stop telemetry being sent to the portal, comment out the line <instrumentationkey>... from ApplicationInsights.config. When you're ready to send telemetry to the portal again, uncomment it.

Passos seguintesNext steps

Adicionar mais dadosAdd more data
Monitorize a utilização, a disponibilidade, as dependências e as exceções.Monitor usage, availability, dependencies, exceptions. Integre rastreios a partir de arquiteturas de registo.Integrate traces from logging frameworks. Grave a telemetria personalizada.Write custom telemetry.
Visual Studio
Trabalhar com o portal do Application InsightsWorking with the Application Insights portal
Exiba painéis, ferramentas de diagnóstico e analítica poderosas, alertas, um mapa de dependências ao vivo de seu aplicativo e dados de telemetria exportados.View dashboards, powerful diagnostic and analytic tools, alerts, a live dependency map of your application, and exported telemetry data.
Visual Studio