Поделиться через


Создание и настройка ресурсов Application Insights

Это важно

Эта статья относится к ресурсам Application Insights, основанным на рабочей области. Классические ресурсы Application Insights были выведены из эксплуатации. Переход на Application Insights на основе рабочей области , чтобы воспользоваться преимуществами новых возможностей.

Application Insights интегрируется с Log Analytics и отправляет данные телеметрии в общую рабочую область Log Analytics. Эта настройка обеспечивает полный доступ к функциям Log Analytics, объединяет журналы в одном расположении и позволяет унифицированному управлению доступом на основе ролей Azure , что устраняет потребность в запросах между приложениями и рабочими областями.

К расширенным возможностям относятся:

В этой статье показано, как создавать и настраивать ресурсы Application Insights. Наряду с самим ресурсом Application Insights можно добавить различные конфигурации, такие как установка ежедневного плана ограничения и ценообразования. Вы также можете создавать тесты доступности, настраивать оповещения метрик и автоматизировать процесс с помощью Azure Resource Manager.

Примечание.

Прием и хранение данных ресурсов Application Insights на основе рабочей области оплачиваются через рабочую область Log Analytics, в которой находятся эти данные. Подробнее о выставлении счетов см. в разделе Цены на журналы Azure Monitor.

Предпосылки

  • Активная подписка Azure.
  • Необходимые разрешения для создания ресурсов.

Дополнительные требования

Никаких дополнительных требований.

Создание ресурса Application Insights

  1. Войдите на портал Azure.
  2. Выберите "Создать ресурс".
  3. Откройте категорию мониторинга и диагностики, а затем выберите Application Insights.
  4. Введите все соответствующие сведения, а затем проверьте и создайте ресурс Application Insights.

Снимок экрана: ресурс Application Insights.

Примечание.

Если вы не подключаетесь к существующей рабочей области Log Analytics во время создания ресурса, новый ресурс Log Analytics создается автоматически вместе с ресурсом Application Insights.

После создания ресурса можно найти соответствующие сведения о рабочей области в панели Обзор Application Insights.

Снимок экрана: имя рабочей области.

Щелкните текст синей ссылки, чтобы перейти в соответствующую рабочую область Log Analytics, где можно воспользоваться преимуществами новой единой среды обработки запросов рабочей области.

Примечание.

По-прежнему обеспечивается полная обратная совместимость запросов к вашим классическим ресурсам Application Insights, рабочих книг и оповещений на основе журналов. Чтобы запросить или просмотреть новую структуру таблицы или схему на основе рабочей области, сначала перейдите в рабочую область Log Analytics. Выберите журналы (Аналитика) на панеляхApplication Insights для доступа к классическому интерфейсу запросов Application Insights.

Настройка мониторинга

После создания ресурса Application Insights настройте мониторинг.

Получите строку подключения

Строка подключения определяет ресурс, с которыми необходимо связать данные телеметрии. Вы также можете использовать его для изменения конечных точек, используемых ресурсом в качестве назначения для телеметрии. Необходимо скопировать строку подключения и добавить ее в код приложения или переменную среды.

Чтобы получить строку подключения ресурса Application Insights, выполните следующие действия.

  1. Откройте ресурс Application Insights на портале Azure.
  2. В области "Обзор " в разделе "Основные сведения" найдите строку подключения.
  3. Если навести указатель мыши на строку подключения, появится значок, позволяющий скопировать его в буфер обмена.

Мониторинг приложений с помощью OpenTelemetry

Для мониторинга приложений с помощью OpenTelemetry сначала установите соответствующий дистрибутив Azure Monitor OpenTelemetry, а затем укажите строку подключения к вновь созданному ресурсу.

Сведения о настройке мониторинга приложений с помощью OpenTelemetry см. в следующей документации по языку:

Примечание.

Для веб-приложений, предназначенных для браузеров, мы рекомендуем использовать JavaScript SDK Application Insights.

Автоматическое инструментирование

Для таких служб мониторинга, как Функции Azure и Служба приложений Azure, сначала можно создать ресурс Application Insights, а затем указать на него при включении мониторинга. Вы также можете создать ресурс для Application Insights во время процесса включения.

Настройка ресурсов Application Insights

Изменение связанной рабочей области

После создания ресурса Application Insights можно изменить связанную рабочую область Log Analytics.

В ресурсе Application Insights выберите Свойства>Сменить рабочую область>Log Analytics Workspaces.

Экспорт телеметрии

Устаревшие функции непрерывного экспорта не поддерживаются для ресурсов рабочей области. Вместо этого используйте параметры диагностики.

Примечание.

