Включение Profiler для приложений Службы приложений Azure

Application Insights Profiler устанавливается в составе среды выполнения служб приложений. Вы можете использовать Profiler в приложениях ASP.NET и ASP.NET Core, работающих в Службе приложений Azure, с использованием уровня служб "Базовый" или выше. Выполните эти действия, даже если вы включили пакет SDK для App Insights в свое приложение во время сборки.

Чтобы включить Profiler в Linux, ознакомьтесь с инструкциями по работе с приложениями веб-приложениям Azure ASP.NET Core в Linux.

Примечание

Установка Application Insights Profiler, не поддерживающая код, соответствует политике поддержки .NET Core.
Дополнительные сведения о поддерживаемых средах выполнения см. в статье Политика поддержки .NET Core.

Предварительные требования

Проверка того, что параметр Always On включен

  1. На портале Azure перейдите к Службе приложений.

  2. В разделе Параметры в меню слева выберите Конфигурация.

    Снимок экрана: выбор конфигурации в меню слева.

  3. Далее щелкните вкладку Общие параметры.

  4. Убедитесь, что выбрано Always On>Вкл.

    Снимок экрана: вкладка

  5. Щелкните Сохранить, если вы внесли изменения.

Включение Application Insights и профилировщика

Для Application Insights и Службы приложений в одной подписке

Если ресурс Application Insights находится в той же подписке, что и Служба приложений:

  1. В разделе Параметры в меню слева выберите Application Insights.

    Снимок экрана: выбор Application Insights в меню слева.

  2. В разделе Application Insights щелкните Включить.

  3. Убедитесь, что вы подключили к приложению ресурс Application Insights.

    Снимок экрана: включение Application Insights в приложении.

  4. Прокрутите вниз и выберите вкладку .NET или .NET Core в зависимости от приложения.

  5. Убедитесь, что выбрано Уровень коллекции>Рекомендуемый.

  6. В разделе Профилировщик щелкните Вкл.

    • Если ранее вы выбрали уровень коллекции Базовый, параметр Profiler будет отключен.
  7. Щелкните Применить и выберите Да, чтобы подтвердить.

    Снимок экрана: включение Profiler в приложении.

Для Application Insights и Службы приложений в разных подписках

Если ваш ресурс Application Insights находится в подписке, отличной от подписки Службы приложений, вам потребуется включить Profiler вручную, создав параметры приложения для Службы приложений Azure. Но вы можете автоматизировать создание этих параметров с помощью шаблона или других средств. Параметры, необходимые для включения Profiler:

Параметр приложения Значение
APPINSIGHTS_INSTRUMENTATIONKEY iKey для ресурса Application Insights
APPINSIGHTS_PROFILERFEATURE_VERSION 1.0.0
DiagnosticServices_EXTENSION_VERSION ~3

Настройте эти значения:

Включение Profiler для региональных облачных решений

В настоящее время единственными регионами, в которых требуется модификация конечных точек, являются Azure для государственных организаций и Azure для Китая.

Параметр приложения Облако для государственных организаций США Облако для Китая
ApplicationInsightsProfilerEndpoint https://profiler.monitor.azure.us https://profiler.monitor.azure.cn
ApplicationInsightsEndpoint https://dc.applicationinsights.us https://dc.applicationinsights.azure.cn

Включение проверки подлинности Azure Active Directory для приема профилей

Application Insights Profiler поддерживает проверку подлинности Azure AD для приема профилей. Для приема всех профилей приложения необходимо пройти проверку подлинности и предоставить агенту Profiler необходимые параметры приложения.

Profiler поддерживает проверку подлинности Azure AD, только если вы ссылаетесь на Azure AD и выполняете настройку с помощью пакета SDK для Application Insights в приложении.

Чтобы включить Azure AD для приема профилей:

  1. Создайте и добавьте управляемое удостоверение для проверки подлинности ресурса Application Insights в Службе приложений.

    а. Документация по управляемым удостоверениям, назначаемым системой

    b. Документация по управляемым удостоверениям, назначаемым пользователем

  2. Настройте и включите Azure AD в ресурсе Application Insights.

  3. Добавьте следующий параметр приложения, который позволяет агенту Profiler указать, какое управляемое удостоверение использовать:

    Для назначаемого системой удостоверения:

    Параметр приложения Значение
    APPLICATIONINSIGHTS_AUTHENTICATION_STRING Authorization=AAD

    Для назначаемого пользователем удостоверения:

    Параметр приложения Значение
    APPLICATIONINSIGHTS_AUTHENTICATION_STRING Authorization=AAD;ClientId={Client id of the User-Assigned Identity}

Отключение профилировщика

Чтобы остановить или перезапустить Profiler для отдельного экземпляра приложения:

  1. В разделе Параметры в меню слева выберите Веб=задания.

    Снимок экрана: выбор веб-заданий в меню слева.

  2. Выберите веб-задание с именем ApplicationInsightsProfiler3.

  3. Щелкните Остановить в меню вверху.

    Снимок экрана: кнопка

  4. Выберите Да для подтверждения.

Мы рекомендуем включить Profiler для всех приложений, чтобы обеспечить максимально быстрое обнаружение проблем производительности.

Файлы Profiler можно удалить при использовании WebDeploy для развертывания изменений в веб-приложении. Можно предотвратить удаление, исключив папку App_Data из числа удаляемых во время развертывания.

Дальнейшие действия

Изучение процесса выполнения следующих задач: