Depure seus aplicativos com o Azure Application Insights no Visual Studio

No Visual Studio (2015 e posterior), você pode analisar o desempenho e diagnosticar problemas em seu aplicativo Web ASP.NET na depuração e na produção usando a telemetria do Application Insights do Azure.

Se você criou seu aplicativo Web ASP.NET usando o Visual Studio 2017 ou posterior, ele já terá o SDK do Application Insights. Caso contrário, se ainda tiver feito isso, adicione o Application Insights ao seu aplicativo.

Para monitorar seu aplicativo quando ele está em produção, você normalmente exibe o Application Insights Telemetry no Portal do Azure, onde você pode definir alertas e aplicar ferramentas de monitoramento avançadas. Mas, para depuração, também é possível pesquisar e analisar a telemetria no Visual Studio. Use o Visual Studio para analisar a telemetria de seu site de produção e de execuções de depuração em seu computador de desenvolvimento. No último caso, você pode analisar execuções de depuração mesmo se ainda não tiver configurado o SDK para enviar telemetria ao Portal do Azure.

Depurar seu projeto

Execute seu aplicativo Web no modo de depuração local usando F5. Abra páginas diferentes para gerar alguma telemetria.

No Visual Studio, você vê uma contagem dos eventos registrados pelo módulo do Application Insights em seu projeto.

In Visual Studio, the Application Insights button shows during debugging.

Clique neste botão para pesquisar na telemetria.

A Janela de pesquisa do Application Insights mostra eventos que foram registrados. (Se você tiver entrado no Azure ao configurar o Application Insights, você poderá pesquisar os mesmos eventos no Portal do Azure.)

Right-click the project and choose Application Insights, Search

Observação

Depois de marcar ou desmarcar filtros, clique no botão Pesquisar no final do campo de pesquisa de texto.

A pesquisa de texto livre funciona em todos os campos dos eventos. Por exemplo, pesquise por parte da URL de uma página; ou pelo valor de uma propriedade, como cidade do cliente; ou por palavras específicas em um log de rastreamento.

Clique em qualquer evento para ver suas propriedades detalhadas.

Para solicitações ao seu aplicativo Web, clique até chegar ao código.

Under Request Details, click through to the code

Você também pode abrir itens relacionados para ajudar a diagnosticar as solicitações com falha ou as exceções.

Under Request Details, scroll down to related items

Exibir exceções e solicitações com falha

Os relatórios de exceção aparecem na Janela de pesquisa. (Em alguns tipos mais antigos do aplicativo ASP.NET, você precisa configurar o monitoramento de exceção para ver as exceções manipuladas pela estrutura.)

Clique em uma exceção para obter um rastreamento de pilha. Se o código do aplicativo for aberto no Visual Studio, você poderá clicar desde o rastreamento de pilha até a linha relevante no código.

Screenshot shows the About object in a stack trace.

Exibir resumos de solicitação e exceção no código

Na linha de CodeLens acima de cada método manipulador, você verá uma contagem das solicitações e exceções registradas pelo Application Insights nas últimas 24 horas.

Screenshot shows an exception in a context dialog box.

Observação

O CodeLens mostrará dados do Application Insights somente se você tiver configurado seu aplicativo para enviar telemetria ao portal do Application Insights.

Saiba mais sobre o Application Insights no CodeLens

Monitoramento local

(Do Visual Studio 2015 Atualização 2) Se você não tiver configurado o SDK para enviar telemetria ao portal do Application Insights (de modo que não haja nenhuma chave de instrumentação em ApplicationInsights.config), então a janela de diagnóstico exibirá a telemetria da sua sessão de depuração mais recente.

Isso será desejável se você já tiver publicado uma versão anterior do seu aplicativo. Você não deseja que a telemetria de suas sessões de depuração se misturem à telemetria no portal do Application Insights do aplicativo publicado.

Também será particularmente útil se você tiver telemetria personalizada que queira depurar antes de enviar a telemetria ao portal.

  • Primeiro, configurei totalmente o Application Insights para enviar a telemetria ao portal. Mas agora eu quero ver a telemetria apenas no Visual Studio.

    • Nas Configurações da janela Pesquisar, há uma opção para pesquisar o diagnóstico local, mesmo se o seu aplicativo enviar telemetria para o portal.
    • Para impedir que os dados telemétricos sejam enviados ao portal, transforme em comentário a linha <instrumentationkey>... de ApplicationInsights.config. Quando você quiser enviá-los novamente para o portal, remova a marca de comentário.

Observação

Em 31 de março de 31, 2025, o suporte à ingestão de chave de instrumentação será encerrado. A ingestão de chave de instrumentação continuará funcionando, mas não forneceremos mais atualizações ou suporte para o recurso. Transição para cadeias de conexão para aproveitar as novas funcionalidades.

Próximas etapas