Экспорт параметров диагностики может привести к увеличению затрат. Дополнительные сведения см. в статье "Экспорт телеметрии" из Application Insights. Сведения о ценах на эту функцию см. на странице цен Azure Monitor. Перед началом выставления счетов отправляются уведомления. Если вы продолжите использование экспорта телеметрии после периода уведомления, вам будет выставлен счет по применимой ставке.

В ресурсе Application Insights выберите параметры диагностики>".

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

Настройка срока хранения данных

Хранение данных для ресурсов Application Insights можно задать в связанной рабочей области Log Analytics.

Дополнительные сведения см. в разделе "Настройка интерактивного периода хранения по умолчанию" таблиц Аналитики.

Установка ежедневного ограничения

Ежедневное ограничение должно быть установлено независимо как для Application Insights, так и для базовой рабочей области Log Analytics. Эффективное ежедневное ограничение — это минимум двух параметров.

Сведения о том, как установить ежедневное ограничение на портале Azure, см. в статье «Установка ежедневного ограничения в рабочей области Log Analytics».

Выбор тарифного плана

План ценообразования для ресурсов Application Insights можно задать в связанной рабочей области Log Analytics. Дополнительные сведения о доступных планах ценообразования см. в разделе " Расчеты затрат и варианты" журналов Azure Monitor.

Примечание.

Если вы видите непредвиденные расходы или высокие затраты в Application Insights, это руководство может помочь. В ней рассматриваются распространенные причины, такие как высокий объем телеметрии, пики приема данных и неправильно настроенная выборка. Особенно полезно, если вы устраняете проблемы, связанные с резким увеличением затрат, объемом телеметрии, неисправной выборкой, ограничениями данных, высокой нагрузкой на прием данных или неожиданными счетами. Чтобы начать, ознакомьтесь с материалом по устранению неполадок в случае высокого объёма поступающих данных в Application Insights.

Сведения о настройке плана ценообразования на портале Azure см. в разделе выставления счетов Application Insights.

Отключение маскирования IP-адресов

По умолчанию Application Insights не сохраняет IP-адреса. Сведения об отключении маскирования IP-адресов см. в разделе "Геолокация" и "Обработка IP-адресов".

Создание дополнительных ресурсов

Создание теста доступности

Чтобы узнать, как создать тест доступности на портале Azure, ознакомьтесь с тестами доступности Application Insights.

Добавьте оповещение метрики

Подсказка

Каждый ресурс Application Insights поставляется с метриками, доступными по умолчанию. Если отдельные компоненты отчитываются в один и тот же ресурс Application Insights, возможно, не имеет смысла создавать оповещения по этим метрикам.

Чтобы узнать, как создать оповещение метрик на портале Azure, см. руководство по созданию оповещения метрик для ресурса Azure.

Чтобы автоматизировать создание оповещений метрик, см. статью шаблона оповещений метрик .

Создание дополнительных ресурсов Application Insights

Сколько ресурсов Application Insights следует развернуть?

При разработке следующей версии веб-приложения вы не хотите смешивать данные телеметрии Application Insights из новой версии и уже выпущенной версии.

Чтобы избежать путаницы, отправляйте данные телеметрии с разных этапов разработки в отдельные ресурсы Application Insights с отдельными строками подключения.

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

Когда лучше использовать один ресурс Application Insights

Используйте один ресурс Application Insights для:

  • Упрощение управления DevOps/ITOps для приложений, развернутых вместе, обычно разработанных и управляемых одной командой.
  • Централизация ключевых показателей производительности, таких как время отклика и частоты сбоев, по умолчанию на панели мониторинга. При необходимости сегментируйте по имени роли в обозревателе метрик.
  • При отсутствии необходимости в различном управлении системой контроля доступа на основе ролей Azure между компонентами приложения.
  • Когда идентичные критерии оповещения метрик, непрерывный экспорт и управление выставлением счетов и квотами между компонентами достаточны.
  • Когда допустимо, чтобы ключ API имел равный доступ к данным из всех компонентов, и 10 ключей API удовлетворяют потребности всех компонентов.
  • Если одни и те же параметры интеллектуального обнаружения и интеграции рабочих элементов подходят для всех ролей.

Примечание.

Если вы хотите объединить несколько ресурсов Application Insights, можно указать существующие компоненты приложения на новый консолидированный ресурс Application Insights. Данные телеметрии, хранящиеся в старом ресурсе, не передаются в новый ресурс. Удалите старый ресурс, только если в новом ресурсе достаточно данных телеметрии для обеспечения непрерывности бизнес-процессов.

Другие вопросы

Чтобы активировать интерфейс портала, добавьте пользовательский код для назначения значимых значений атрибуту Cloud_RoleName . Без этих значений функции портала не работают.

