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

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. Siga essas etapas mesmo se você tiver incluído o SDK do Application Insights no seu aplicativo no momento da compilação.

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

Observação

A instalação sem código do Application Insights Profiler segue a política de suporte do .NET Core. Para mais informações sobre runtimes com suporte, confira a Política de suporte do .NET Core.

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.

    Screenshot that shows selecting Configuration on the left pane.

  3. Selecione a guia Configurações Gerais.

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

    Screenshot that shows the General tab on the Configuration pane showing that Always On is enabled.

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

Habilite o Application Insights e o Profiler

As seções a seguir mostram como habilitar o Application Insights para a mesma assinatura ou assinaturas diferentes.

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.

    Screenshot that shows selecting Application Insights on the left pane.

  2. Em Application Insights, selecione Habilitar.

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

    Screenshot that shows enabling Application Insights on your app.

  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.

    Screenshot that shows enabling Profiler on your app.

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.

    Screenshot that shows selecting web jobs on the left pane.

  2. Selecione o webJob com nome ApplicationInsightsProfiler3.

  3. Selecione Interromper.

    Screenshot that shows selecting stop for stopping the 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