Как интегрировать Dynatrace и Jira для улучшения наблюдаемости

Want to learn more?

Подробнее о работе со спринтами в Jira см. в руководстве по спринтам.

Есть вопросы? Задайте вопрос в сообществе Atlassian.

Обзор

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

1. Настраивать автоматизацию Jira, чтобы создать комментарий к карточке проблемы Dynatrace с URL-ссылкой на задачу Jira.

2. Настраивать Dynatrace для отправки проблем в Jira.

3. Вызывать проблему в образце приложения, чтобы посмотреть, как Dynatrace обнаруживает проблему и автоматически создает задачу в Jira.

4. Настраивать запросы на создание задач Jira на странице релизов Dynatrace.

5. Очищать среду.

На этой диаграмме показаны компоненты данного учебного руководства и основное взаимодействие между ними.

1. Мониторинг приложения с помощью Dynatrace. В этом учебном руководстве Dynatrace будет получать показатели от агента Dynatrace, установленного на хосте, где выполняется образец приложения. Все данные централизованы у одного центрального держателя Dynatrace, который также предоставляет веб-интерфейс для администрирования и обнаружения проблем с помощью искусственного интеллекта.

2. Уведомление о проблемах с подробным контекстом. Davis — система искусственного интеллекта Dynatrace — использует высокоточные показатели, трассировки, журналы и реальные пользовательские данные, на основе которых создается единая сущностная модель. Детерминированный ИИ Davis используется для точного выявления первопричины проблемы. Davis не только обнаруживает точную причину, но и мгновенно предоставляет важный контекст. Вы узнаете, является ли причиной недостаток ресурсов или изменения в развертывании и даже кто за этим стоит. Вы можете воспроизводить проблемы, чтобы подробно узнать, почему они возникли и как их исправить.

3. Автоматическое создание задачи Jira. Интеграция Dynatrace и Jira позволяет автоматически создавать задачи для всех новых проблем, которые автоматически обнаруживаются в средах Dynatrace.

4. Обновление Dynatrace с помощью автоматизации Jira. Конструктор Automation в Jira не требует написания кода и позволяет с легкостью создавать правила несколькими щелчками мыши. В веб-запросе к API Dynatrace используется идентификатор проблемы Dynatrace для обновления комментариев в карточке проблемы Dynatrace.

5. Устранение проблемы и закрытие задачи Jira

2. В левом меню Dynatrace выберите опцию Transactions and services (Транзакции и сервисы) для просмотра работающих сервисов. Вы должны увидеть несколько работающих сервисов, включая сервисы frontend и order.

3. Нажмите сервис frontend. На странице сервиса нажмите кнопку View dynamic requests (Просмотреть динамические запросы).

На экране должны появиться запросы к сервису, как показано ниже.

2. В подменю настроек разверните подменю Integration (Интеграция) и выберите опцию Dynatrace API (API Dynatrace).

3. На странице Dynatrace API (API Dynatrace) нажмите кнопку Generate Token (Создать токен).

4. Укажите имя токена, например Jira Tutorial.

5. Разверните раздел API v1 (API, версия 1) и включите область доступа Access problem feed, metrics, and topology (Доступ к ленте проблем, показателям и топологии). Все остальные области доступа оставьте выключенными.

6. Нажмите кнопку Generate (Создать).

7. ВАЖНО! Созданный токен необходимо сохранить в надежном месте. Это значение понадобится вам позже в учебном руководстве, но вы не сможете просмотреть его снова. Чтобы скопировать всю строку, воспользуйтесь кнопкой Copy (Копировать).

8. После сохранения токена в надежном месте нажмите кнопку Close (Закрыть).

3. ВАЖНО! Не забудьте записать ключ проекта Jira. Это значение понадобится при настройке Dynatrace. В приведенном выше примере ключом является «DT».

4. В правом верхнем углу нажмите кнопку Create rule (Создать правило).

5. На странице New trigger (Новый триггер) выберите триггер под названием Issue commented (Задача прокомментирована) и нажмите Save (Сохранить) на следующей странице.

