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

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.

   

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.

   

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

Habilite o Application Insights e o .NET Profiler

Você pode ativar o Profiler quando:

• Seu recurso do Application Insights e o recurso do Serviço de Aplicativo estão na mesma assinatura ou
• Seu recurso do Application Insights e o recurso do Serviço de Aplicativo estão em assinaturas separadas.

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.

   

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.

   

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.

Defina estes valores usando:

• Modelos do Azure Resource Manager
• Azure PowerShell
• CLI do Azure

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.

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.

   

2. Selecione o webjob chamado ApplicationInsightsProfiler3.

3. Selecione Parar.

   

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

• Saiba como gerar, carregar e exibir os rastreamentos do .NET Profiler
• Saiba como usar o recurso Otimizações de código junto com o Application Insights Profiler para .NET