Documentation for automated readers
A curated documentation index is available at: https://grafana.com/llms.txt
A complete documentation index is available at: https://grafana.com/llms-full.txt
These indexes can help with page discovery before fetching individual documents.
This page is also available in Markdown, which may be easier for automated readers
and AI tools to parse than HTML. The Markdown version is available at
https://grafana.com/ru/docs/grafana/latest/alerting/configure-notifications/manage-contact-points/integrations/configure-jira.md, or by sending
Accept: text/markdown to https://grafana.com/ru/docs/grafana/latest/alerting/configure-notifications/manage-contact-points/integrations/configure-jira/. For broader
documentation discovery, the curated index is available at https://grafana.com/llms.txt
and the complete index is available at https://grafana.com/llms-full.txt.
Используйте интеграцию Jira в точке контакта, чтобы создавать задачи в вашем экземпляре Jira при срабатывании оповещений. Интеграция поддерживает как Jira Cloud, так и установки Jira Server/Data Center.
Перед началом
Перед началом убедитесь, что у вас есть следующее:
Экземпляр Jira (Cloud, Server или Data Center)
Учётные данные для доступа к API Jira
Соответствующие разрешения для создания задач в вашем целевом проекте Jira
Настройка Jira для точки контакта
Чтобы создать точку контакта с интеграцией Jira, выполните следующие шаги:
Перейдите в Alerts & IRM -> Alerting -> Notification configuration, затем выберите вкладку Contact points.
Нажмите + Add contact point.
Введите имя точки контакта.
В списке Integration выберите Jira.
Задайте обязательные настройки для вашей конфигурации Jira.
Нажмите Save contact point.
Подробнее о точках контакта, включая их тестирование и включение уведомлений, см. в разделе
Настройка точек контакта.
Обязательные настройки
Ключ
Описание
URL
URL REST API вашего экземпляра Jira. Поддерживаемые версии: 2 и 3 (например, https://your-domain.atlassian.net/rest/api/3). Это поле
защищено от изменения в Grafana Cloud.
Basic Auth User
Имя пользователя для аутентификации. Для Jira Cloud используйте ваш адрес электронной почты.
Basic Auth Password
Пароль или персональный токен. Для Jira Cloud вам нужно получить персональный токен здесь и использовать его как пароль.
API Token
Альтернатива базовой аутентификации: bearer-токен используется для авторизации запросов API. Дополнительные сведения см. в документации Jira.
Project Key
Ключ проекта, идентифицирующий проект, в котором будут создаваться задачи. Ключи проектов — это уникальные идентификаторы проекта.
Issue Type
Тип создаваемой задачи (например, Task, Bug, Incident). Убедитесь, что вы указываете тип, доступный в вашем проекте.
Необязательные настройки
Ключ
Описание
Summary
Заголовок задачи. Поддерживает шаблонизацию. Максимальная длина — 255 символов.
Description
Описание задачи. В зависимости от версии API это может быть текст, Markdown или JSON (только API v3). Максимальный размер поля — 32 КБ. Примечание: JSON не ограничивается клиентом, и если он превышает размер, API, вероятно, отклонит запрос.
Labels
Пользовательские метки можно добавлять для организации и фильтрации задач, созданных в Jira. Поддерживает шаблонизацию, позволяя генерировать динамические метки на основе данных оповещения.
Priority
Уровень приоритета задачи (например, Low, Medium, High, Critical). Убедитесь, что значение приоритета соответствует доступным вариантам в вашем экземпляре Jira. Вы можете настроить уровни приоритета в Jira здесь.
Resolve Transition
Имя перехода для перевода задачи в разрешённое состояние при разрешении оповещения. Убедитесь, что значение соответствует допустимому переходу, доступному в вашем рабочем процессе Jira для указанного типа задачи. Если это поле пустое, задача не будет переведена в Done.
Reopen Transition
Имя перехода для возврата задачи в открытое состояние при повторном возникновении оповещения. Убедитесь, что значение соответствует допустимому переходу, доступному в вашем рабочем процессе Jira для указанного типа задачи. Если это поле пустое, задача не будет переоткрыта.
Reopen Duration
Длительность времени (в минутах), управляющая тем, переоткрывать ли задачу, закрытую в течение этого времени, или создавать новую. Если не указано, будет обновлена и переоткрыта (если указан переход переоткрытия) самая последняя задача, соответствующая ключу дедупликации.
“Won’t fix” Transition
Укажите статус разрешения, который следует игнорировать при поиске существующих задач. Например, задачи с таким разрешением не будут переоткрыты или обновлены последующими оповещениями.
Deduplication Key Field
Пользовательское поле для хранения ключа дедупликации. Должно быть текстовым полем. Если не указано, ключ дедупликации добавляется к меткам в формате ALERT(hash sum). О том, как создавать пользовательские поля, см. в документации Jira.
Fields
Позволяет настроить пользовательские поля задачи Jira. Имя поля должно быть в формате вида customfield_10001.
Grafana