Application Insights para serviços de nuvem do Azure

  • Artigo

O Application Insights pode monitorar os aplicativos de serviço de nuvem do Azure para analisar a disponibilidade, o desempenho, as falhas e o uso combinando os dados de SDKs do Application Insights com os dados do Diagnóstico do Azure a partir de seus serviços de nuvem. Com os comentários que você obtiver sobre o desempenho e a eficiência de seu aplicativo em uso, você pode fazer escolhas informadas sobre a direção do projeto em cada ciclo de vida de desenvolvimento.

Visão geral do dashboard

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. Faça a transição para cadeias de conexão para aproveitar as novas funcionalidades.

Pré-requisitos

Antes de começar, você precisa de:

  • Uma assinatura do Azure.

    Entrar com sua conta da Microsoft para Windows, Xbox Live ou outros serviços de nuvem da Microsoft.

  • Ferramentas do Microsoft Azure 2.9 ou posteriores.

  • Developer Analytics Tools 7.10 ou posterior.

Introdução rápida

A maneira mais rápida e fácil de monitorar seu serviço de nuvem com o Application Insights é escolher essa opção quando você publica seu serviço no Azure.

Exemplo da página Configurações de Diagnóstico

Esta opção prepara o aplicativo em runtime, oferecendo a você toda a telemetria necessária para monitorar solicitações, exceções e dependências na função Web. Ela também monitora os contadores de desempenho a partir das funções de trabalho. Os rastreamentos de diagnóstico gerados pelo aplicativo também são enviados para o Application Insights.

Se esta opção for tudo o que você precisa, então você terminou.

Suas próximas etapas serão a exibição das métricas em seu aplicativo e a consulta de seus dados com o Analytics.

Para monitorar o desempenho no navegador, talvez você queira configurar os testes de disponibilidade e adicionar código às suas páginas da Web.

As seções a seguir apresentam estas opções adicionais:

  • Enviar dados de vários componentes e criar configurações para separar recursos.
  • Adicione telemetria personalizada do seu aplicativo.

Aplicativo de exemplo preparado com o Application Insights

Neste aplicativo de exemplo, o Application Insights é adicionado a um serviço de nuvem com duas funções de trabalho hospedadas no Azure.

Na seção seguinte, você aprenderá a adaptar seu próprio projeto de serviço de nuvem da mesma maneira.

Planejar recursos e grupos de recursos

A telemetria de seu aplicativo é armazenada, analisada e exibida em um recurso do Azure do tipo Application Insights.

Cada recurso pertence somente a um grupo de recursos. Os grupos de recursos são usados para gerenciar custos, conceder acesso a membros da equipe e implantar atualizações em uma única transação coordenada. Por exemplo, é possível escrever um script para implantar um serviço de nuvem do Azure e seus recursos de monitoramento do Application Insights em uma única operação.

Recursos para componentes

Recomendamos adicionar uma propriedade de dimensão a cada item de telemetria que identifica a própria função de origem. Nessa abordagem, os gráficos de métrica, como de exceções, normalmente apresentam uma agregação das contagens de diversas funções, mas é possível segmentar o gráfico pelo identificador de função, conforme necessário. Também é possível filtrar as pesquisas pela mesma dimensão. Essa alternativa facilita um pouco a visualização de tudo ao mesmo tempo, mas também pode causar uma certa confusão entre as funções.

A telemetria do navegador geralmente é incluída no mesmo recurso que sua função Web do lado servidor.

Coloque os recursos do Application Insights para os vários componentes em um grupo de recursos. Essa abordagem facilita o gerenciamento em conjunto.

Separação de desenvolvimento, teste e produção

Se você estiver desenvolvendo eventos personalizados para o próximo recurso enquanto a versão anterior estiver ativa, será recomendável enviar a telemetria de desenvolvimento para um recurso separado do Application Insights. Caso contrário, pode ser difícil encontrar a telemetria de teste entre todo o tráfego do site ativo.

