Ativar o Profiler para ASP.NET Core aplicações Web alojadas no Linux

Ao utilizar o Profiler, pode controlar quanto tempo é gasto em cada método das suas aplicações Web ASP.NET Core em direto alojadas no Linux no Serviço de Aplicações do Azure. Este artigo centra-se nas aplicações Web alojadas no Linux. Também pode experimentar com ambientes de desenvolvimento linux, Windows e Mac.

Neste artigo, irá:

• Configure e implemente uma aplicação Web ASP.NET Core alojada no Linux.
• Adicione o Application Insights Profiler à aplicação Web ASP.NET Core.

Pré-requisitos

• Instale o SDK .NET Core mais recente.
• Instale o Git ao seguir as instruções em Introdução: Instalar o Git.
• Reveja os seguintes exemplos para obter contexto:
  • Ativar o Service Profiler para a Aplicação ASP.NET Core em contentores (.NET 6)
  • Exemplo do Application Insights Profiler for Worker Service

Configurar o projeto localmente

1. Abra uma janela da linha de comandos no seu computador.

2. Criar uma aplicação Web ASP.NET Core MVC:

   dotnet new mvc -n LinuxProfilerTest
   

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

4. Adicione o pacote NuGet para recolher os rastreios do Profiler:

   dotnet add package Microsoft.ApplicationInsights.Profiler.AspNetCore
   

5. No seu editor de código preferencial, ative o Application Insights e o Profiler no Program.cs. Adicione definiçõ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. Guarde e consolide as alterações ao repositório local:

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

Criar a aplicação Web do Linux para alojar o seu projeto

1. No portal do Azure, crie um ambiente de aplicação Web com Serviço de Aplicações no Linux.

   

2. Aceda ao novo recurso da aplicação Web e selecioneCredenciais FTPSdo Centro> de Implementação para criar as credenciais de implementação. Anote as suas credenciais para utilizar mais tarde.

   

3. Selecione Guardar.

4. Selecione o separador Settings (Definições).

5. Na lista pendente, selecione Git Local para configurar um repositório Git local na aplicação Web.

   

6. Selecione Guardar para criar um repositório Git com um URI de clone do Git.

   

   Para obter mais opções de implementação, veja a documentação do Serviço de Aplicações.

Implementar o projeto

1. Na janela da linha de comandos, navegue para a pasta raiz do projeto. Adicione um repositório remoto do Git para apontar para o repositório no Serviço de Aplicações:

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

   • Utilize o nome de utilizador que utilizou para criar as credenciais de implementação.
   • Utilize o nome da aplicação que utilizou para criar a aplicação Web com Serviço de Aplicações no Linux.

2. Implemente o projeto ao emitir as alterações para o Azure:

   git push azure main
   

   Deverá ver um resultado 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 monitorizar a sua aplicação Web

Tem três opções para adicionar o Application Insights à sua aplicação Web:

• Ao utilizar o painel Application Insights no portal do Azure.
• Ao utilizar o painel Configuração no portal do Azure.
• Ao adicionar manualmente às definições da sua aplicação Web.

Painel Do Application Insights

1. Na sua aplicação Web no portal do Azure, selecione Application Insights no painel esquerdo.

2. Selecione Ativar Application Insights.

   

3. Em Application Insights, selecione Ativar.

   

4. Em Ligar a um recurso do Application Insights, crie um novo recurso ou selecione um recurso existente. Neste exemplo, criamos um novo recurso.

   

5. Selecione Aplicar>Sim para aplicar e confirmar.

Painel configuração

1. Crie um recurso do Application Insights na mesma subscrição do Azure que a sua instância de Serviço de Aplicações.

2. Aceda ao recurso do Application Insights.

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

4. Na sua aplicação Web no portal do Azure, selecione Configuração no painel esquerdo.

5. Selecione Nova definição da aplicação.

   

6. Adicione as seguintes definições no painel de definições Adicionar/Editar aplicação com a iKey guardada:

   Name	Valor
   APPINSIGHTS_INSTRUMENTATIONKEY	[YOUR_APPINSIGHTS_KEY]

   

7. Selecione OK.

   

8. Selecione Guardar.

Definições da aplicação Web

1. Crie um recurso do Application Insights na mesma subscrição do Azure que a sua instância de Serviço de Aplicações.

2. Aceda ao recurso do Application Insights.

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

4. No seu editor de código preferencial, aceda ao ficheiro do appsettings.json projeto ASP.NET Core.

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

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

6. Guarde appsettings.json para aplicar a alteração de definições.

Passos seguintes

Gerar rastreios de carga e ver o Profiler