菜单
文档breadcrumb arrow Grafana 文档breadcrumb arrow 警报breadcrumb arrow 配置通知breadcrumb arrow 配置联系点breadcrumb arrow Jira
Grafana Cloud Enterprise Open source

配置 Jira 以进行警报

在联系点中使用 Jira 集成，以便在警报触发时在您的 Jira 实例中创建问题。此集成支持 Jira Cloud 和 Jira Server/Data Center 安装。

开始之前

开始之前，请确保您具备以下条件：

  • Jira 实例（Cloud、Server 或 Data Center）
  • Jira API 访问凭据
  • 在目标 Jira 项目中创建问题的适当权限

为联系点配置 Jira

要创建包含 Jira 集成的联系点，请完成以下步骤：

  1. 导航到 Alerts & IRM -> Alerting -> Contact points。
  2. 点击 + Add contact point。
  3. 输入联系点名称。
  4. 从Integration 列表，选择 Jira。
  5. 设置您的 Jira 配置所需的设置。
  6. 点击 Save contact point。

有关联系点的更多详细信息，包括如何测试联系点和启用通知，请参阅配置联系点。

必需设置

键描述
URL您的 Jira 实例的 REST API URL。支持的版本：2 和 3（例如，https://your-domain.atlassian.net/rest/api/3）。
基本认证用户名用于身份验证的用户名。对于 Jira Cloud，使用您的电子邮件地址。
基本认证密码密码或个人令牌。对于 Jira Cloud，您需要在此处获取个人令牌，并将其用作密码。
API Token作为基本认证的替代方案，使用 Bearer Token 对 API 请求进行授权。有关更多信息，请参阅Jira 文档。
Project Key标识创建问题的项目的 Project Key。项目键是项目的唯一标识符。
Issue Type要创建的问题类型（例如，任务、错误、事件）。确保您指定的类型在您的项目中可用。

可选设置

键描述
标题问题标题。支持模板。最大长度为 255 个字符。
描述问题描述。根据 API 版本，可以是文本、Markdown 或 JSON（仅限 v3 API）。字段最大大小为 32kb。
注意： JSON 不受客户端限制，如果超出大小，API 很可能会拒绝请求。
标签可以添加自定义标签来组织和过滤在 Jira 中创建的问题。支持模板，允许根据警报数据动态生成标签。
优先级问题的优先级级别（例如，低、中、高、关键）。
确保优先级值与您的 Jira 实例中可用的选项匹配。您可以在此处自定义 Jira 中的优先级级别。
解决转换当警报解决时，将问题转换为已解决状态的转换名称。确保该值与您 Jira 工作流中为指定问题类型提供的有效转换匹配。如果此字段为空，则问题将不会转换为“完成”状态。
重新打开转换当警报再次发生时，将问题恢复到开放状态的转换名称。确保该值与您 Jira 工作流中为指定问题类型提供的有效转换匹配。如果此字段为空，则问题将不会被重新打开。
重新打开持续时间时间持续时间（分钟），用于控制是否重新打开在此持续时间关闭的问题或创建新问题。如果未指定，将更新并重新打开与去重键匹配的最新问题（如果指定了重新打开转换）。
忽略的解决状态指定在搜索现有问题时应忽略的解决状态。例如，具有此解决状态的问题将不会被后续警报重新打开或更新。
去重键字段用于存储去重键的自定义字段。必须是文本字段。
如果未指定，去重键将以 ALERT(hash sum) 格式添加到标签中。有关如何创建自定义字段的信息，请参阅Jira 文档。
字段允许配置 Jira 问题的自定义字段。字段名称应采用 customfield_10001 格式。