Para evitar essa situação, crie recursos separados para cada configuração de build ou “stamp” (desenvolvimento, teste, produção, etc.) do sistema. Coloque os recursos para cada configuração de compilação em um grupo de recursos separado.

Para enviar a telemetria para os recursos apropriados, você pode configurar o SDK do Application Insights para que ele escolha uma chave de instrumentação diferente dependendo da configuração de compilação.

Saiba como definir dinamicamente a chave de instrumentação para diferentes estágios.

Criar um recurso do Application Insights para cada função

Se você decidiu criar um recurso separado para cada função (e talvez um conjunto separado para cada configuração de build), é mais fácil criar todos eles no portal do Application Insights. Se você cria muitos recursos, pode automatizar o processo.

  1. No portal do Azure, selecione Novo>Serviços do desenvolvedor>Application Insights.

    Painel do Application Insights

  2. Na lista suspensa Tipo de Aplicativo, selecione Aplicativo Web ASP.NET.

Cada recurso é identificado por uma chave de instrumentação. Você pode precisar dessa chave mais tarde, caso deseje configurar ou verificar a configuração do SDK manualmente.

Configurar o diagnóstico do Azure para cada função

Defina esta opção para monitorar seu aplicativo com o Application Insights. Para funções Web, esta opção fornece monitoramento de desempenho, alertas, diagnóstico e análise de uso. Para as demais funções, você pode pesquisar e monitorar o Diagnóstico do Azure, como reinicialização, contadores de desempenho e chamadas para System.Diagnostics.Trace.

  1. No Gerenciador de Soluções do Visual Studio, em <YourCloudService>>Funções, abra as propriedades de cada função.

  2. Em Configuração, marque a caixa de seleção Enviar dados de diagnóstico para o Application Insights e, então, selecione o recurso do Application Insights criado anteriormente.

Se você tiver optado por usar um recurso Application Insights separado para cada configuração de compilação, selecione primeiro a configuração.

Configurar o Application Insights

Essa ação faz com que as suas chaves de instrumentação do Application Insights sejam inseridas nos arquivos chamados ServiceConfiguration.*.cscfg. Veja o código de exemplo.

Se desejar variar o nível de informações de diagnóstico enviadas ao Application Insights, faça isso editando os arquivos.cscfg diretamente.

Instalar o SDK em cada projeto

Com essa opção, você pode adicionar telemetria personalizada de negócios em qualquer função. A opção fornece uma análise mais próxima de como seu aplicativo é usado e do desempenho dele.

No Visual Studio, configure o SDK do Application Insights para cada projeto de aplicativo de nuvem.

  1. Para configurar as funções Web, clique com o botão direito do mouse no projeto e selecione Configurar Application Insights ou Adicionar > Application Insights Telemetry.

  2. Para configurar as funções de trabalho:

    a. Clique com o botão direito do mouse no projeto e selecione Gerenciar Pacotes NuGet.

    b. Adicione Application Insights para Windows Servers.

  3. Para configurar o SDK para enviar dados ao recurso do Application Insights:

    a. Em uma função de inicialização adequada, defina a chave de instrumentação na configuração no arquivo .cscfg:

        TelemetryConfiguration configuration = TelemetryConfiguration.CreateDefault();
    configuration.InstrumentationKey = RoleEnvironment.GetConfigurationSettingValue("APPINSIGHTS_INSTRUMENTATIONKEY");
    var telemetryClient = new TelemetryClient(configuration);

    b. Repita a "etapa a" para cada função em seu aplicativo. Veja os exemplos:

  4. Defina o arquivo ApplicationInsights.config para sempre ser copiado no diretório de saída.

    Uma mensagem no arquivo . config solicitará que você coloque a chave de instrumentação lá. No entanto, para aplicativos de nuvem, é melhor defini-la no arquivo .cscfg. Essa abordagem garante que a função seja identificada corretamente no portal.

Configurar o Status Monitor para coletar consultas SQL completas (opcional)

