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


Интеграция рабочих элементов

Интеграция рабочих элементов позволяет создавать проблемы, ошибки или задачи в GitHub или Azure DevOps непосредственно из интерфейса Application Insights . Шаблоны внедряют запросы языка запросов Kusto (KQL) и содержимое рабочей книги, чтобы новые рабочие элементы включали соответствующие данные телеметрии.

Шаблоны рабочих элементов — это Azure Monitor Workbooks, сохраненные как тип ресурса. Создавайте и автоматизируйте эти рабочие книги, как и любые другие рабочие книги.

Интеграция рабочих элементов включает следующие функции:

  • Указывает, предназначен ли шаблон для GitHub или Azure DevOps с помощью значков репозитория.
  • Поддержка нескольких конфигураций для любого количества репозиториев или рабочих элементов.
  • Развертывание с помощью шаблонов Azure Resource Manager (ARM).
  • Включите предварительно созданные и настраиваемые запросы языка запросов Kusto (KQL), которые добавляют данные Application Insights в рабочие элементы.
  • Предоставьте настраиваемые шаблоны рабочих книг.

Permissions

Чтобы создать или изменить шаблон рабочего элемента, используйте роль Azure с правами Microsoft.Insights/workbooks/write, например, Workbook Contributor или Monitoring Contributor.

Чтобы создать сам рабочий элемент, необходимо достаточное разрешение в целевой системе (GitHub или Azure DevOps). Элемент создается в этой системе после открытия новой вкладки на портале.

Создание и настройка шаблона рабочего элемента

  1. Откройте ресурс Application Insights . В разделе "Настройка" откройте рабочие элементы и нажмите кнопку "Создать новый шаблон".
  2. Или начните с полных сведений о транзакциях, если шаблон не существует. Выберите событие, нажмите кнопку "Создать рабочий элемент" и выберите "Начать с шаблона книги".
  3. После нажатия кнопки "Создать новый шаблон" выберите систему отслеживания, назовите книгу, свяжите ее с системой отслеживания и выберите регион для хранилища шаблонов. Введите URL-адрес репозитория по умолчанию, например https://github.com/myusername/reponame или https://dev.azure.com/{org}/{project}. Выбранный регион — это локация Azure сохраненного ресурса рабочей книги. Он не изменяет место хранения или запроса данных Application Insights.
  4. Задайте свойства рабочего элемента по умолчанию в шаблоне. Свойства включают назначение, путь итерации и проекты. Доступные свойства зависят от системы отслеживания.

Замечание

Для локальных сред Azure DevOps используйте URL-адрес заполнителя, например https://dev.azure.com/test/test при создании шаблона. После создания откройте созданную книгу Azure, измените текстовый параметр URL-адреса репозитория и добавьте правило проверки (регулярное выражение), соответствующее узлу Сервера Azure DevOps Server, например ^https://devops\.contoso\.corp/.*$.

Создание рабочих элементов

Используйте шаблон из сквозных сведений о транзакциях, который доступен на вкладках производительность, сбои, доступность и других.

Замечание

При первом нажатии кнопки "Создать рабочий элемент" вам будет предложено связать Application Insights с организацией и проектом Azure DevOps.

Снимок экрана: сквозное представление сведений о транзакциях с кнопкой для создания рабочего элемента.

  1. Откройте подробные сведения о транзакциях, выберите событие и нажмите кнопку "Создать рабочий элемент".
  2. Выберите шаблон. Если шаблон не существует, выберите "Начать с шаблона книги ", чтобы создать его.
  3. Заполните панель "Новый рабочий элемент ". Application Insights предварительно заполняет контекстные данные из выбранного события, например сведения об исключении, имя операции и ссылку обратно на транзакцию. Добавьте все необходимые дополнительные сведения, а затем сохраните.
  4. Откроется новая вкладка браузера в системе отслеживания. В Azure DevOps создайте ошибку или задачу. В GitHub создайте проблему в репозитории. Рабочий элемент включает контекст из Application Insights.

Изменение шаблона

  1. Откройте рабочие элементы в разделе "Настройка", а затем щелкните значок карандаша рядом с книгой для обновления.
  2. Выберите "Изменить" на верхней панели инструментов.
  3. Чтобы стандартизировать развертывание рабочих книг в разных средах, используйте шаблоны Azure Resource Manager (ARM). Создайте несколько конфигураций для разных сценариев.

Устранение неполадок

См. статью об устранении неполадок.