安装Kapacitor

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

要求

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

网络

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

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

安装

Kapacitor 有两个二进制文件：

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

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

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

启动Kapacitor服务

对于打包安装，请参见您操作系统的相关部分。对于非打包安装（压缩包或源代码），您需要通过运行以下命令手动启动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 的共享密钥，集成将失败，Kapacitor 将无法启动。

时区

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

系统守护进程

使用 systemctl edit kapacitor 添加环境变量：

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

容器技术

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