Esta etapa só será necessária se você quiser capturar consultas SQL completas no .NET Framework.

  1. No arquivo \*.csdef, adicione a tarefa de inicialização para cada função semelhante a

    <Startup>
  <Task commandLine="AppInsightsAgent\InstallAgent.bat" executionContext="elevated" taskType="simple">
    <Environment>
      <Variable name="ApplicationInsightsAgent.DownloadLink" value="http://go.microsoft.com/fwlink/?LinkID=522371" />
      <Variable name="RoleEnvironment.IsEmulated">
        <RoleInstanceValue xpath="/RoleEnvironment/Deployment/@emulated" />
      </Variable>
    </Environment>
  </Task>
</Startup>

  2. Baixe InstallAgent.bat e InstallAgent.ps1 e coloque-os na pasta AppInsightsAgent em cada projeto de função. Certifique-se de copiá-los para o diretório de saída por meio de scripts de compilação ou propriedades de arquivo do Visual Studio.

  3. Em todas as funções de trabalho, adicione variáveis de ambiente:

      <Environment>
    <Variable name="COR_ENABLE_PROFILING" value="1" />
    <Variable name="COR_PROFILER" value="{324F817A-7420-4E6D-B3C1-143FBED6D855}" />
    <Variable name="MicrosoftInstrumentationEngine_Host" value="{CA487940-57D2-10BF-11B2-A3AD5A13CBC0}" />
  </Environment>

Executar e publicar o aplicativo

  1. Execute o aplicativo e entre no Azure.

  2. Abra os recursos criados do Application Insights.

    Os pontos de dados individuais são exibidos na Pesquisa, e os dados agregados são exibidos no Metrics Explorer.

  3. Adicione mais telemetria (consulte as próximas seções) e, em seguida, publique seu aplicativo para obter comentários em tempo real sobre o diagnóstico e o uso.

Se não houver nenhum dado, faça o seguinte:

  1. Para exibir eventos individuais, abra o bloco Pesquisar.
  2. No aplicativo, abra várias páginas para que ele gere alguma telemetria.
  3. Aguarde alguns segundos e, então, clique em Atualizar.

Exibir eventos do Diagnóstico do Azure

É possível encontrar as informações do Diagnóstico do Azure no Application Insights, nos seguintes locais:

  • Os contadores de desempenho são exibidos como métricas personalizadas.
  • Os logs de eventos do Windows são mostrados como eventos de rastreamentos e personalizados.
  • Logs do aplicativo, logs de ETW e todos os logs de infraestrutura de diagnóstico são exibidos como rastreamentos.

Para exibir os contadores de desempenho e as contagens de eventos, abra o Metrics Explorer e adicione o seguinte gráfico:

Dados de Diagnóstico do Azure

Para pesquisar nos vários logs de rastreamento enviados pelo Diagnóstico do Azure, use a Pesquisa ou uma consulta do Analytics. Por exemplo, imagine que você tem uma exceção sem tratamento que causou a falha e a reciclagem de uma função. Essa informação será mostrada no canal do Aplicativo do Log de Eventos do Windows. É possível usar a Pesquisa para exibir o erro do Log de Eventos do Windows e obter o rastreamento de pilha completo da exceção. Isso lhe ajudará a encontrar a causa raiz do problema.

Pesquisa no Diagnóstico do Azure

Mais telemetria

As seções a seguir mostram como obter telemetria adicional de vários aspectos do seu aplicativo.

Acompanhar as solicitações das funções de trabalho

Nas funções web, o módulo de solicitações automaticamente coleta dados sobre solicitações HTTP. Para obter exemplos de como substituir o comportamento de coleção padrão, consulte o Exemplo MVCWebRole.

Você pode capturar o desempenho das chamadas a funções de trabalho acompanhando-as da mesma maneira como faz com solicitações HTTP. No Application Insights, o tipo de telemetria Solicitação mede uma unidade de trabalho do servidor nomeada que pode ser cronometrada e ser bem-sucedida ou falhar de forma independente. Embora as solicitações HTTP sejam capturadas automaticamente pelo SDK, você pode inserir seu próprio código para acompanhar as solicitações para as funções de trabalho.

Consulte as duas funções de trabalho de exemplo instrumentadas para solicitações de relatório:

