Partilhar via

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

  • Artigo

O Application Insights Profiler para .NET é pré-instalado como parte do tempo de execução 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.

Instalação sem código do Application Insights Profiler para .NET:

  • Segue a política de suporte do .NET Core.
  • Só é suportado em aplicações Web baseadas no Windows.

Para habilitar o .NET Profiler no Linux, percorra as instruções dos aplicativos Web Linux do ASP.NET Core Azure.

Pré-requisitos

  • Um aplicativo ASP.NET/ASP.NET Core do Serviço de Aplicativo do Azure.
  • Um recurso do Application Insights conectado ao seu aplicativo do Serviço de Aplicativo.

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

  1. No portal do Azure, vá para sua instância do Serviço de Aplicativo.

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

    Captura de tela que mostra a seleção de Configuração no painel esquerdo.

  3. Selecione a guia Configurações gerais .

  4. Verifique se a opção Sempre ativado> está selecionada.

    Nota

    Se a alternância Sempre ativado estiver desabilitada, atualize seu aplicativo Web do Serviço de Aplicativo para ser executado na camada Básica 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.

Habilite o Application Insights e o .NET Profiler

Você pode ativar o Profiler quando:

Para o Application Insights e o Serviço de Aplicativo na mesma assinatura

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

  1. No menu à esquerda, selecione Monitoring>Application Insights.

  2. Em Application Insights, selecione Ativar.

  3. 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.

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

  5. Verifique se o nível>de coleta Recomendado está selecionado.

  6. Em Profiler, selecione Ativado.

    Se você escolheu o nível de coleção Básico anteriormente, a configuração do Profiler será desabilitada.

  7. Selecione Aplicar Sim> para confirmar.

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

Para o Application Insights e o Serviço de Aplicativo em assinaturas diferentes

Se o recurso do Application Insights estiver em uma assinatura diferente da instância do Serviço de Aplicativo, você precisará habilitar o Profiler para .NET manualmente criando configurações de aplicativo para sua instância do Serviço de Aplicativo. 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 Value
APPINSIGHTS_INSTRUMENTATIONKEY iKey para o seu recurso do 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 ponto de extremidade são o Azure Government e o Microsoft Azure operados pela 21Vianet.

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

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 só oferece suporte à autenticação do Microsoft Entra quando você faz referência e configura a ID do Microsoft Entra usando o SDK do Application Insights em seu aplicativo.

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

  1. Crie e adicione a identidade gerenciada para autenticação no recurso do Application Insights ao Serviço de Aplicativo:

    1. Documentação de identidade gerenciada atribuída pelo sistema

    2. Documentação de identidade gerenciada atribuída pelo usuário

  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 Value
      APPLICATIONINSIGHTS_AUTHENTICATION_STRING Authorization=AAD

    • Para identidade atribuída pelo usuário:

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

Desative o .NET Profiler

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

  1. Em Configurações no painel esquerdo, selecione WebJobs.

    Captura de tela que mostra a seleção de trabalhos da Web no painel esquerdo.

  2. Selecione o webjob chamado ApplicationInsightsProfiler3.

  3. Selecione Parar.

    Captura de tela que mostra a seleção de parar para parar o webjob.

  4. Selecione Sim 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.

Próximos passos