› › ›

Действие Watcher для Jira

Используйте действие jira для создания задач в Jira Software от Atlassian. Для создания задач необходимо настроить хотя бы одну учетную запись Jira в elasticsearch.yml.

Настройка действий для Jira

Настройка действий для Jira выполняется в массиве actions. Атрибуты, специфичные для действия, указываются с помощью ключевого слова jira.

Следующий фрагмент кода демонстрирует простое определение действия для Jira:

"actions" : {
  "create-jira-issue" : {
    "transform" : { ... },
    "throttle_period" : "5m",
    "jira" : {
      "account" : "integration-account", 
      "fields" : {
          "project" : {
            "key": "PROJ" 
          },
          "issuetype" : {
            "name": "Bug" 
          },
          "summary" : "Encountered {{ctx.payload.hits.total}} errors in the last 5 minutes", 
          "description" : "Encountered {{ctx.payload.hits.total}} errors in the last 5 minutes (facepalm)", 
          "labels" : ["auto"], 
          "priority" : {
            "name" : "High" 
          }
      }
    }
  }
}

	Имя учетной записи Jira, настроенной в `elasticsearch.yml`.
	Ключ проекта Jira, в котором будет создана задача.
	Имя типа задачи.
	Краткое описание задачи Jira.
	Описание задачи Jira.
	Теги для применения к задаче Jira.
	Приоритет задачи Jira.

Атрибуты действия для Jira

В зависимости от конфигурации проектов Jira, задачи могут иметь множество различных полей и значений. Поэтому действие jira может принимать любые типы вложенных полей в поле issue. Эти поля будут непосредственно использоваться при вызове API Jira Create Issue, что позволяет использовать любые типы пользовательских полей.

Поля project.key (или project.id), issuetype.name (или issuetype.id) и issue.summary всегда требуются для создания задачи в Jira.

Имя	Обязательно	Описание
`account`	нет	Учетная запись Jira для отправки сообщения.
`proxy.host`	нет	Хост прокси (только в сочетании с `proxy.port`)
`proxy.port`	нет	Порт прокси (только в сочетании с `proxy.host`)
`fields.project.key`	да	Ключ проекта Jira, в котором будет создана задача. Может быть заменён на `issue.project.id`, если идентификатор проекта известен.
`fields.issuetype.name`	да	Имя, идентифицирующее тип задачи. Jira предоставляет типы задач по умолчанию, такие как `Bug`, `Task`, `Story`, `New Feature` и др. Может быть заменён на `issue.issuetype.id`, если идентификатор типа известен.
`fields.summary`	да	Краткое описание (или заголовок) задачи.
`fields.description`	нет	Описание задачи.
`fields.labels`	нет	Теги для применения к задаче Jira.
`fields.priority.name`	нет	Приоритет задачи Jira. Jira предоставляет уровни приоритета по умолчанию, такие как `High`, `Medium` и `Low`.
`fields.assignee.name`	нет	Имя пользователя, которому должна быть назначена задача.
`fields.reporter.name`	нет	Имя пользователя, указанного как репортер задачи. По умолчанию используется учетная запись пользователя.
`fields.environment`	нет	Имя среды, связанной с задачей.
`fields.customfield_XXX`	нет	Пользовательское поле XXX задачи (например: "customfield_10000": "09/Jun/81")

Настройка учетных записей Jira

Учетные записи, которые Watcher может использовать для связи с Jira, настраиваются в пространстве имен xpack.notification.jira в elasticsearch.yml.

Watcher поддерживает базовый аутентификацию для Jira Software. Для настройки учетной записи Jira необходимо указать (см. настройки безопасности):

bin/elasticsearch-keystore add xpack.notification.jira.account.monitoring.secure_url
bin/elasticsearch-keystore add xpack.notification.jira.account.monitoring.secure_user
bin/elasticsearch-keystore add xpack.notification.jira.account.monitoring.secure_password

Хранение конфиденциальных данных (url, user и password) в файле конфигурации или настройках кластера небезопасно и устарело. Пожалуйста, используйте безопасный метод Elasticsearch с хранилищем ключей вместо этого.

Чтобы избежать передачи учетных данных в открытом виде по сети, Watcher отклонит настройки url, такие как http://internal-jira.elastic.co, основанные на простом текстовом протоколе HTTP. Это поведение по умолчанию можно отключить с помощью явного параметра allow_http:

Поле url также может содержать путь, используемый для создания задачи. По умолчанию это /rest/api/2/issue. Если вы также задаете этот путь, убедитесь, что он представляет собой полный путь к точке входа для создания задачи.

xpack.notification.jira:
  account:
    monitoring:
      allow_http: true

Настоятельно рекомендуется использовать только базовую аутентификацию с защищенным протоколом HTTPS.

Вы также можете указать значения по умолчанию для задач Jira:

xpack.notification.jira:
  account:
    monitoring:
      issue_defaults:
        project:
          key: proj
        issuetype:
          name: Bug
        summary: "X-Pack Issue"
        labels: ["auto"]

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

xpack.notification.jira:
  default_account: team1
  account:
    team1:
      ...
    team2:
      ...

© 2023-2025 Elasticsearch
As of September 2024, Elasticsearch is available under a choice of three licenses: the Server Side Public License (SSPL), the Elastic License, or the AGPLv3 (OSI approved).
Elasticsearch and the Elasticsearch logo are trademarks of Elasticsearch B.V., registered in the U.S. and in other countries.
https://www.elastic.co/guide/en/elasticsearch/reference/8.17/actions-jira.html