配置 Chronograf 警报端点

可以使用 Chronograf 用户界面配置 Chronograf 警报端点，以创建基于 Kapacitor 的事件处理程序，这些处理程序发送警报消息。您可以使用 Chronograf 将警报消息发送到特定 URL 以及应用程序。

本指南提供有关配置 Chronograf 警报端点的分步说明。

Chronograf 中支持的 Kapacitor 事件处理程序

Chronograf 与 Kapacitor（InfluxData 的数据处理平台）集成，以将警报消息发送到事件处理程序。Chronograf 支持以下事件处理程序

• Alerta
• BigPanda
• Kafka
• OpsGenie
• OpsGenie2
• PagerDuty
• PagerDuty2
• Pushover
• Sensu
• ServiceNow
• Slack
• SMTP
• Talk
• Teams
• Telegram
• VictorOps
• Zenoss

要在 Chronograf 中配置 Kapacitor 事件处理程序，请安装 Kapacitor 并将其连接到 Chronograf。配置 Kapacitor 页面包含事件处理程序配置选项。

警报端点配置

警报端点配置显示在 Chronograf 的“配置 Kapacitor”页面上。您必须连接 Kapacitor 实例才能访问配置。有关更多信息，请参阅 Kapacitor 安装说明 以及如何将 Kapacitor 实例连接到 Chronograf。

请注意，配置警报端点部分中的配置选项并非包罗万象。某些事件处理程序允许用户为每个警报规则自定义事件处理程序配置。例如，Chronograf 的 Slack 集成允许用户在配置警报端点部分中指定默认频道，并为单独的警报规则指定不同的频道。

Alerta

要配置 Alerta 警报端点

1. 在配置 Kapacitor 连接页面的配置警报端点中，单击 Alerta 选项卡。

2. 输入以下内容

   • 环境：Alerta 环境。可以是模板，并且可以访问与 AlertNode.Details 属性相同的数据。默认值从配置中设置。
   • 来源：Alerta 来源。如果为空，则使用配置中的来源。
   • 令牌：默认 Alerta 身份验证令牌。
   • 令牌前缀：默认令牌前缀。如果您收到无效令牌错误，您可能需要将其更改为“Key”。
   • 用户：Alerta 用户。
   • 启用配置：选中以启用配置。

3. 单击保存更改以保存配置设置。

4. 单击发送测试警报以验证配置。

BigPanda

要配置 BigPanda 警报端点

1. 在配置 Kapacitor 连接页面的配置警报端点中，单击 BigPanda 选项卡。

2. 输入以下内容

   • URL：BigPanda 警报 API URL。默认为 https://api.bigpanda.io/data/v2/alerts。
   • 令牌：BigPanda API 授权令牌（API 密钥）。
   • 应用程序密钥：BigPanda 应用程序密钥。
   • 不安全跳过验证：如果使用自签名 TLS 证书，则为必需。选择此项可在通过 HTTPS 连接时跳过 TLS 证书链和主机验证。
   • 启用配置：选择此项以启用配置。

3. 单击保存更改以保存配置设置。

4. 单击发送测试警报以验证配置。

Kafka

要配置 Kafka 警报端点

1. 在配置 Kapacitor 连接页面的配置警报端点中，单击 Kafka 选项卡。

2. 输入以下内容

   • ID：Kafka 集群的唯一标识符。默认为 localhost。
   • Broker：Kafka broker 地址列表，使用 host:port 格式。
   • 超时：在刷新不完整的批处理之前等待的最长时间。默认为 10 秒。
   • 批处理大小：在发送到 Kafka 之前批处理的消息数。默认为 100。
   • 批处理超时：批处理的超时时间段。默认为 1 秒。
   • 使用 SSL：选择此项以启用 SSL 通信。
   • SSL CA：SSL CA（证书颁发机构）文件的路径。
   • SSL 证书：SSL 主机证书的路径。
   • SSL 密钥：SSL 证书私钥文件的路径。
   • 不安全跳过验证：如果使用自签名 TLS 证书，则为必需。选择此项可在通过 HTTPS 连接时跳过 TLS 证书链和主机验证。
   • 启用配置：选中以启用配置。

3. 单击保存更改以保存配置设置。

4. 单击发送测试警报以验证配置。

要使用 TICKscript 启用 Kafka 服务，请参阅 Kafka 事件处理程序 (Kapacitor)。

OpsGenie

