Udostępnij za pośrednictwem


Włączanie profilera dla aplikacji usługi aplikacja systemu Azure Service

Profiler usługi Application Insights jest wstępnie zainstalowany w ramach środowiska uruchomieniowego usługi aplikacja systemu Azure. 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. Wykonaj następujące kroki, nawet jeśli zestaw SDK usługi Application Insights został uwzględniony w aplikacji w czasie kompilacji.

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

Uwaga

Instalacja bez kodu 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

  • Aplikacja aplikacja systemu Azure Service ASP.NET/ASP.NET Core.
  • Zasób usługi Application Insights połączony z aplikacją usługi App Service.

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

  1. W witrynie Azure Portal przejdź do wystąpienia usługi App Service.

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

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

    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 profilera

W poniższych sekcjach pokazano, jak włączyć usługę Application Insights dla tej samej subskrypcji lub różnych subskrypcji.

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 twoje wystąpienie usługi App Service:

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

    Zrzut ekranu przedstawiający wybieranie usługi Application Insights w okienku 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 Application Insights w aplikacji.

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

  5. Sprawdź, czy wybrano pozycję Zalecane na poziomie>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>tak, aby potwierdzić.

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

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

Jeśli zasób usługi Application Insights znajduje się w innej subskrypcji niż wystąpienie usługi App Service, musisz ręcznie włączyć profilera, tworząc ustawienia aplikacji dla wystąpienia usługi App Service. Tworzenie tych ustawień można zautomatyzować przy użyciu szablonu lub innego sposobu. Poniżej przedstawiono ustawienia, które należy włączyć profiler.

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ą platforma Azure Government i platforma Microsoft Azure obsługiwana przez firmę 21Vianet.

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 w usłudze Microsoft Entra na potrzeby pozyskiwania profilów

Usługa Application Insights Profiler obsługuje uwierzytelnianie w usłudze Microsoft Entra na potrzeby pozyskiwania profilów. Aby wszystkie profile aplikacji zostały pozyskane, aplikacja musi zostać uwierzytelniona i podać wymagane ustawienia aplikacji agentowi profilera.

Profiler obsługuje uwierzytelnianie entra firmy Microsoft tylko podczas odwołowania się i konfigurowania identyfikatora Entra firmy Microsoft przy użyciu zestawu SDK usługi Application Insights w aplikacji.

Aby włączyć identyfikator entra firmy Microsoft na potrzeby pozyskiwania profilów:

  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 przypisanej przez system

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

  2. Skonfiguruj i włącz identyfikator entra firmy Microsoft 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

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

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

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

  2. Wybierz obiekt webjob o nazwie ApplicationInsightsProfiler3.

  3. Wybierz pozycję Zatrzymaj.

    Zrzut ekranu przedstawiający wybieranie zatrzymania zatrzymania zadania 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
  • Dowiedz się, jak używać funkcji optymalizacji kodu wraz z profilerem usługi Application Insights