TL;DR InfluxDB 技术提示 - 如何设置 Kapacitor 和 Chronograf 以发送警报消息到 HipChat

作者：Regan Kuchan / 产品, 开发者
2017 年 2 月 23 日

导航至

在这篇帖子中，我们描述了如何设置 Chronograf 和 Kapacitor 以发送警报消息到 HipChat。下周请关注来自 GitHub、IRC 和 InfluxDB Google Group 中您可能错过的最有趣的 InfluxDB 和 TICK-stack 相关问题、解决方法、操作指南和问答。

HipChat 与 Kapacitor 的设置

HipChat 是 Atlassian 提供的用于群组聊天、视频聊天和屏幕共享的 Web 服务。Kapacitor 是 InfluxData 的开源数据处理框架，允许您配置警报消息并将其发送到事件处理程序（如 HipChat！）。

要求

要将 Kapacitor 警报消息发送到 HipChat，您需要：

HipChat 子域名名称

在 HipChat URL 中识别您的子域名名称：https://<您的子域名>.hipchat.com/home。

HipChat 房间名称

在 Web 应用程序中，创建一个新房间或在左侧边栏的 ROOM 部分下识别目标房间。

用于发送通知的 HipChat API 访问令牌

以下步骤描述了如何创建 API 访问令牌。

1. 从 HipChat 主页 (https://<您的子域名>.hipchat.com/home) 访问 Account settings，方法是单击右上角的人员图标。

2. 从左侧菜单边栏的项目中选择 API access。

3. 在 Create new token 下，输入令牌的标签（可以是任何内容）。

4. 在 Create new token 下，选择 Send Notification 作为范围。

5. 单击 Create。您的令牌将显示在 Create new token 部分正上方的表格中。

Kapacitor 配置

在 Kapacitor 配置文件 (/etc/kapacitor/kapacitor.conf) 的 [hipchat] 部分中，将 enabled 设置设置为 true，并在 url 设置中将 subdomain 设置为您的 HipChat 子域名。还有其他配置设置，但它们是可选的。

示例配置文件

[hipchat]
  enabled = true
  url = "https://<your-subdomain>.hipchat.com/v2/room"

Kapacitor TICKscript

在您的 Kapacitor TICKscript 的 |alert() 部分中，包含 .hipChat() 属性，将 .room('<您的 HipChat 房间>') 属性设置为您的 HipChat 房间，并将 .token('<您的 HipChat 房间>') 设置为您的 API 访问令牌。

示例 TICKscript

stream
    |from()
        .measurement('cpu')
    |alert()
        .crit(lambda: "usage_idle" <  10)
        .message('')
        .hipChat() ?
        .room('<your-hipchat-room>') ?
 .token('<your-api-access-token>') ?

接下来，定义并启用您的 Kapacitor 任务，并密切关注您的 HipChat 房间。就是这样！

HipChat 与 Chronograf 的设置

Chronograf 提供了一个用户界面，用于与 Kapacitor 协同工作，以轻松创建警报规则并将警报消息发送到事件处理程序。

要求

Kapacitor 实例

查看 Chronograf 的安装指南，了解如何安装和将 Kapacitor 连接到 Chronograf。

HipChat 信息
  • 子域名名称
  • 房间名称
  • API 访问令牌

请参阅 HipChat 与 Kapacitor 的设置部分中的要求列表，了解如何从 HipChat 获取该信息。

Chronograf/Kapacitor 配置

1. 访问您的 Chronograf 应用程序中的 Kapacitor 配置页面。

2. 在 Configure Alert Endpoints 部分中，从下拉菜单中选择 HipChat。

3. 将 HipChat URL 输入中的 subdomain 更改为您的 HipChat 子域名。

4. 在 Room 输入中输入您的 HipChat 房间。

5. 在 Token 输入中输入您的 HipChat API 访问令牌。

6. 单击 Save 按钮。

Hipchat setup

规则配置

在 Chronograf 的 Kapacitor Rules 页面上创建或编辑规则时，在屏幕底部的下拉菜单中选择 hipchat。Kapacitor 会将与该规则关联的所有警报消息发送到您配置的 HipChat 房间。

Hipchat setup - alert message

下一步是什么

  • 下载TICK-stack 的下载已在我们的“下载”页面上线。
  • 云端部署：开始免费试用 InfluxDB Cloud，它具有完全托管的集群、Kapacitor 和 Grafana。
  • 在您的服务器上部署：想在您的服务器上运行 InfluxDB 集群？免费试用 14 天的 InfluxDB Enterprise，它具有用于部署、监控和重新平衡集群的直观 UI，以及管理备份和恢复的功能。
  • 讲述您的故事：超过 300 家公司分享了 InfluxDB 如何帮助他们取得成功的故事。提交您的客户评价，即可获赠限量版连帽衫，以表感谢。