Udostępnij za pomocą


Włączanie profilera platformy .NET dla aplikacji usługi Azure App Service w systemie Windows

Profiler usługi Application Insights dla platformy .NET jest preinstalowany jako część środowiska uruchomieniowego usługi Azure App Service. Profiler można uruchamiać w aplikacjach ASP.NET i ASP.NET Core działających w usłudze App Service przy użyciu warstwy usługi Podstawowa lub nowsza.

Bez kodu instalacja profilera usługi Application Insights dla platformy .NET:

  • Zgodnie z zasadami obsługi platformy .NET Core.
  • Jest obsługiwana tylko w aplikacjach internetowych opartych na systemie Windows.

Aby włączyć program .NET Profiler w systemie Linux, zapoznaj się z instrukcjami dotyczącymi ASP.NET Core aplikacji internetowych platformy Azure dla systemu Linux.

Wymagania wstępne

Sprawdź, czy ustawienie "Zawsze włączone" jest włączone

  1. W portalu Azure przejdź do instancji usługi App Service.

  2. W menu po lewej stronie wybierz pozycję >.

    Zrzut ekranu przedstawiający wybieranie pozycji Konfiguracja w okienku po lewej stronie.

  3. Wybierz kartę Ustawienia Ogólne.

  4. Sprawdź, czy wybrano opcję Zawsze włączone>.

    Uwaga

    Jeśli przełącznik Zawsze włączony jest wyłączony, uaktualnij aplikację internetową usługi App Service, aby uruchomić ją w warstwie Podstawowa lub nowsza.

    Zrzut ekranu przedstawiający kartę Ogólne w okienku Konfiguracja z włączoną funkcją Always On.

  5. Wybierz pozycję Zapisz , jeśli wprowadzono zmiany.

Włączanie usługi Application Insights i programu .NET Profiler

Profiler można włączyć w następujących przypadkach:

W przypadku usług "Application Insights" i "App Service" w tej samej subskrypcji

Jeśli zasób usługi Application Insights znajduje się w tej samej subskrypcji co Twoja instancja usługi App Service:

  1. W menu po lewej stronie wybierz Monitorowanie>Application Insights.

  2. Kliknij przycisk Włącz usługę Application Insights .

    Zrzut ekranu przedstawiający włączanie usługi Application Insights dla aplikacji.

  3. Na stronie ustawienia usługi Application Insights w obszarze Application Insights upewnij się, że wybrano pozycję Włącz .

  4. Sprawdź, czy połączono zasób usługi Application Insights z aplikacją.

    Zrzut ekranu przedstawiający włączanie usługi Application Insights w aplikacji.

  5. Przewiń w dół i wybierz kartę .NET lub .NET Core w zależności od aplikacji.

  6. Sprawdź, czy wybrano poziom kolekcji>Zalecane.

  7. W obszarze Profiler i optymalizacje kodu wybierz pozycję Włączone. Jeśli wcześniej wybrano poziom kolekcji Podstawowa , ustawienie Profiler zostanie wyłączone.

    Zrzut ekranu przedstawiający włączanie profilera w aplikacji.

  8. Wybierz Zastosuj>Tak, aby potwierdzić.

W przypadku usług Application Insights i App Service znajdujących się w różnych subskrypcjach

Jeśli zasób Application Insights znajduje się w innej subskrypcji niż wystąpienie App Service, musisz ręcznie włączyć profiler dla .NET, tworząc ustawienia aplikacji dla tego wystąpienia. Tworzenie tych ustawień można zautomatyzować przy użyciu szablonu lub innego sposobu. Oto ustawienia, które musisz włączyć, aby aktywować Profiler.

Ustawienia aplikacji Wartość
APPLICATIONINSIGHTS_CONNECTION_STRING Unikatowa wartość zasobu usługi App Insights.
APPINSIGHTS_PROFILERFEATURE_VERSION 1.0.0
Wersja rozszerzenia usług diagnostycznych ~3

Ustaw następujące wartości przy użyciu:

Włączanie programu .NET Profiler dla chmur regionalnych

Obecnie jedynymi regionami, które wymagają modyfikacji punktów końcowych, są platforma Azure Government i platforma Microsoft Azure obsługiwana przez firmę 21Vianet.

Ustawienia aplikacji Chmura rządowa USA Chmura chińska
ApplicationInsightsProfilerEndpoint https://profiler.monitor.azure.us https://profiler.monitor.azure.cn
ApplicationInsightsEndpoint https://{region}.in.applicationinsights.azure.us https://{region}.in.applicationinsights.azure.cn

Porównanie publicznych punktów końcowych platformy Azure i punktów końcowych platformy Azure dla instytucji rządowych dla typowych usług platformy Azure.

Włącz uwierzytelnianie w usłudze Microsoft Entra do pobierania profili

Profiler usługi Application Insights dla platformy .NET obsługuje uwierzytelnianie Microsoft Entra na potrzeby pobierania profili. Aby wszystkie profile Twojej aplikacji były dostępne, aplikacja musi być uwierzytelniona i przekazać wymagane ustawienia aplikacji agentowi profilera.

Profiler obsługuje uwierzytelnianie Microsoft Entra tylko wtedy, gdy odwołujesz się do i konfigurujesz Microsoft Entra ID przy użyciu zestawu SDK usługi Application Insights w aplikacji.

Aby włączyć Microsoft Entra ID na potrzeby importowania profili:

  1. Utwórz i dodaj tożsamość zarządzaną, aby uwierzytelnić się względem zasobu usługi Application Insights w usłudze App Service:

    1. Dokumentacja tożsamości zarządzanej systemowo

    2. Dokumentacja tożsamości zarządzanej przypisanej użytkownikowi

  2. Skonfiguruj i włącz Microsoft Entra ID w zasobie usługi Application Insights.

  3. Dodaj następujące ustawienie aplikacji, aby poinformować agenta profilera o tym, która tożsamość zarządzana ma być używana.

    • W przypadku tożsamości przypisanej przez system:

      Ustawienia aplikacji Wartość
      APPLICATIONINSIGHTS_AUTHENTICATION_STRING Authorization=AAD
    • W przypadku tożsamości przypisanej przez użytkownika:

      Ustawienia aplikacji Wartość
      APPLICATIONINSIGHTS_AUTHENTICATION_STRING Authorization=AAD;ClientId={Client id of the User-Assigned Identity}

Wyłączanie profilera platformy .NET

Aby zatrzymać lub ponownie uruchomić Profiler dla instancji pojedynczej aplikacji:

  1. W sekcji Ustawienia w lewym panelu wybierz pozycję WebJobs.

    Zrzut ekranu przedstawiający wybieranie zadań internetowych w okienku po lewej stronie.

  2. Wybierz zadanie sieciowe o nazwie ApplicationInsightsProfiler3.

  3. Wybierz Zatrzymaj.

    Zrzut ekranu przedstawiający wybieranie zatrzymania webjob.

  4. Wybierz Tak, aby potwierdzić.

Zalecamy, aby profiler był włączony we wszystkich aplikacjach, aby jak najszybciej wykryć wszelkie problemy z wydajnością.

Pliki profilera można usunąć podczas wdrażania zmian w aplikacji internetowej przy użyciu narzędzia WebDeploy. Usunięcie można zapobiec, wykluczając usunięcie folderu App_Data podczas wdrażania.

Następne kroki

  • Dowiedz się, jak wygenerować obciążenie i wyświetlić ślady profilera platformy .NET
  • Dowiedz się, jak używać funkcji optymalizacji kodu wraz z profilerem usługi Application Insights dla platformy .NET