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.

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, siga as instruções para aplicações web do ASP.NET Core no Azure 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 do Azure, vá para sua instância do Serviço de Aplicativo.

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

   

3. Selecione a aba Configurações gerais.

4. Verifique se Sempre ligado>Ligado está selecionado.

   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.

Ativar 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 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 à esquerda, selecione Monitoring>Application Insights.

2. Clique no botão Ativar o Application Insights .

   

3. Na página de configuração do Application Insights, em Application Insights, verifique se a opção Habilitar está selecionada.

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

   

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

6. Verifique se o Nível de coleção>Recomendado está selecionado.

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.

   

8. Selecione Aplicar>Sim para confirmar.

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

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 endereços finais são o Azure Government e o Microsoft Azure operado pela 21Vianet.

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.

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