Habilitar o Profiler para aplicativos Web ASP.NET Core hospedados no Linux

Usando o Profiler, você pode acompanhar quanto tempo é gasto em cada método de seus aplicativos Web ASP.NET Core ao vivo hospedados no Linux no Serviço de Aplicativo do Azure. Este artigo se concentra em aplicativos Web hospedados no Linux. Você também pode experimentar usando ambientes de desenvolvimento Linux, Windows e Mac.

Neste artigo você:

• Configurar e implantar um aplicativo Web ASP.NET Core hospedado no Linux.
• Adicionar o Application Insights Profiler ao aplicativo Web ASP.NET Core.

Pré-requisitos

• Instalar o SDK do .NET mais recente
• Instale o Git seguindo as instruções em Introdução: Instalação do Git.
• Examine os exemplos a seguir para entender o contexto:
  • Habilitar o Service Profiler para o Aplicativo Principal do ASP.NET em contêiner (.NET 6)
  • Exemplo do Application Insights Profiler para o Serviço do Trabalhador

Configurar o projeto localmente

1. Abra uma janela do prompt de comando no seu computador.

2. Crie um aplicativo Web MVC ASP.NET Core:

   dotnet new mvc -n LinuxProfilerTest
   

3. Altere o diretório de trabalho para a pasta raiz do projeto.

4. Adicione o pacote do NuGet para coletar os rastreamentos do Profiler:

   dotnet add package Microsoft.ApplicationInsights.Profiler.AspNetCore
   

5. Em seu editor de código preferido, habilite o Application Insights e o Profiler em Program.cs. Adicionar configurações personalizadas do Profiler, se aplicável.

   Para WebAPI:

   // Add services to the container.
   builder.Services.AddApplicationInsightsTelemetry();
   builder.Services.AddServiceProfiler();
   

   Para Worker:

   IHost host = Host.CreateDefaultBuilder(args)
       .ConfigureServices(services =>
       {
           services.AddApplicationInsightsTelemetryWorkerService();
           services.AddServiceProfiler();
   
           // Assuming Worker is your background service class.
           services.AddHostedService<Worker>();
       })
       .Build();
   
   await host.RunAsync();
   

6. Salve e confirme suas alterações no repositório local:

   git init
   git add .
   git commit -m "first commit"
   

Criar o aplicativo web para Linux para hospedar seu projeto

1. No portal do Azure, crie um ambiente de aplicativo Web usando o Serviço de Aplicativo no Linux:

   

2. Acesse seu novo recurso de aplicativo Web e selecione Centro de Implantação>Credenciais FTPS para criar as credenciais de implantação. Anote suas credenciais para usar mais tarde.

   

3. Selecione Salvar.

4. Selecione a guia Settings (Configurações).

5. Na lista suspensa, selecione Git local para configurar um repositório Git local no aplicativo Web.

   

6. Clique em Salvar para criar um repositório Git com um URI do Git Clone.

   

   Para obter mais opções de implantação, confira a documentação do Serviço de Aplicativo.

Implantar o projeto

1. Na janela do prompt de comando, navegue até a pasta raiz de seu projeto. Adicione um repositório remoto de Git para apontar para o repositório no Serviços de Aplicativos:

   git remote add azure https://<username>@<app_name>.scm.azurewebsites.net:443/<app_name>.git
   

   • Use o username que você usou para criar as credenciais de implantação.
   • Use o nome do aplicativo que você usou para criar o aplicativo web por meio do Serviço de Aplicativo no Linux.

2. Implante o projeto efetuando push nas alterações para o Azure:

   git push azure main
   

   Você deverá ver uma saída semelhante ao seguinte exemplo:

   Counting objects: 9, done.
   Delta compression using up to 8 threads.
   Compressing objects: 100% (8/8), done.
   Writing objects: 100% (9/9), 1.78 KiB | 911.00 KiB/s, done.
   Total 9 (delta 3), reused 0 (delta 0)
   remote: Updating branch 'main'.
   remote: Updating submodules.
   remote: Preparing deployment for commit id 'd7369a99d7'.
   remote: Generating deployment script.
   remote: Running deployment command...
   remote: Handling ASP.NET Core Web Application deployment.
   remote: ......
   remote:   Restoring packages for /home/site/repository/EventPipeExampleLinux.csproj...
   remote: .
   remote:   Installing Newtonsoft.Json 10.0.3.
   remote:   Installing Microsoft.ApplicationInsights.Profiler.Core 1.1.0-LKG
   ...
   

Adicionar o Application Insights para monitorar seu aplicativo web

Você tem três opções para adicionar o Application Insights ao seu aplicativo Web:

• Por meio do painel Application Insights no portal do Azure.
• Por meio do painel Configuração no portal do Azure.
• Adicionando manualmente às configurações do aplicativo Web.

Painel do Application Insights

1. Em seu aplicativo Web no portal do Azure, selecione Application Insights no painel esquerdo.

2. Selecione Ativar o Application Insights.

   

3. Em Application Insights, selecione Habilitar.

   

4. Em Link para um recurso do Application Insights, crie um novo recurso ou selecione um recurso existente. Para este exemplo, vamos criar um novo recurso.

   

5. Clique em Aplicar>Sim para aplicar e confirmar.

painel “Configuração”

1. Crie um recurso do Application Insights na mesma assinatura do Azure da sua instância do Serviço de Aplicativo.

2. Acesse o recurso do Application Insights.

3. Copie a Chave de instrumentação (iKey).

4. Em seu aplicativo Web no portal do Azure, selecione Configuração no painel esquerdo.

5. Selecione Nova configuração de aplicativo.

   

6. Adicione as seguintes configurações no painel Adicionar/Editar configuração de aplicativo, usando sua iKey salva:

   Nome	Valor
   APPINSIGHTS_INSTRUMENTATIONKEY	[YOUR_APPINSIGHTS_KEY]

   

7. Selecione OK.

   

8. Selecione Salvar.

Configurações do aplicativo Web

1. Crie um recurso do Application Insights na mesma assinatura do Azure da sua instância do Serviço de Aplicativo.

2. Acesse o recurso do Application Insights.

3. Copie a Chave de instrumentação (iKey).

4. No seu editor de código preferido, navegue até o arquivo appsettings.json do projeto do ASP.NET Core.

5. Adicione o seguinte código e insira a iKey copiada:

   "ApplicationInsights":
   {
     "InstrumentationKey": "<your-instrumentation-key>"
   }
   

6. Salve appsettings.json para aplicar a alteração de configurações.

Próximas etapas

Gerar carga e exibir rastreamentos do Profiler