安装 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

共享密钥 (Shared secret)

如果使用 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 中设置环境变量。