安装 Kapacitor

本页提供安装、启动和配置 Kapacitor 的说明。

要求

安装 InfluxDB 包可能需要 root 或管理员权限才能成功完成。

网络

Kapacitor 在 TCP 端口 9092 上监听所有 API 和写入调用。

Kapacitor 也可能绑定到随机的 UDP 端口，用于通过订阅处理 InfluxDB 数据。

安装

Kapacitor 有两个二进制文件

• kapacitor：一个用于调用 Kapacitor API 的 CLI 程序。
• kapacitord：Kapacitor 服务器守护进程。

您可以直接从 下载页面下载二进制文件。

注意：Windows 支持是实验性的。

启动 Kapacitor 服务

对于打包安装，请参阅下面您操作系统的相应部分。对于非打包安装（tarballs 或从源代码安装），您需要通过运行以下命令手动启动 Kapacitor 应用程序：

./kapacitord -config <PATH TO CONFIGURATION>

macOS（使用 Homebrew）

让 launchd 在登录时启动 Kapacitor

ln -sfv /usr/local/opt/kapacitor/*.plist ~/Library/LaunchAgents

然后立即加载 Kapacitor

launchctl load ~/Library/LaunchAgents/homebrew.mxcl.kapacitor.plist

或者，如果您不希望或不需要 launchctl，您可以直接运行

kapacitord -config /usr/local/etc/kapacitor.conf

Linux - SysV 或 Upstart 系统

要启动 Kapacitor 服务，请运行

sudo service kapacitor start

Linux - systemd 系统

要启动 Kapacitor 服务，请运行

sudo systemctl start kapacitor

配置

示例配置文件可以在 这里找到。

Kapacitor 还可以使用此命令为您提供一个示例配置

kapacitord config

要生成新的配置文件，请运行

kapacitord config > kapacitor.generated.conf

共享密钥

如果使用 Kapacitor v1.5.3 或更新版本以及启用了 身份验证的 InfluxDB，请将 Kapacitor 配置文件中的 [http].shared-secret 选项设置为您的 InfluxDB 实例的共享密钥。

# ...
[http]
  # ...
  shared-secret = "youramazingsharedsecret"

如果未设置、设置为空字符串或与 InfluxDB 的 shared-secret 不匹配，则与 InfluxDB 的集成将失败，Kapacitor 将不会启动。

时区

要使用首选时区显示警报通知，请更改 Kapacitor 运行所在主机的时区，或设置 Kapacitor 进程的 TZ 环境变量。

systemd

使用 systemctl edit kapacitor 添加环境变量

[Service]
Environment="TZ=Asia/Shanghai"

docker

在启动容器时使用 -e 标志（-e TZ=Asia/Shanghai）或在 docker-compose.yml 中设置环境变量。