Exceções

Para saber mais sobre como coletar exceções sem tratamento de vários tipos de aplicativo Web, consulte o artigo Monitorar exceções no Application Insights.

A função web de exemplo tem controladores MVC5 e API Web 2. As exceções sem tratamento das duas são capturadas com os seguintes manipuladores:

Para as funções de trabalho, você pode acompanhar as exceções de duas formas:

  • Usar TrackException(ex).
  • Se você adicionou o pacote NuGet do ouvinte de rastreamento do Application Insights, use System.Diagnostics.Trace para registrar as exceções, conforme mostrado neste exemplo.

Contadores de desempenho

Os seguintes contadores são coletados por padrão:

  • \Process(??APP_WIN32_PROC??)% Tempo do processador
  • \Memória\Bytes Disponíveis
  • Exceções .NET CLR (??APP_CLR_PROC??)# de exceções lançadas / s
  • \Processo(??APP_WIN32_PROC??)\Bytes Privados
  • \Processo(??APP_WIN32_PROC??)\Bytes de dados de ES/s
  • \Processador(_Total)% de tempo do processador

Para funções web, esses contadores também são coletados:

  • \Aplicativos ASP.NET(??APP_W3SVC_PROC??)\Solicitções/S
  • \Aplicativos ASP.NET (?. APP_W3SVC_PROC?)\Tempo de Execução de Solicitação
  • \Aplicativos ASP.NET (?. APP_W3SVC_PROC?)\Solicitações na Fila do Aplicativo

É possível especificar contadores de desempenho personalizados adicionais ou outros contadores de desempenho do Windows editando o ApplicationInsights.config, conforme mostrado neste exemplo.

Contadores de desempenho

Telemetria correlacionada para as funções de trabalho

Para obter uma experiência de diagnóstico avançada, é possível ver o que ocasionou uma alta solicitação de latência ou a falha dela. Com as funções Web, o SDK configura automaticamente a correlação com a telemetria relacionada.

Para obter essas exibições das funções de trabalho, use um inicializador de telemetria personalizado para definir um atributo de contexto Operation.Id comum para todas as telemetrias. Ao fazer isso, você vê imediatamente se o problema de latência ou falha foi causado por uma dependência ou pelo código.

Aqui está como:

  • Defina a ID de correlação em uma CallContext, conforme mostrado neste exemplo. Nesse caso, estamos usando a ID de solicitação como correlationId.
  • Adicione uma implementação personalizada de TelemetryInitializer para definir a Operation.Id à correlationId que foi definida anteriormente. Para ver um exemplo, consulte ItemCorrelationTelemetryInitializer.
  • Adicione o inicializador de telemetria personalizado. Você pode fazer isso no arquivo ApplicationInsights.config ou no código, conforme mostrado neste exemplo.

Telemetria do cliente

Para obter a telemetria baseada em navegador, como contagens de exibição de página, tempos de carregamento de página ou exceções de script e para escrever a telemetria personalizada em seus scripts de página, consulte Adicionar o SDK do JavaScript a suas páginas da Web.

Testes de disponibilidade

Para certificar-se de que seu aplicativo permaneça operante e responsivo, configure os testes da Web.

Exibir tudo juntos

Para obter uma visão geral do seu sistema, é possível exibir os gráficos de monitoramento da chave em um dashboard. Por exemplo, você pode fixar as contagens de solicitação e de falha de cada função.

Se seu sistema usa outros serviços do Azure, como o Stream Analytics, inclua os gráficos de monitoramento deles também.

Caso tenha um aplicativo cliente móvel, use o App Center. Crie consultas no Analytics para exibir a contagem de eventos e fixe-os ao painel.

Exemplo

O exemplo monitora um serviço que tem uma função web e duas funções de trabalho.

Exceção "método não encontrado" em execução nos serviços de nuvem do Azure

Você compilou para o .NET LTS? Não há suporte automático para versões anteriores nas funções dos serviços de nuvem do Azure. Instale o .NET LTS em cada função antes de executar o aplicativo.

Próximas etapas