配置 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 格式。
   • 超时：刷新未完成批处理之前的最长等待时间。 默认为 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 文档中的 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 启用新的“Generic 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 webhook）
   • 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. 单击“发送测试警报”以验证配置。