Habilitar o .NET Profiler para aplicativos do Serviço de Aplicativo do Azure no Windows

O Application Insights Profiler para .NET é preinstalado como parte do runtime do Serviço de Aplicativo do Azure. Você pode executar o Profiler em aplicativos ASP.NET e ASP.NET Core em execução no Serviço de Aplicativo usando a camada de serviço Básico ou superior.

A instalação sem código do Application Insights Profiler para .NET segue a política de suporte do .NET Core. O Azure suporta-o apenas em aplicações web baseadas em Windows .

Para ativar o .NET Profiler no Linux, veja Ativar o .NET Profiler para aplicações Azure App Service em Linux.

Pré-requisitos

  • Um aplicativo ASP.NET/ASP.NET Core do Serviço de Aplicativo do Azure.
  • Um recurso do Application Insights conectado à sua aplicação no App Service.

Verifique se a configuração "Sempre ativado" está ativada

  1. No portal Azure, vá à sua instância de App Service.

  2. No menu à esquerda, selecione Configurações>Configuração.

    Captura de ecrã que mostra selecionar Configuração no menu esquerdo.

  3. Selecione Configurações gerais.

  4. Verifica se Sempre ligado está definido para Ligado.

    Nota

    Se o Sempre ligado estiver desativado, atualize a sua aplicação web do Serviço de Aplicações para correr no nível Básico ou superior.

    Captura de tela que mostra a guia Geral no painel Configuração mostrando que o Always On está habilitado.

  5. Selecione Salvar se tiver feito alterações.

Ativar o Application Insights e o .NET Profiler

Você pode ativar o Profiler quando:

Para o Application Insights e o App Service dentro da mesma assinatura

Se o recurso do Application Insights estiver na mesma assinatura que a instância do Serviço de Aplicações:

  1. No menu esquerdo da sua instância do Serviço de Aplicações, selecione Monitorizar>Insights da Aplicação.

  2. Selecione Ativar Application Insights.

    Captura de tela que mostra a ativação do Application Insights para seu aplicativo.

  3. Na página de definição Application Insights, em Application Insights, selecione Ativar.

  4. Verifique se você conectou um recurso do Application Insights ao seu aplicativo.

    Captura de tela que mostra a habilitação do Application Insights em seu aplicativo.

  5. Role para baixo e selecione a guia .NET ou .NET Core, dependendo do seu aplicativo.

  6. Para o nível da Coleção, selecione Recomendado.

  7. Em Profiler e Otimizações de código, selecione Ativado. Se você escolheu o nível de coleção Básico anteriormente, a configuração do Profiler será desabilitada.

    Captura de ecrã que mostra a ativação do Profiler na sua aplicação.

  8. Selecione Candidatar-se e depois Sim para confirmar.

Para o Application Insights e o App Service em subscrições distintas

Se o seu recurso Application Insights estiver numa subscrição diferente da sua instância do App Service, precisa de ativar manualmente o Profiler para .NET. Ative-o criando as definições da aplicação para a sua instância de Serviço de Aplicações. Você pode automatizar a criação dessas configurações usando um modelo ou outros meios. Aqui estão as configurações necessárias para ativar o Profiler.

Definição da aplicação Valor
APPLICATIONINSIGHTS_CONNECTION_STRING Obtenha este valor na página de Visão Geral do seu recurso Application Insights.
APPINSIGHTS_PROFILERFEATURE_VERSION 1.0.0
DiagnosticServices_EXTENSION_VERSION ~3

Defina estes valores usando:

Habilite o .NET Profiler para nuvens regionais

Atualmente, as únicas regiões que exigem modificações de endereços finais são o Azure Government e o Microsoft Azure operado pela 21Vianet.

Definição da aplicação Nuvem do governo dos EUA Nuvem da China
ApplicationInsightsProfilerEndpoint https://profiler.monitor.azure.us https://profiler.monitor.azure.cn
ApplicationInsightsEndpoint https://{region}.in.applicationinsights.azure.us https://{region}.in.applicationinsights.azure.cn

Compare os pontos de extremidade do Azure Public e do Azure Government para serviços comuns do Azure.

Habilitar a autenticação do Microsoft Entra para ingestão de perfil

O Application Insights Profiler para .NET suporta a autenticação Microsoft Entra para ingestão de perfis. Para que todos os perfis do seu aplicativo sejam ingeridos, seu aplicativo deve ser autenticado e fornecer as configurações necessárias do aplicativo para o agente do Profiler.

O Profiler apenas oferece suporte à autenticação do Microsoft Entra quando se referencia e configura o ID do Microsoft Entra utilizando o SDK do Application Insights na sua aplicação.

Para habilitar o Microsoft Entra ID para ingestão de perfil:

  1. Crie e adicione a identidade gerenciada para autenticar o recurso do seu Application Insights ao App Service.

  2. Configure e habilite o ID do Microsoft Entra em seu recurso do Application Insights.

  3. Adicione a seguinte configuração de aplicativo para permitir que o agente do Profiler saiba qual identidade gerenciada usar.

    • Para a identidade atribuída ao sistema:

      Definição da aplicação Valor
      APPLICATIONINSIGHTS_AUTHENTICATION_STRING Authorization=AAD

    • Para identidade atribuída pelo usuário:

      Definição da aplicação Valor
      APPLICATIONINSIGHTS_AUTHENTICATION_STRING Authorization=AAD;ClientId={Client id of the User-Assigned Identity}

Desabilite o .NET Profiler

Para parar ou reiniciar o Profiler para uma instância de aplicativo individual:

  1. Em Definições, no menu esquerdo, selecione WebJobs.

    Captura de ecrã que mostra a seleção de trabalhos web no menu esquerdo.

  2. Selecione o webjob chamado ApplicationInsightsProfiler3.

  3. Selecione o ícone Parar .

    Captura de ecrã que mostra a opção para parar o webjob.

  4. Selecione Parar para confirmar.

Recomendamos que você tenha o Profiler ativado em todos os seus aplicativos para descobrir quaisquer problemas de desempenho o mais cedo possível.

Você pode excluir os arquivos do Profiler ao usar o WebDeploy para implantar alterações em seu aplicativo Web. Você pode impedir a exclusão excluindo a pasta App_Data de ser excluída durante a implantação.

Conteúdo relacionado

  • Saiba como gerar carga e visualizar os rastreamentos do .NET Profiler
  • Saiba como usar as Otimizações de código juntamente com o Perfilador do Application Insights para .NET
  • Last updated on