Partilhar via

Habilitar o Profiler para os aplicativos do Serviço de Aplicativo do Azure

  • Artigo

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

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

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

Pré-requisitos

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

  1. No portal do Azure, acesse a instância do Serviço de Aplicativo.

  2. Em Configurações no painel esquerdo, selecione Configuração.

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

  3. Selecione a guia Configurações Gerais.

  4. Verifique se Sempre ativado>Ativo está selecionado.

    Captura de tela que mostra a guia Geral no painel Configuração mostrando a configuração Sempre ativado habilitada.

  5. Selecione Salvar se você fez alterações.

Habilite o Application Insights e o Profiler

Você pode habilitar o Profiler quando:

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

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

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

    Captura de tela que mostra a seleção do Application Insights no painel esquerdo.

  2. Em Application Insights, selecione Habilitar.

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

    Captura de tela que mostra como habilitar o Application Insights no seu aplicativo.

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

  5. Verifique se o Nível de coleção>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 tela que mostra como habilitar o Profiler no seu aplicativo.

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

Se o recurso do Application Insights estiver em uma assinatura diferente da sua instância do Serviço de Aplicativo, você precisará habilitar o Profiler 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 habilitar o Profiler.

Configurações de aplicativo Valor
APPINSIGHTS_INSTRUMENTATIONKEY iKey para seu recurso do Application Insights
APPINSIGHTS_PROFILERFEATURE_VERSION 1.0.0
DiagnosticServices_EXTENSION_VERSION ~3

Defina esses valores usando:

Habilitar o Profiler em nuvens regionais

Atualmente, as únicas regiões que exigem modificações do ponto de extremidade são o Azure Governamental e o Microsoft Azure operado pela 21Vianet.

Configurações de aplicativo Nuvem do governo dos EUA Nuvem da China
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 dá suporte à autenticação do Microsoft Entra para ingestão de perfil. Para que todos os perfis do seu aplicativo sejam ingeridos, seu aplicativo precisa estar autenticado e fornecer as configurações de aplicativo necessárias para o agente do Profiler.

O Criador de Perfil só dá suporte à autenticação do Microsoft Entra ao fazer referência e configurar o Microsoft Entra ID usando o SDK do Application Insights no aplicativo.

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

  1. Crie e adicione a identidade gerenciada para se autenticar em seu recurso do Application Insights para o 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 Microsoft Entra ID no 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 identidade atribuída pelo sistema:

      Configurações de aplicativo Valor
      APPLICATIONINSIGHTS_AUTHENTICATION_STRING Authorization=AAD

    • Para identidade atribuída pelo usuário:

      Configurações de aplicativo Valor
      APPLICATIONINSIGHTS_AUTHENTICATION_STRING Authorization=AAD;ClientId={Client id of the User-Assigned Identity}

Desabilitar o Profiler

Para interromper ou reiniciar o Profiler de uma instância individual do aplicativo:

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

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

  2. Selecione o webJob com nome ApplicationInsightsProfiler3.

  3. Selecione Interromper.

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

  4. Clique em Sim para confirmar.

Recomendamos que você tenha o Profiler habilitado em todos os seus aplicativos para descobrir problemas de desempenho o mais rápido 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 removendo a pasta App_Data da exclusão durante a implantação.

Próximas etapas