Povolení Azure Monitor OpenTelemetry Profiler Preview pro .NET v Linuxu

Important

Azure Monitor OpenTelemetry Profiler pro .NET je aktuálně ve verzi Preview. Podívejte se na doplňkové podmínky užívání služby Microsoft Azure Preview pro právní podmínky, které se vztahují na funkce Azure, jež jsou ve verzi beta, Preview nebo jinak ještě nejsou obecně dostupné.

Azure Monitor OpenTelemetry Profiler Preview pro .NET sleduje, kolik času každá metoda v živých ASP.NET Core webových aplikací stráví spuštěním, abyste mohli určit cesty kódu, které zpomalují výkon.

Tento článek ukazuje, jak povolit Azure Monitor OpenTelemetry Profiler Preview pro .NET ve webové aplikaci ASP.NET Core hostované v Linuxu na Azure App Service. Ukázkový projekt můžete nastavit také ve vývojových prostředích pro Windows a macOS.

V tomto článku:

• Nastavte ASP.NET Core webovou aplikaci hostované v Linuxu na místním počítači.
• Vytvořte službu App Service pomocí portálu Azure.
• Nasaďte místní projekt ASP.NET Core do Azure pomocí místního Gitu.
• Přidejte profiler .NET do webové aplikace ASP.NET Core.

Poznámka:

Projděte si doprovodné materiály k sadě Application Insights SDK pro zásady podpory sady SDK. Pokyny k migraci najdete v tématu Migrace ze sad Application Insights SDK do Azure Monitor OpenTelemetry.

Upozornění

Pro nové aplikace použijte Microsoft OpenTelemetry Distro. Poskytuje podobné prostředí a srovnatelné funkce pro sadu Application Insights SDK. Pokud chcete migrovat na nabídku založenou na OpenTelemetry, projděte si pokyny k migraci.

Požadavky

OpenTelemetry Profiler

• Nainstalujte nejnovější sadu .NET Core SDK.
• Nainstalujte Git podle pokynů v části Začínáme: Instalace Gitu.
• Projděte si ukázku povolení Azure Monitor Profileru pro ASP.NET Core Web API pro kontext.

Application Insights SDK (starší verze)

• Nainstalujte nejnovější sadu .NET Core SDK.
• Nainstalujte Git podle pokynů v části Začínáme: Instalace Gitu.
• Kontext najdete v následujících ukázkách:
  • Povolení profileru služby pro kontejnerizovanou aplikaci ASP.NET Core (.NET 6)
  • Příklad profileru Application Insights pro pracovní službu

Místní nastavení projektu

Vytvořte ukázkovou ASP.NET Core webovou aplikaci na místním počítači a přidejte balíčky NuGet, které shromažďují trasování profileru.

1. Na počítači otevřete okno příkazového řádku.

2. Vytvořte webovou aplikaci ASP.NET Core MVC.

   dotnet new mvc -n LinuxProfilerTest
   

3. Změňte pracovní adresář na kořenovou složku projektu.

4. Přidejte balíčky NuGet pro shromažďování tras profileru.

   OpenTelemetry Profiler

   dotnet add package Azure.Monitor.OpenTelemetry.AspNetCore --prerelease
   dotnet add package Azure.Monitor.OpenTelemetry.Profiler --prerelease
   

   Application Insights SDK (starší verze)

   dotnet add package Microsoft.ApplicationInsights.Profiler.AspNetCore
   

Povolení profileru .NET

Nakonfigurujte aplikaci pro shromažďování trasování nástroje Profiler. Vyberte kartu odpovídající nabídce, kterou používáte.

OpenTelemetry Profiler

1. V preferovaném editoru kódu ověřte, že jste do .NET Program.cspřidali dva balíčky pro profiler OpenTelemetry Azure Monitoru. Pokud je to možné, přidejte vlastní nastavení profileru.

   V souboru projektu .csproj ověřte, že jste přidali následující řádky:

   <ItemGroup>
       <PackageReference Include="Azure.Monitor.OpenTelemetry.AspNetCore" Version="[1.*-*, 2.0.0)" />
       <PackageReference Include="Azure.Monitor.OpenTelemetry.Profiler" Version="[1.*-*, 2.0.0)" />
   </ItemGroup>
   

   Program.cs V souboru ověřte, že jste přidali následující řádky:

   using Azure.Monitor.OpenTelemetry.AspNetCore;
   using Azure.Monitor.OpenTelemetry.Profiler;
   
   ///
   
   builder.Services.AddOpenTelemetry()
       .UseAzureMonitor()          // Enable Azure Monitor export for ASP.NET Core
       .AddAzureMonitorProfiler(); // Add Azure Monitor Profiler
   

2. Uložte a potvrďte změny do místního úložiště:

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

Application Insights SDK (starší verze)

1. V preferovaném editoru kódu ověřte, že jste přidali Application Insights a profiler .NET pomocí sady SDK v Program.cs. Pokud je to možné, přidejte vlastní nastavení profileru.

   Pro WebAPI

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

   Pro pracovníka

   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();
   

2. Uložte a potvrďte změny do místního úložiště:

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

