配置 Chronograf 警报端点
Chronograf 警报端点可以使用 Chronograf 用户界面进行配置,以创建基于 Kapacitor 的事件处理程序,发送警报消息。您可以使用 Chronograf 将警报消息发送到特定的 URL 以及应用程序。
本指南提供了配置Chronograf警报端点的逐步说明。
Chronograf中支持的Kapacitor事件处理程序
Chronograf 与 Kapacitor 集成,这是 InfluxData 的数据处理平台,用于将警报消息发送到事件处理程序。Chronograf 支持以下事件处理程序:
要在Chronograf中配置Kapacitor事件处理程序, 安装Kapacitor 并 将其连接到Chronograf。 配置Kapacitor页面包含事件处理程序的配置选项。
警报端点配置
警报端点配置出现在Chronograf配置Kapacitor页面。 您必须连接Kapacitor实例才能访问配置。 有关更多信息,请参见 Kapacitor安装说明 和如何 将Kapacitor实例连接 到Chronograf。
请注意,配置警报端点部分中的配置选项并不是全部包括的。 一些事件处理程序允许用户为每个警报规则自定义事件处理程序配置。 例如,Chronograf的Slack集成允许用户在配置警报端点部分指定一个默认频道,并为单独的警报规则指定一个不同的频道。
警报
要配置一个Alerta警报端点:
在配置警报端点的配置Kapacitor连接页面上,点击Alerta选项卡。
输入以下内容:
- 环境: Alerta 环境。可以是一个模板,并且可以访问与 AlertNode.Details 属性相同的数据。默认值从配置中设置。
- 来源: Alerta来源。如果为空,则使用配置中的来源。
- Token: 默认的Alerta认证令牌。
- 令牌前缀: 默认令牌前缀。如果您收到无效令牌错误,您可能需要将其更改为“Key”。
- 用户: 警报用户。
- 配置启用: 勾选以启用配置。
点击 保存更改 以保存配置设置。
点击 发送测试警报 以验证配置。
大熊猫
要配置一个 BigPanda 警报端点:
在配置警报端点的配置Kapacitor连接页面中,点击BigPanda选项卡。
输入以下内容:
- URL: BigPanda alerts API URL.
默认是https://api.bigpanda.io/data/v2/alerts。 - Token: BigPanda API 授权令牌 (API 密钥).
- 应用程序密钥: BigPanda App Key.
- 不安全的跳过验证: 如果使用自签名的TLS证书,则需要此项。选择在通过HTTPS连接时跳过TLS证书链和主机验证。
- 配置启用: 选择以启用配置。
- URL: BigPanda alerts API URL.
点击 保存更改 以保存配置设置。
点击 发送测试警报 以验证配置。
卡夫卡
要配置Kafka警报端点:
在配置警报端点的配置Kapacitor连接页面中,点击Kafka选项卡。
输入以下内容:
- ID: Kafka 集群的唯一标识符。默认值为
localhost。 - 代理: Kafka代理地址的列表,使用
host:port格式。 - 超时: 在刷新不完整批次之前最大等待时间。默认值是
10s。 - 批大小: 发送到Kafka之前批处理的消息数量。默认值为
100。 - 批处理超时: 批处理的超时时间。默认是
1s。 - 使用SSL: 选择以启用SSL通信。
- SSL CA: SSL CA(证书授权机构)文件的路径。
- SSL证书: SSL主机证书的路径。
- SSL密钥: SSL证书私钥文件的路径。
- 不安全的跳过验证: 如果使用自签名的TLS证书,则需要此项。选择在通过HTTPS连接时跳过TLS证书链和主机验证。
- 配置启用: 勾选以启用配置。
- ID: Kafka 集群的唯一标识符。默认值为
点击 保存更改 以保存配置设置。
点击 发送测试警报 以验证配置。
要使用TICKscript启用Kafka服务,请参阅 Kafka事件处理程序(Kapacitor)。
OpsGenie
注意: OpsGenie 事件 API 1.0 的支持已经不再推荐使用(如OpGenie所述)。 截至2018年6月30日,OpsGenine 事件 API 1.0 已被禁用。 请使用OpsGenie2警报端点。
OpsGenie2
使用Chronograf警报端点向OpsGenie团队和收件人发送事故警报。
要配置OpsGenie告警端点:
在配置警报端点的配置Kapacitor连接页面中,点击OpsGenie标签。
输入以下信息:
- API 密钥: API 密钥(或 GenieKey)。 要找到 API 密钥,请登录到您的 OpsGenie 账户 并在 Admin 菜单中选择 设置 菜单选项。
- 团队: 要被提醒的OpsGenie团队列表。
- 接收者 接收警报的 OpsGenie团队成员 的列表。
- 选择恢复操作: 在警报恢复时采取的措施:
- 向警报添加备注
- 关闭警报
- 配置启用: 选择以启用配置。
点击 保存更改 以保存配置设置。
点击 发送测试警报 以验证配置。
有关 OpsGenie 警报 API 的详细信息,请参见 Alert API 在 OpsGenie 文档中的内容
有关OpsGenie V2事件处理程序的详细信息,请参见OpsGenie V2 event handler在Kapacitor文档中的内容。
有关使用TICKscripts启用OpsGenie服务的详细信息,请参阅AlertNode (Kapacitor TICKscript node) - OpsGenie v2的Kapacitor文档。
值班工具
原始的 PagerDuty 警报端点已被弃用。 使用 PagerDuty2 警报端点。
PagerDuty2
配置一个PagerDuty警报端点:
在配置警报端点的配置Kapacitor连接页面中,点击PagerDuty选项卡。
输入以下内容:
- 路由键: 您的 PagerDuty 事件 API V2 集成的 GUID,在事件 API V2 集成的详细页面上列为“集成键”。请参阅创建新服务中关于获取“集成键”的 PagerDuty 文档详细信息 (
routing_key)。 - PagerDuty URL: 用于POST表示事件的JSON主体的URL。此值不应更改。有效值为
https://events.pagerduty.com/v2/enqueue。 - 配置已启用: 选择以启用此配置。
- 路由键: 您的 PagerDuty 事件 API V2 集成的 GUID,在事件 API V2 集成的详细页面上列为“集成键”。请参阅创建新服务中关于获取“集成键”的 PagerDuty 文档详细信息 (
点击 保存更改 以保存配置设置。
点击 发送测试警报 以验证配置。
有关 PagerDuty 事件 API 和已识别事件类型的详细信息,请参阅 PagerDuty Events API V2 Overview(trigger、acknowledge 和 resolve)。
要使用TICKscript启用新的“通用API”服务,请参见 AlertNode (Kapacitor TICKscript node) - PagerDuty v2。
推送通知
配置 Pushover 警报终端:
在配置警报端点的配置Kapacitor连接页面中,点击Pushover标签。
输入以下内容:
- 用户密钥: Pushover USER_TOKEN.
- 令牌: Pushover API 令牌。
- Pushover URL: Pushover API URL.
默认是
https://api.pushover.net/1/messages.json。 - 配置启用: 勾选以启用配置。
点击 保存更改 以保存配置设置。
点击 发送测试警报 以验证配置。
Sensu
要配置一个 Sensu 警报端点:
在配置警报端点的配置Kapacitor连接页面中,点击Sensu标签。
输入以下内容:
- 来源: 事件源。默认是
Kapacitor。 - 地址: Sensu HTTP API的URL。
- 配置启用: 选择以启用配置。
- 来源: 事件源。默认是
点击 保存更改 以保存配置设置。
点击 发送测试警报 以验证配置。
服务现在
要配置ServiceNow警报端点:
在配置警报端点的配置Kapacitor连接页面中,点击ServiceNow选项卡。
输入以下内容:
- URL: ServiceNow API URL. 默认是
https://instance.service-now.com/api/global/em/jsonv2。 - 来源: 事件源。
- 用户名: ServiceNow 用户名。
- 密码: ServiceNow 密码。
- 配置启用: 选择以启用配置。
- URL: ServiceNow API URL. 默认是
点击 保存更改 以保存配置设置。
点击 发送测试警报 以验证配置。
Slack
配置 Slack 警报端点:
在配置警报端点的配置Kapacitor连接页面中,点击Slack标签。
输入以下内容:
- 为此配置命名: 如果您有多个 Slack 警报终端,唯一的名称用于 Slack 终端。
- Slack WebHook URL: (可选) Slack webhook URL (见 Slack webhooks)
- Slack频道: (可选) 要发送消息的Slack频道或用户。
以
#开头以发送到频道。 以@开头以直接发送给用户。 如果未指定,Kapacitor会将警报消息发送到在 警报规则 中指定的频道或用户或在 Slack Webhook 中配置的频道或用户。 - 配置启用: 勾选以启用配置。
点击 保存更改 以保存配置设置。
点击 发送测试警报 以验证配置。
要添加另一个Slack配置:
- 在配置警报端点的配置Kapacitor连接页面中,点击Slack标签。
- 点击 添加另一个配置.
- 完成步骤2-4 above。
简单邮件传输协议
要配置SMTP警报端点:
在配置警报端点的配置Kapacitor连接页面中,点击SMTP标签。
输入以下内容:
- SMTP 主机: SMTP 主机。默认为
localhost。 - SMTP 端口: SMTP 端口。默认是
25。 - 发件邮箱: 发送邮件的邮箱地址。
- 发送至邮件: 发送消息的电子邮件地址。
- 用户: SMTP 用户名。
- 密码: SMTP 密码。
- 配置启用: 选择以启用配置。
- SMTP 主机: SMTP 主机。默认为
点击 保存更改 以保存配置设置。
点击 发送测试警报 以验证配置。
谈话
要配置一个Talk警报端点:
在配置警报端点的配置Kapacitor连接页面中,点击谈话选项卡。
输入以下内容:
- URL: 交谈 API URL。
- 作者姓名: 消息作者姓名。
- 配置启用: 选择以启用配置。
点击 保存更改 以保存配置设置。
点击 发送测试警报 以验证配置。
团队
要配置微软Teams警报端点:
在配置警报端点的配置Kapacitor连接页面中,点击团队选项卡。
输入以下内容:
- 频道 URL: Microsoft Teams 频道 URL。
- 配置启用: 选择以启用配置。
点击 保存更改 以保存配置设置。
点击 发送测试警报 以验证配置。
电报
要配置Telegram警报端点:
在配置警报端点的配置Kapacitor连接页面中,点击Telegram选项卡。
输入以下内容:
- 令牌:
- 聊天 ID:
- 选择警报消息格式: Telegram 消息格式
- Markdown (默认)
- HTML
- 禁用链接预览: 在Telegram消息中禁用链接预览。
- 禁用通知: 禁用iOS设备上的通知和Android设备上的声音。Android用户将继续接收通知。
- 配置启用: 选择以启用配置。
维克托操作
配置VictorOps警报端点:
在配置警报端点的配置Kapacitor连接页面中,点击VictorOps选项卡。
输入以下内容:
- API 密钥: VictorOps API 密钥。
- 路由关键字: VictorOps routing key.
- VictorOps URL: VictorOps警报API URL。 默认是
https://alert.victorops.com/integrations/generic/20131114/alert。 - 配置启用: 选择以启用配置。
点击 保存更改 以保存配置设置。
点击 发送测试警报 以验证配置。
Zenoss
要配置一个 Zenoss 警报端点:
在配置警报端点的配置Kapacitor连接页面中,点击Zenoss标签。
输入以下内容:
- URL: Zenoss 路由器端点 URL.
默认是
https://tenant.zenoss.io:8080/zport/dmd/evconsole_router. - 用户名: Zenoss 用户名。留空表示不进行身份验证。
- 密码: Zenoss 密码。留空以不进行身份验证。
- 操作(路由器名称): Zenoss router name.
默认值是
EventsRouter. - 路由方法: EventsRouter method.
默认是
add_event. - 事件类型: 事件类型。默认是
rpc。 - 事件 TID: 临时请求事务 ID。默认值为
1。 - 收集器名称: Zenoss 收集器名称。默认值是
Kapacitor。 - Kapacitor 与 Zenoss 严重性映射: 将 Kapacitor 严重性映射到 Zenoss 严重性.
- OK: 清除 (默认)
- Info: 信息 (默认)
- Warning: 警告 (默认)
- Critical: 告警 (默认)
- 配置启用: 选择以启用配置。
- URL: Zenoss 路由器端点 URL.
默认是
点击 保存更改 以保存配置设置。
点击 发送测试警报 以验证配置。