Для приложений Azure Service Fabric и классических облачных служб пакет SDK автоматически настраивает службы, читая из среды роли Azure. Для других типов приложений обычно необходимо явно задать его.

Живые метрики не могут разделить данные по имени роли.

Отслеживание версии и релиза

При публикации новой версии приложения необходимо иметь возможность отделять данные телеметрии от разных сборок. Вы можете задать свойство Версии приложения , чтобы можно было фильтровать результаты поиска и обозревателя метрик .

Существует несколько различных методов настройки свойства Версии приложения .

  • Вариант 1. Установка версии напрямую

    Добавьте строку telemetryClient.Context.Component.Version = typeof(MyProject.MyClass).Assembly.GetName().Version; в код инициализации приложения.

    Чтобы убедиться, что все TelemetryClient экземпляры настроены одинаково, оберните эту строку в инициализатор телеметрии.

  • Вариант 2: Установите версию в BuildInfo.config (только ASP.NET)

    Веб-модуль Application Insights выбирает версию из BuildLabel узла. Включите этот файл в проект и не забудьте задать свойство Copy Always в обозревателе решений.

    <?xml version="1.0" encoding="utf-8"?>
    <DeploymentEvent xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/VisualStudio/DeploymentEvent/2013/06">
      <ProjectName>AppVersionExpt</ProjectName>
      <Build type="MSBuild">
        <MSBuild>
          <BuildLabel kind="label">1.0.0.2</BuildLabel>
        </MSBuild>
      </Build>
    </DeploymentEvent>
    
    

    Сгенерировать BuildInfo.config автоматически в системе сборки Microsoft. Добавьте в файл .csproj следующие строки:

    <PropertyGroup>
      <GenerateBuildInfoConfigFile>true</GenerateBuildInfoConfigFile>
      <IncludeServerNameInBuildInfo>true</IncludeServerNameInBuildInfo>
    </PropertyGroup>
    

    На этом шаге создается файл с именем yourProjectName.BuildInfo.config. Процесс публикации переименовывает его в BuildInfo.config.

    Метка сборки содержит заполнитель (*AutoGen_...*) при сборке с помощью Visual Studio. При построении с помощью обработчика сборки Microsoft заполнитель заполняется правильным номером версии.

    Чтобы разрешить обработчику сборки Майкрософт создавать номера версий, задайте такую версию, как 1.0.* в AssemblyReference.cs.

Примечания к выпуску

Если вы используете Azure DevOps, вы можете добавить маркер заметки на диаграммы при каждом выпуске новой версии.

Автоматизация процесса создания ресурсов

Процесс создания ресурсов можно автоматизировать с помощью шаблонов Bicep или JSON с помощью Azure Resource Manager. Вы можете упаковать несколько ресурсов вместе, чтобы создать их в одном развертывании. Например, можно создать ресурс Application Insights с тестами доступности, оповещениями метрик и параметром диагностики для отправки данных телеметрии в учетную запись хранения Azure.

Создание шаблона на портале Azure

Шаблон можно создать из существующих ресурсов.

Только Application Insights

  1. Перейдите к ресурсу Application Insights на портале Azure.
  2. Откройте шаблон экспорта , указанный в разделе "Автоматизация " на панели навигации слева.
  3. (Необязательно): Чтобы использовать собственные параметры, снимите флажок "Включить параметры".
  4. Скачайте файл шаблона или разверните его непосредственно на портале Azure.

Несколько ресурсов

  1. Перейдите в группу ресурсов ресурса Application Insights.
  2. На панели обзора пометьте все ресурсы, которые вы хотите включить в шаблон, а затем выберите " Экспорт шаблона " на верхней панели навигации.
  3. (Необязательно): Чтобы использовать собственные параметры, снимите флажок "Включить параметры".
  4. Скачайте файл шаблона или разверните его непосредственно на портале Azure.

Создание шаблона с нуля

Чтобы узнать, как создать шаблон ARM с нуля, ознакомьтесь с нашей документацией по шаблону ARM , включающей руководства по созданию шаблона, добавлению ресурсов, добавлению параметров и т. д.

Доступные свойства для Application Insights, тестов на доступность, оповещений о метриках, настроек диагностики и других ресурсов можно найти в документации по ресурсам Azure в разделе Reference>Monitor>Insights.

Подсказка

Вы также можете использовать шаблоны быстрого запуска, доступные в нижней части каждой страницы справочной документации по ресурсам Azure, связанной в этом разделе. Сведения об использовании шаблонов см. в руководстве по использованию шаблонов быстрого запуска Azure.

Следующие шаги