Vytvoření webové aplikace pro Linux pro hostování projektu

Vytvořte webovou aplikaci App Service v Linuxu pro hostování projektu a nastavte místní přihlašovací údaje pro nasazení Gitu.

1. Na webu Azure Portal vyhledejte a vyberte App Services a pak vyberte Vytvořit>webovou aplikaci.

2. Vytvořte prostředí webové aplikace pomocí služby App Service v Linuxu.

   

3. Přejděte na nový prostředek webové aplikace. V nabídce vlevo vyberte Deployment>Deployment Center a pak výběrem přihlašovacích údajů FTPS vytvořte přihlašovací údaje nasazení. Poznamenejte si přihlašovací údaje k pozdějšímu použití.

   

4. Zvolte Uložit.

5. Vyberte kartu Nastavení.

6. Pokud chcete ve webové aplikaci nastavit místní úložiště Git, vyberte Source (Zdroj) a pak vyberte Local Git (Místní Git).

   

7. Výběrem možnosti Uložit vytvořte úložiště Git pomocí identifikátoru URI klonu Gitu.

   

   Další možnosti nasazení najdete v dokumentaci ke službě App Service.

Nasazení projektu do Azure App Service

Kód můžete do služby Azure App Service nasadit různými způsoby. Nejjednodušším způsobem je nasazení pomocí místního Gitu. Další informace najdete v tématu Nasazení do služby Azure App Service pomocí místního Gitu.

1. V okně příkazového řádku přejděte do kořenové složky projektu. Přidejte vzdálené úložiště Git, které bude odkazovat na úložiště ve službě App Service:

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

   Pro tuto hodnotu přejděte na stránku Přehled vaší webové aplikace. Zkopírujte adresu URL klonu Gitu.

2. Nasaďte projekt nasdílením změn do Azure App Service:

   git push azure main
   

Přidání Application Insights pro monitorování webové aplikace

Pokud chcete zobrazit trasování profileru, připojte webovou aplikaci k prostředku Application Insights. Pokud povolíte Application Insights při vytváření služby App Service, Azure nastaví připojovací řetězec automaticky. V opačném případě použijte jednu z následujících metod k nastavení připojovací řetězec. Vyberte kartu odpovídající nabídce, kterou používáte.

OpenTelemetry Profiler

Zkopírujte a vložte připojovací řetězec z prostředku Application Insights, abyste mohli monitorovat webovou aplikaci.

1. Zkopírujte připojovací řetězec.
2. Vložte připojovací řetězec do svého prostředí.

Application Insights SDK (starší verze)

Máte tři možnosti přidání Application Insights do webové aplikace. Rozbalte možnost, kterou chcete použít.

Podokno Application Insights

1. Otevřete webovou aplikaci na webu Azure Portal. V nabídce vlevo vyberte Monitorování>Application Insights.

2. Vyberte Zapnout Application Insights.

   

3. V části Application Insights vyberte Povolit.

   

4. V části Propojení s prostředkem Application Insights vytvořte nový prostředek nebo vyberte existující prostředek. V tomto příkladu vytvořte nový prostředek.

   

5. Vyberte Použít a poté Ano pro aplikaci a potvrzení.

Podokno proměnných prostředí

1. Vytvořte prostředek Application Insights ve stejném předplatném Azure jako instance služby App Service.

2. Přejděte k prostředku Application Insights.

3. Zkopírujte připojovací řetězec.

4. Otevřete webovou aplikaci na webu Azure Portal.

5. V nabídce vlevo vyberteProměnné prostředí>. Pak vyberte Přidat.

   

6. Přidejte připojovací řetězec jako nové nastavení v podokně pro nastavení aplikace Přidat/upravit:

   Jméno	Hodnota
   Řetězec připojení pro Application Insights	[YOUR_CONNECTION_STRING]

   

7. Vyberte OK.

   

8. Zvolte Uložit.

Nastavení webové aplikace (appsettings.json)

1. Vytvořte prostředek Application Insights ve stejném předplatném Azure jako instance služby App Service.

2. Přejděte k prostředku Application Insights.

3. Zkopírujte připojovací řetězec.

4. V preferovaném editoru kódu přejděte do souboru projektu appsettings.json ASP.NET Core.

5. Přidejte následující kód a vložte připojovací řetězec:

   "ApplicationInsights":
   {
     "ConnectionString": "<your-connection-string>"
   }
   

6. Uložte appsettings.json , aby se změna nastavení použila.

Řešení problémů při chybějících trasách Profileru

Pokud se ve vašem prostředku Application Insights nezobrazují trasy nástroje Profiler, použijte průvodce odstraňováním potíží pro vaši variantu. Vyberte kartu odpovídající nabídce, kterou používáte.

OpenTelemetry Profiler

Pokud nemůžete najít stopy z vaší aplikace, vyzkoušejte postup v tomto průvodci odstraňováním potíží.

Application Insights SDK (starší verze)

Pokud nemůžete najít stopy z vaší aplikace, vyzkoušejte postup v tomto průvodci odstraňováním potíží.

Další krok

Generování zátěže a zobrazení trasování pomocí profilovacího nástroje .NET