配置 Chronograf 告警端点

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

本指南提供了配置 Chronograf 告警端点的分步说明。

Chronograf 支持的 Kapacitor 事件处理程序

Chronograf 与 InfluxData 的数据处理平台 Kapacitor 集成，以将告警消息发送到事件处理程序。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。
   • 代理：Kafka 代理地址列表，使用 host:port 格式。
   • 超时：在刷新不完整批次之前等待的最长时间。默认值为 10s。
   • 批次大小：发送到 Kafka 之前进行批处理的消息数。默认值为 100。
   • 批次超时：批次的超时期限。默认值为 1s。
   • 使用 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 文档中的告警 API。

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

有关使用 TICKscripts 启用 OpsGenie 服务的详细信息，请参阅 Kapacitor 文档中的告警节点（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”服务，请参阅 Kapacitor 文档中的告警节点（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 严重性。
     • OK：清除（默认）
     • Info：信息（默认）
     • 警告：警告（默认）
     • 严重：严重（默认）
   • 配置已启用：选择以启用配置。

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

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