OpsGenie2

使用 Chronograf 警报端点向 OpsGenie 团队和接收者发送事件警报。

要配置 OpsGenie 警报端点

1. 在配置 Kapacitor 连接页面的配置警报端点中，单击 OpsGenie 选项卡。

2. 输入以下信息

   • API 密钥：API 密钥（或 GenieKey）。要查找 API 密钥，请登录您的 OpsGenie 帐户，然后在管理菜单中选择设置菜单选项。
   • 团队：要发出警报的 OpsGenie 团队列表。
   • 接收者 OpsGenie 团队成员）列表，用于接收警报。
   • 选择恢复操作：警报恢复时要执行的操作
     • 向警报添加注释
     • 关闭警报
   • 启用配置：选择此项以启用配置。

3. 单击保存更改以保存配置设置。

4. 单击发送测试警报以验证配置。

有关 OpsGenie Alert API 的详细信息，请参阅 OpsGenie 文档中的 Alert API

有关 OpsGenie V2 事件处理程序的详细信息，请参阅 Kapacitor 文档中的 OpsGenie V2 事件处理程序。

有关使用 TICKscript 启用 OpsGenie 服务的详细信息，请参阅 Kapacitor 文档中的 AlertNode (Kapacitor TICKscript 节点) - OpsGenie v2。

PagerDuty

PagerDuty2

要配置 PagerDuty 警报端点

1. 在配置 Kapacitor 连接页面的配置警报端点中，单击 PagerDuty 选项卡。

2. 输入以下内容

   • 路由密钥：您的 PagerDuty Events API V2 集成的 GUID，在 Events API V2 集成的详细信息页面上列为“集成密钥”。有关获取“集成密钥”(routing_key) 的详细信息，请参阅 PagerDuty 文档中的 创建新服务。
   • PagerDuty URL：用于 POST 表示事件的 JSON 正文的 URL。此值不应更改。有效值为 https://events.pagerduty.com/v2/enqueue。
   • 启用配置：选择此项以启用此配置。

3. 单击保存更改以保存配置设置。

4. 单击发送测试警报以验证配置。

有关 PagerDuty Events API 以及已识别的事件类型（trigger、acknowledge 和 resolve）的详细信息，请参阅 PagerDuty Events API V2 概述。

要使用 TICKscript 启用新的“通用 API”服务，请参阅 AlertNode (Kapacitor TICKscript 节点) - PagerDuty v2。

Pushover

要配置 Pushover 警报端点

1. 在配置 Kapacitor 连接页面的配置警报端点中，单击 Pushover 选项卡。

2. 输入以下内容

   • 用户密钥：Pushover USER_TOKEN。
   • 令牌：Pushover API 令牌。
   • Pushover URL：Pushover API URL。默认为 https://api.pushover.net/1/messages.json。
   • 启用配置：选中以启用配置。

3. 单击保存更改以保存配置设置。

4. 单击发送测试警报以验证配置。

Sensu

要配置 Sensu 警报端点

1. 在配置 Kapacitor 连接页面的配置警报端点中，单击 Sensu 选项卡。

2. 输入以下内容

   • 来源：事件源。默认为 Kapacitor。
   • 地址：Sensu HTTP API 的 URL。
   • 启用配置：选择此项以启用配置。

3. 单击保存更改以保存配置设置。

4. 单击发送测试警报以验证配置。

ServiceNow

要配置 ServiceNow 警报端点

1. 在配置 Kapacitor 连接页面的配置警报端点中，单击 ServiceNow 选项卡。

2. 输入以下内容

   • URL：ServiceNow API URL。默认为 https://instance.service-now.com/api/global/em/jsonv2。
   • 来源：事件源。
   • 用户名：ServiceNow 用户名。
   • 密码：ServiceNow 密码。
   • 启用配置：选择此项以启用配置。

3. 单击保存更改以保存配置设置。

4. 单击发送测试警报以验证配置。

Slack

要配置 Slack 警报端点

1. 在配置 Kapacitor 连接页面的配置警报端点中，单击 Slack 选项卡。

2. 输入以下内容

   • 为此配置命名昵称：如果您有多个 Slack 警报端点，则为 Slack 端点指定唯一的名称。
   • Slack WebHook URL：（可选）Slack webhook URL （请参阅 Slack webhooks）
   • Slack 频道：（可选）要向其发送消息的 Slack 频道或用户。使用 # 前缀发送到频道。使用 @ 前缀直接发送给用户。如果未指定，Kapacitor 会将警报消息发送到警报规则中指定的频道或用户，或在 Slack Webhook 中配置的频道或用户。
   • 启用配置：选中以启用配置。

