Povolení profileru .NET pro aplikace Azure App Service ve Windows

Application Insights Profiler pro .NET zaznamenává trasování živé aplikace a ukazuje, které požadavky jsou pomalé a které řádky kódu způsobují zpomalení. Pokud vaše aplikace běží pomaleji, než se čekalo v produkčním prostředí, profiler vám pomůže najít kritické body místo odhadování.

Profiler je předinstalovaný jako součást modulu Azure App Service runtime. V tomto článku se dozvíte, jak ji povolit pro ASP.NET a ASP.NET Core aplikace, které běží ve službě App Service pomocí úrovně služby Basic nebo vyšší.

Bez kódu instalace profileru Application Insights pro .NET se řídí zásadami podpory .NET Core. Azure ho podporuje jenom ve webových aplikacích založených na Windows . Pokud chcete povolit .NET Profiler v Linuxu, přečtěte si téma Povolení profileru .NET pro aplikace Azure App Service v Linuxu.

Požadavky

  • Aplikace Azure App Service ASP.NET/ASP.NET Core.
  • Prostředek Application Insights připojený k aplikaci App Service.

Ověřte, že je povolené nastavení AlwaysOn.

Profiler běží jako souvislá webová úloha, takže vaše aplikace musí běžet i v době nečinnosti. Před povolením profileru ověřte, že je povolené nastavení AlwaysOn .

  1. Na webu Azure Portal přejděte do instance služby App Service.

  2. V nabídce vlevo vyberte Nastavení>konfigurace.

    Snímek obrazovky znázorňující výběr možnosti Konfigurace v nabídce vlevo

  3. Vyberte Obecné nastavení.

  4. Ověřte, že je funkce AlwaysOn nastavená na Zapnuto.

    Poznámka:

    Pokud je funkce AlwaysOn zakázaná, upgradujte webovou aplikaci služby App Service tak, aby běžela na úrovni Basic nebo vyšší.

    Snímek obrazovky znázorňující kartu Obecné v podokně Konfigurace znázorňující, že je zapnutá funkce AlwaysOn

  5. Pokud jste provedli změny, vyberte Uložit .

Povolení Application Insights a profileru .NET

Povolte Profiler v některém z těchto scénářů:

Pro Application Insights a App Service ve stejném předplatném

Pokud je váš prostředek Application Insights ve stejném předplatném jako vaše instance služby App Service:

  1. V levé nabídce instance služby App Service vyberte Monitorování>Application Insights.

  2. Vyberte Aktivovat Application Insights.

    Snímek obrazovky znázorňující zapnutí Application Insights pro vaši aplikaci

  3. Na stránce nastavení Application Insights v části Application Insights vyberte Povolit.

  4. Ověřte, že jste k aplikaci připojili prostředek Application Insights.

    Snímek obrazovky znázorňující povolení Application Insights ve vaší aplikaci

  5. Posuňte se dolů a v závislosti na vaší aplikaci vyberte kartu .NET nebo .NET Core.

  6. U úrovně kolekce vyberte Doporučené.

  7. V části Profiler a Optimalizace kódu vyberte Zapnuto. Pokud jste dříve zvolili Základní úroveň kolekce, je nastavení Profiler deaktivováno.

    Snímek obrazovky znázorňující povolení Profileru ve vaší aplikaci

  8. Vyberte Použít a poté Ano k potvrzení.

Pro Application Insights a App Service v různých předplatných

Pokud je váš prostředek Application Insights v jiném předplatném než vaše instance služby App Service, musíte Profiler pro .NET povolit ručně. Povolte ho vytvořením nastavení aplikace pro instanci služby App Service. Vytváření těchto nastavení můžete automatizovat pomocí šablony nebo jiných prostředků. Zde jsou nastavení, abyste mohli povolit Profiler.

Nastavení aplikace Hodnota
APPLICATIONINSIGHTS_CONNECTION_STRING Tuto hodnotu získáte ze stránky Přehled vašeho prostředku Application Insights.
APPINSIGHTS_PROFILERFEATURE_VERSION 1.0.0
DiagnosticServices_EXTENSION_VERSION ~3

Nastavte tyto hodnoty pomocí:

Povolení .NET Profileru pro suverénní cloudy

Pokud vaše aplikace běží v suverénním cloudu, přidejte nastavení aplikace, která odkazují na Profiler, do správných regionálních koncových bodů. Tyto úpravy proveďte pouze pro Azure Government a Microsoft Azure provozovaný společností 21Vianet.

Nastavení aplikace Azure Government Platforma Microsoft Azure provozovaná společností 21Vianet
ApplicationInsightsProfilerEndpoint https://profiler.monitor.azure.us https://profiler.monitor.azure.cn
ApplicationInsightsEndpoint https://{region}.in.applicationinsights.azure.us https://{region}.in.applicationinsights.azure.cn

Porovnejte koncové body Azure Public a Azure Government pro běžné služby Azure.

Povolení ověřování Microsoft Entra pro příjem dat profilu

Application Insights Profiler pro .NET podporuje ověřování Microsoft Entra pro zpracování profilu. Aby agent Profileru mohl načítat všechny profily vaší aplikace, musí se vaše aplikace autentizovat a poskytnout agentu Profileru požadovaná nastavení aplikace.

Profiler podporuje pouze ověřování Microsoft Entra, pokud odkazujete na a konfigurujete ID Microsoft Entra pomocí sady Application Insights SDK ve vaší aplikaci.

Chcete-li povolit Microsoft Entra ID pro import profilů:

  1. Vytvořte spravovanou identitu a přidejte ji k vaší službě App Service pro ověřování vůči prostředku Application Insights.

  2. Nakonfigurujte a povolte Microsoft Entra ID v prostředku Application Insights.

  3. Přidáním následujícího nastavení aplikace dejte agentovi Profileru vědět, kterou spravovanou identitu použít.

    • Pro identitu přiřazenou systémem:

      Nastavení aplikace Hodnota
      APPLICATIONINSIGHTS_AUTHENTICATION_STRING Authorization=AAD
    • Pro identitu přiřazenou uživatelem:

      Nastavení aplikace Hodnota
      APPLICATIONINSIGHTS_AUTHENTICATION_STRING Authorization=AAD;ClientId={Client id of the User-Assigned Identity}

Zakázání profileru .NET

Zastavení nebo restartování Profileru pro instanci jednotlivé aplikace:

  1. Na webu Azure Portal přejděte do instance služby App Service.

  2. V části Nastavení v nabídce vlevo vyberte WebJobs.

    Snímek obrazovky znázorňující výběr webových úloh v nabídce vlevo

  3. Vyberte webovou úlohu s názvem ApplicationInsightsProfiler3.

  4. Vyberte ikonu Zastavit .

    Snímek obrazovky znázorňující výběr zastavení webové úlohy

  5. Potvrďte výběr možnosti Zastavit .

Nechte Profiler zapnutý ve všech vašich aplikacích, abyste co nejdříve zjistili případné problémy s výkonem.

Zabraňte tomu, aby byly soubory Profileru během nasazení pomocí Web Deploy smazány.

Když k nasazení změn ve vaší webové aplikaci použijete Web Deploy, může dojít k odstranění souborů Profileru. Chcete-li zabránit odstranění, vylučte App_Data složku z odstranění během nasazení.

  • Zjistěte, jak vytvořit zátěž a zobrazit trasování profileru .NET.
  • Naučte se používat funkci Optimalizace kódu společně s profilerem Application Insights pro .NET.