Aktivera Profiler för ASP.NET Core webbappar som finns i Linux

Med Profiler kan du spåra hur mycket tid som spenderas i varje metod i din live-ASP.NET Core webbappar som finns i Linux på Azure App Service. Den här artikeln fokuserar på webbappar som finns i Linux. Du kan också experimentera med linux-, Windows- och Mac-utvecklingsmiljöer.

Den här artikeln innehåller följande avsnitt:

• Konfigurera och distribuera en ASP.NET Core webbapp som finns i Linux.
• Lägg till Application Insights Profiler i ASP.NET Core-webbappen.

Förutsättningar

• Installera den senaste .NET Core SDK:en.
• Installera Git genom att följa anvisningarna i Komma igång: Installera Git.
• Granska följande exempel för kontext:
  • Aktivera Service Profiler för containerbaserade ASP.NET Core-program (.NET 6)
  • Application Insights Profiler för Worker Service-exempel

Konfigurera projektet lokalt

1. Öppna ett kommandotolksfönster på datorn.

2. Skapa en ASP.NET Core MVC-webbapp:

   dotnet new mvc -n LinuxProfilerTest
   

3. Ändra arbetskatalogen till rotmappen för projektet.

4. Lägg till NuGet-paketet för att samla in Profiler-spårningarna:

   dotnet add package Microsoft.ApplicationInsights.Profiler.AspNetCore
   

5. Aktivera Application Insights och Profiler i i önskad kodredigerare i Program.cs. Lägg till anpassade Profiler-inställningar, om tillämpligt.

   För WebAPI gäller följande:

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

   För Worker gäller följande:

   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. Spara och checka in ändringarna på den lokala lagringsplatsen:

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

Skapa Linux-webbappen som värd för projektet

1. I Azure Portal skapar du en webbappmiljö med hjälp av App Service på Linux.

   

2. Gå till din nya webbappresurs och väljFTPS-autentiseringsuppgifter för Distributionscenter> för att skapa autentiseringsuppgifterna för distributionen. Anteckna dina autentiseringsuppgifter för senare användning.

   

3. Välj Spara.

4. Välj fliken Inställningar.

5. I listrutan väljer du Lokal Git för att konfigurera en lokal Git-lagringsplats i webbappen.

   

6. Välj Spara för att skapa en Git-lagringsplats med en Git-klon-URI.

   

   Fler distributionsalternativ finns i App Service dokumentationen.

Distribuera projektet

1. I kommandotolken bläddrar du till rotmappen för projektet. Lägg till en Git-fjärrlagringsplats för att peka på lagringsplatsen på App Service:

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

   • Använd det användarnamn som du använde för att skapa autentiseringsuppgifterna för distributionen.
   • Använd det appnamn som du använde för att skapa webbappen med hjälp av App Service på Linux.

2. Distribuera projektet genom att skicka ändringarna till Azure:

   git push azure main
   

   Du bör se utdata som liknar följande exempel:

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

Lägga till Application Insights för att övervaka din webbapp

Du har tre alternativ för att lägga till Application Insights i din webbapp:

• Genom att använda Application Insights-fönstret i Azure Portal.
• Genom att använda fönstret Konfiguration i Azure Portal.
• Genom att lägga till i inställningarna för webbappen manuellt.

Application Insights-fönstret

1. I din webbapp i Azure Portal väljer du Application Insights i det vänstra fönstret.

2. Välj Aktivera Application Insights.

   

3. Under Application Insights väljer du Aktivera.

   

4. Under Länka till en Application Insights-resurs skapar du antingen en ny resurs eller väljer en befintlig resurs. I det här exemplet skapar vi en ny resurs.

   

5. Välj Använd>Ja för att tillämpa och bekräfta.

Konfigurationsfönster

1. Skapa en Application Insights-resurs i samma Azure-prenumeration som din App Service-instans.

2. Gå till Application Insights-resursen.

3. Kopiera instrumenteringsnyckeln (iKey).

4. I webbappen i Azure Portal väljer du Konfiguration i det vänstra fönstret.

5. Välj Ny programinställning.

   

6. Lägg till följande inställningar i fönstret Lägg till/redigera programinställning med hjälp av din sparade iKey:

   Name	Värde
   APPINSIGHTS_INSTRUMENTATIONKEY	[YOUR_APPINSIGHTS_KEY]

   

7. Välj OK.

   

8. Välj Spara.

Inställningar för webbappen

1. Skapa en Application Insights-resurs i samma Azure-prenumeration som din App Service-instans.

2. Gå till Application Insights-resursen.

3. Kopiera instrumenteringsnyckeln (iKey).

4. I önskad kodredigerare går du till filen för ditt ASP.NET Core projektappsettings.json.

5. Lägg till följande kod och infoga din kopierade iKey:

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

6. Spara appsettings.json för att tillämpa inställningarna.

Nästa steg

Generera belastnings- och visningsspårningar för Profiler