3. 单击保存更改以保存配置设置。

4. 单击发送测试警报以验证配置。

要添加另一个 Slack 配置

1. 在配置 Kapacitor 连接页面的配置警报端点中，单击 Slack 选项卡。
2. 单击 添加另一个配置。
3. 完成上述步骤 2-4。

SMTP

要配置 SMTP 警报端点

1. 在配置 Kapacitor 连接页面的配置警报端点中，单击 SMTP 选项卡。

2. 输入以下内容

   • SMTP 主机：SMTP 主机。默认为 localhost。
   • SMTP 端口：SMTP 端口。默认为 25。
   • 发件人电子邮件：用于发送消息的电子邮件地址。
   • 收件人电子邮件：用于接收消息的电子邮件地址。
   • 用户：SMTP 用户名。
   • 密码：SMTP 密码。
   • 启用配置：选择此项以启用配置。

3. 单击保存更改以保存配置设置。

4. 单击发送测试警报以验证配置。

Talk

要配置 Talk 警报端点

1. 在配置 Kapacitor 连接页面的配置警报端点中，单击 Talk 选项卡。

2. 输入以下内容

   • URL：Talk API URL。
   • 作者姓名：消息作者姓名。
   • 启用配置：选择此项以启用配置。

3. 单击保存更改以保存配置设置。

4. 单击发送测试警报以验证配置。

Teams

要配置 Microsoft Teams 警报端点

1. 在配置 Kapacitor 连接页面的配置警报端点中，单击 Teams 选项卡。

2. 输入以下内容

   • 频道 URL：Microsoft Teams 频道 URL。
   • 启用配置：选择此项以启用配置。

3. 单击保存更改以保存配置设置。

4. 单击发送测试警报以验证配置。

Telegram

要配置 Telegram 警报端点

1. 设置 Telegram 机器人和凭据.

2. 在配置 Kapacitor 连接页面的配置警报端点中，单击 Telegram 选项卡。

3. 输入以下内容

   • 令牌:
   • 聊天 ID:
   • 选择警报消息格式：Telegram 消息格式
     • Markdown （默认）
     • HTML
   • 禁用链接预览：禁用 Telegram 消息中的链接预览。
   • 禁用通知：禁用 iOS 设备上的通知和 Android 设备上的声音。Android 用户将继续收到通知。
   • 启用配置：选择此项以启用配置。

VictorOps

要配置 VictorOps 警报端点

1. 在配置 Kapacitor 连接页面的配置警报端点中，单击 VictorOps 选项卡。

2. 输入以下内容

   • API 密钥：VictorOps API 密钥。
   • 路由密钥：VictorOps 路由密钥。
   • VictorOps URL：VictorOps 警报 API URL。默认为 https://alert.victorops.com/integrations/generic/20131114/alert。
   • 启用配置：选择此项以启用配置。

3. 单击保存更改以保存配置设置。

4. 单击发送测试警报以验证配置。

Zenoss

要配置 Zenoss 警报端点

1. 在配置 Kapacitor 连接页面的配置警报端点中，单击 Zenoss 选项卡。

2. 输入以下内容

   • URL：Zenoss 路由器端点 URL。默认为 https://tenant.zenoss.io:8080/zport/dmd/evconsole_router。
   • 用户名：Zenoss 用户名。留空表示不进行身份验证。
   • 密码：Zenoss 密码。留空表示不进行身份验证。
   • 操作 (路由器名称)：Zenoss 路由器名称。默认为 EventsRouter。
   • 路由器方法：EventsRouter 方法。默认为 add_event。
   • 事件类型：事件类型。默认为 rpc。
   • 事件 TID：临时请求事务 ID。默认为 1。
   • 收集器名称：Zenoss 收集器名称。默认为 Kapacitor。
   • Kapacitor 到 Zenoss 严重性映射：将 Kapacitor 严重性映射到 Zenoss 严重性。
     • 正常：清除 （默认）
     • 信息：信息 （默认）
     • 警告：警告 （默认）
     • 严重：严重 （默认）
   • 启用配置：选择此项以启用配置。

3. 单击保存更改以保存配置设置。

4. 单击发送测试警报以验证配置。