Włączanie profilera dla aplikacji Azure App Service

Profiler usługi Application Insights jest wstępnie zainstalowany w ramach środowiska uruchomieniowego usługi App Services. Profiler można uruchamiać w aplikacjach ASP.NET i ASP.NET Core działających w usłudze Azure App Service przy użyciu warstwy usługi Podstawowa lub wyższej. Wykonaj następujące kroki, nawet jeśli zestaw SDK usługi App Insights został uwzględniony w aplikacji w czasie kompilacji.

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

Uwaga

Bezkodowa instalacja profilera usługi Application Insights jest zgodna z zasadami obsługi platformy .NET Core.
Aby uzyskać więcej informacji na temat obsługiwanego środowiska uruchomieniowego, zobacz Zasady pomocy technicznej platformy .NET Core.

Wymagania wstępne

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

  1. W Azure Portal przejdź do App Service.

  2. W obszarze Ustawienia w menu po lewej stronie wybierz pozycję Konfiguracja.

    Zrzut ekranu przedstawiający wybieranie pozycji Konfiguracja z menu po lewej stronie.

  3. Wybierz kartę Ustawienia ogólne .

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

    Zrzut ekranu przedstawiający kartę Ogólne w okienku Konfiguracja i zawsze włączone.

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

Włączanie usługi Application Insights i profilera

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

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

  1. W obszarze Ustawienia w menu po lewej stronie wybierz pozycję Application Insights.

    Zrzut ekranu przedstawiający wybieranie usługi Application Insights z menu po lewej stronie.

  2. W obszarze Application Insights wybierz pozycję Włącz.

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

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

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

  5. Sprawdź, czy wybranozalecanypoziom> kolekcji.

  6. W obszarze Profiler wybierz pozycję Włączone.

    • Jeśli wcześniej wybrano poziom kolekcji Podstawowa , ustawienie Profiler zostanie wyłączone.
  7. Wybierz pozycję Zastosuj, a następnie pozycję Tak , aby potwierdzić.

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

W przypadku usługi Application Insights i App Service w różnych subskrypcjach

Jeśli zasób usługi Application Insights znajduje się w innej subskrypcji niż App Service, musisz ręcznie włączyć profilera, tworząc ustawienia aplikacji dla Azure App Service. Tworzenie tych ustawień można zautomatyzować przy użyciu szablonu lub innych środków. Ustawienia wymagane do włączenia profilera:

Ustawienia aplikacji Wartość
APPINSIGHTS_INSTRUMENTATIONKEY Klucz iKey dla zasobu usługi Application Insights
APPINSIGHTS_PROFILERFEATURE_VERSION 1.0.0
DiagnosticServices_EXTENSION_VERSION ~3

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

Włączanie profilera dla chmur regionalnych

Obecnie jedynymi regionami, które wymagają modyfikacji punktów końcowych, są Azure Government i Azure (Chiny).

Ustawienia aplikacji Chmura dla instytucji rządowych USA Chmura w Chinach
ApplicationInsightsProfilerEndpoint https://profiler.monitor.azure.us https://profiler.monitor.azure.cn
ApplicationInsightsEndpoint https://dc.applicationinsights.us https://dc.applicationinsights.azure.cn

Włączanie uwierzytelniania usługi Azure Active Directory na potrzeby pozyskiwania profilów

Usługa Application Insights Profiler obsługuje uwierzytelnianie Azure AD na potrzeby pozyskiwania profilów. Aby wszystkie profile aplikacji zostały pozyskane, należy uwierzytelnić aplikację i podać wymagane ustawienia aplikacji agentowi profilera.

Profiler obsługuje tylko uwierzytelnianie Azure AD podczas odwoływanie się i konfigurowanie Azure AD przy użyciu zestawu SDK usługi Application Insights w aplikacji.

Aby włączyć Azure AD pozyskiwania profilów:

  1. Utwórz i dodaj tożsamość zarządzaną w celu uwierzytelnienia względem zasobu usługi Application Insights do App Service.

    a. Dokumentacja tożsamości zarządzanej przypisanej przez system

    b. Dokumentacja tożsamości zarządzanej przypisanej przez użytkownika

  2. Konfigurowanie i włączanie Azure AD w zasobie usługi Application Insights.

  3. Dodaj następujące ustawienie aplikacji, aby poinformować agenta Profilera o tym, której tożsamości zarządzanej użyć:

    W przypadku System-Assigned Identity:

    Ustawienia aplikacji Wartość
    APPLICATIONINSIGHTS_AUTHENTICATION_STRING Authorization=AAD

    W przypadku User-Assigned Identity:

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

Wyłączanie profilera

Aby zatrzymać lub ponownie uruchomić profiler dla wystąpienia pojedynczej aplikacji:

  1. W obszarze Ustawienia w menu po lewej stronie wybierz pozycję Zadania WebJob.

    Zrzut ekranu przedstawiający wybieranie zadań internetowych z menu po lewej stronie.

  2. Wybierz obiekt webjob o nazwie ApplicationInsightsProfiler3.

  3. Kliknij pozycję Zatrzymaj w górnym menu.

    Zrzut ekranu przedstawiający wybieranie pozycji Zatrzymaj w celu zatrzymania zadania webjob.

  4. Wybierz pozycję 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 za pomocą narzędzia WebDeploy. Usunięcie można zapobiec, wykluczając usunięcie folderu App_Data podczas wdrażania.

Następne kroki

Dowiedz się, jak...