6. В правиле на странице Add component (Добавить компонент) нажмите опцию New action (Создать действие).

7. На странице New action (Создать действие) выберите вариант уведомления Send Web Request (Отправить веб-запрос).

8. Введите указанную ниже информацию. Ниже приведен пример того, как будет выглядеть действие:

• Webhook URL (URL-адрес веб-хука) — это URL-адрес конечной точки API Dynatrace. В этой строке вы должны заменить [ИДЕНТИФИКАТОР_ВАШЕЙ_СРЕДЫ] на свою среду. Чтобы получить это значение, сошлитесь на URL-адрес из своей среды Dynatrace.
  
  https://[ВАША_СРЕДА]/api/v1/problem/details/{{issue.description.match(".*pid=(.*)")}}/comments
  
  ТЕХНИЧЕСКОЕ ПРИМЕЧАНИЕ. Выражение с интеллектуальным значением Jira Match извлекает проблему Dynatrace или PID из URL-адреса проблемы, указанного в поле Issue Description (Описание задачи). Эти выражения можно, например, построить с помощью веб-сайта regex101.

• Headers (Заголовки): здесь содержится значение токена API Dynatrace, который вы создали ранее. В качестве имени заголовка используйте значение Authorization (Авторизация). В качестве значения заголовка используйте следующую строку, подставив в нее значение токена: «Api-Token [ВАШ_ТОКЕН_API_DYNATRACE]». ПРИМЕЧАНИЕ. Перед строкой токена необходимо добавить «Api-Token» и пробел.

• HTTP Method (HTTP-метод): выберите вариант POST.

• Webhook Body (Тело веб-хука): в раскрывающемся списке выберите вариант Custom Body (Пользовательское тело) и вставьте в поле полное тело JSON.

  { "message": "Открыта задача Jira: [{{issue.key}}]({{issue.url}})", "context": "Jira" }
  
  *** Профессиональный совет. Подробнее об интеллектуальных значениях см. здесь: https://support.atlassian.com/jira-software-cloud/docs/smart-values-general/

9. Нажмите кнопку Save (Сохранить).

10. На следующей странице введите имя, например «Отправить комментарий в Dynatrace о создании задачи». Нажмите кнопку Turn it on (Включить).

11. После сохранения нажмите в правом верхнем углу ссылку Return to list (Вернуться к списку), и вы увидите, что новое правило включено.

1. В левом меню Dynatrace выберите опцию Settings (Настройки).

2. В подменю настроек разверните подменю Integrations (Интеграции) и выберите опцию Problem notifications (Уведомления о проблемах).

3. Выберите Set up notifications (Настроить уведомления).

4. Выберите Jira из доступных типов уведомлений.

5. Настройте уведомление.

• Display name (Отображаемое имя): введите значение, например «Jira Tutorial»

• Jira endpoint URL (URL-адрес конечной точки Jira): измените это значение, подставив свой аккаунт JIRA

  https://[ВАШ_АККАУНТ_JIRA].atlassian.net/rest/api/2/

• Username (Имя пользователя): идентификатор пользователя, который вы использовали для создания токена API Atlassian

• API token (Токен API): строка токена API Atlassian

• Project key (Ключ проекта): ключ (не имя) проекта Jira, в котором создаются и отслеживаются новые задачи. Если вы используете тот же проект, что и в приведенном выше примере, ключом является «DT»

• Summary (Тема): оставьте значение по умолчанию

• Issue description (Описание задачи): оставьте значение по умолчанию
  
  *** Профессиональный совет. В разделе Available placeholders (Доступные заполнители) на странице конфигурации перечислены заполнители, которые можно использовать для этой интеграции. Заполнители будут автоматически заменяться информацией о проблеме.

6. Выберите Send test notification (Отправить тестовое уведомление), чтобы убедиться, что интеграция c Jira работает. То, что вы хотите увидеть:

А в Jira тестовая задача будет выглядеть так:

7. Нажмите кнопку Save (Сохранить).