安装 Kapacitor

本页提供安装、启动和配置 Kapacitor 的指南。

要求

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

网络

Kapacitor 监听 TCP 端口 9092 以处理所有 API 和写入调用。

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

安装

Kapacitor 有两个二进制文件

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

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

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

启动 Kapacitor 服务

对于软件包安装，请参阅下面针对您操作系统的相应部分。对于非软件包安装（tarball 或来自源代码），您需要通过运行以下命令手动启动 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 的共享密钥不匹配，则与 InfluxDB 的集成将失败，并且 Kapacitor 将不会启动。

时区

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

systemd

使用 systemctl edit kapacitor 添加环境变量

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

docker

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