创建 InfluxDB 和 Kapacitor 连接

可以通过 Chronograf 用户界面 (UI) 或使用 JSON 配置文件来配置与 InfluxDB 和 Kapacitor 的连接

• 使用 Chronograf UI 管理 InfluxDB 连接
• 使用 .src 文件管理 InfluxDB 连接
• 使用 Chronograf UI 管理 Kapacitor 连接
• 使用 .kap 文件管理 Kapacitor 连接

使用 Chronograf UI 管理 InfluxDB 连接

要在 Chronograf UI 中创建 InfluxDB 连接

1. 打开 Chronograf，然后在导航菜单中单击Configuration（扳手图标）。

2. 单击Add Connection。

   

3. 提供必要的连接凭据。

   InfluxDB 1.x InfluxDB Cloud 或 OSS 2.x

   

   • 连接 URL：InfluxDB 1.x 实例的主机名或 IP 地址和端口
   • 连接名称：此连接的唯一名称。
   • 用户名：InfluxDB 1.x 用户名 *（仅当 InfluxDB 中[启用授权](/influxdb/v1/administration/authentication_and_authorization/)时才需要）*
   • 密码：InfluxDB 密码 *（仅当 InfluxDB 中[启用授权](/influxdb/v1/administration/authentication_and_authorization/)时才需要）*
   • Telegraf 数据库名称：Chronograf 用于填充应用程序部分内容的数据库，包括“主机列表”页面（默认为 `telegraf`）
   • 默认保留策略：默认[保留策略](/influxdb/v1/concepts/glossary/#retention-policy-rp)（如果留空，则默认为 `autogen`）
   • 默认连接：将此连接用作数据探索、仪表盘和管理操作的默认连接

   

   • 启用 InfluxDB v2 Auth 选项

   • 连接 URL：[InfluxDB Cloud 区域 URL](/influxdb/cloud/reference/regions/) 或 [InfluxDB OSS 2.x URL](/influxdb/v2/reference/urls/)

     https://127.0.0.1:8086
     

   • 连接名称：此连接的唯一名称。

   • 组织：InfluxDB [组织](/influxdb/v2/admin/organizations/)

   • 令牌：InfluxDB [身份验证令牌](/influxdb/v2/admin/tokens/)

   • Telegraf 数据库名称： Chronograf 用于填充应用程序部分内容的 InfluxDB [存储桶](/influxdb/v2/admin/buckets/)，包括“主机列表”页面（默认为 `telegraf`）

   • 默认保留策略： 默认[保留策略](/influxdb/v1/concepts/glossary/#retention-policy-rp) *（留空）*

   • 默认连接：将此连接用作数据探索和仪表盘的默认连接

   有关将 Chronograf 连接到 InfluxDB Cloud 或 OSS 2.x 实例的更多信息，请参阅

   • 将 Chronograf 与 InfluxDB Cloud 一起使用
   • 将 Chronograf 与 InfluxDB OSS 2.x 一起使用

4. 单击 **Add Connection**

   • 如果连接有效，“仪表盘”窗口将出现，允许您导入仪表盘模板，您可以使用这些模板来显示和分析您的数据。有关详细信息，请参阅[创建仪表盘](/chronograf/v1/guides/create-a-dashboard)。
   • 如果无法创建连接，则会出现以下错误消息：“无法创建源：连接源时出错。” 如果发生这种情况，请确保所有连接凭据正确，并且 InfluxDB 实例正在运行且可访问。

以下仪表盘可用

• Docker
• Kubernetes Node
• Riak
• Consul
• Kubernetes Overview
• Mesos
• IIS
• RabbitMQ
• System
• VMware vSphere Overview
• Apache
• Elastisearch
• InfluxDB
• Memcached
• NSQ
• PostgreSQL
• Consul Telemetry
• HAProxy
• Kubernetes Pod
• NGINX
• Redis
• VMware vSphere VMs
• VMware vSphere Hosts
• PHPfpm
• Win System
• MySQL
• Ping

使用 .src 文件管理 InfluxDB 连接

手动创建 `.src` 文件以存储 InfluxDB 连接详细信息。`.src` 文件是简单的 JSON 文件，其中包含键值对连接详细信息。`.src` 文件的位置由 `--resources-path` 命令行选项定义，默认情况下，该选项与 `--canned-path` 相同。一个 `.src` 文件包含单个 InfluxDB 连接的详细信息。

创建一个名为 `example.src` 的新文件（文件名是任意的），并将其放在 Chronograf 的 `resource-path` 中。所有 `.src` 文件应包含以下内容

{
  "id": "10000",
  "name": "My InfluxDB",
  "username": "test",
  "password": "test",
  "url": "https://127.0.0.1:8086",
  "type": "influx",
  "insecureSkipVerify": false,
  "default": true,
  "telegraf": "telegraf",
  "organization": "example_org"
}

id

一个唯一的、字符串化的非负整数。建议使用 4 位或 5 位数字，以避免干扰现有的数据源 ID。

name

您想要用作数据源显示名称的任何字符串。

username

用于访问 InfluxDB 服务器或集群的用户名。仅当您要连接的 InfluxDB 实例上[启用授权](/influxdb/v1/administration/authentication_and_authorization/)时才需要。

password

用于访问 InfluxDB 服务器或集群的密码。仅当您要连接的 InfluxDB 实例上[启用授权](/influxdb/v1/administration/authentication_and_authorization/)时才需要。

url

InfluxDB 服务器或集群的 URL。

type

定义您要连接的 InfluxDB 的类型或发行版。以下是可用选项

insecureSkipVerify

跳过 SSL 证书验证过程。如果您在 InfluxDB 服务器或集群上使用自签名 SSL 证书，请设置为 true。

default

如果您希望将此连接用作首次登录时使用的默认数据连接，请设置为 true。

telegraf

InfluxDB 服务器或集群上的 Telegraf 数据库的名称。

organization

您希望数据源关联到的组织的 ID。

`.src` 文件中的环境变量

`.src` 文件支持使用环境变量来填充 InfluxDB 连接详细信息。可以使用 {{ .VARIABLE_KEY }} 语法加载环境变量。

{
  "id": "10000",
  "name": "My InfluxDB",
  "username": "{{ .INFLUXDB_USER }}",
  "password": "{{ .INFLUXDB_PASS }}",
  "url": "{{ .INFLUXDB_URL }}",
  "type": "influx",
  "insecureSkipVerify": false,
  "default": true,
  "telegraf": "telegraf",
  "organization": "example_org"
}

使用 Chronograf UI 管理 Kapacitor 连接

Kapacitor 是 TICK Stack 的数据处理组件。要在 Chronograf 中使用 Kapacitor，请创建 Kapacitor 连接并配置告警端点。要使用 Chronograf UI 创建 Kapacitor 连接

1. 打开 Chronograf，然后在导航菜单中单击Configuration（扳手图标）。

2. 在现有 [InfluxDB 连接](#manage-influxdb-connections-using-the-chronograf-ui) 旁边，如果不存在 Kapacitor 连接，请单击 **Add Kapacitor Connection**，或者在 **Kapacitor Connection** 下拉列表中选择 **Add Kapacitor Connection**。

3. 在 **Connection Details** 部分中，输入以下字段的值

   
   • Kapacitor URL：输入 Kapacitor 实例的主机名或 IP 地址和端口。该字段预填充了 `https://127.0.0.1:9092`。
   • 名称：输入此连接的名称。
   • 用户名：输入将为此连接共享的用户名。*仅当您连接的 Kapacitor 实例或集群上[启用授权](/kapacitor/v1/administration/security/#kapacitor-authentication-and-authorization)时才需要。*
   • 密码：输入密码。*仅当您连接的 Kapacitor 实例或集群上[启用授权](/kapacitor/v1/administration/security/#kapacitor-authentication-and-authorization)时才需要。*

4. 单击 **Continue**。如果连接有效，则会显示消息“Kapacitor Created! Configuring endpoints is optional.”。要配置告警端点，请参阅[配置告警端点](/chronograf/v1/guides/configuring-alert-endpoints/)。

使用 .kap 文件管理 Kapacitor 连接

手动创建 `.kap` 文件以存储 Kapacitor 连接详细信息。`.kap` 文件是简单的 JSON 文件，其中包含键值对连接详细信息。`.kap` 文件的位置由 `--resources-path` 命令行选项定义，默认情况下，该选项与 `--canned-path` 相同。一个 `.kap` 文件包含单个 Kapacitor 连接的详细信息。

创建一个名为 `example.kap` 的新文件（文件名是任意的），并将其放在 Chronograf 的 `resource-path` 中。所有 `.kap` 文件应包含以下内容

{
  "id": "10000",
  "srcID": "10000",
  "name": "My Kapacitor",
  "url": "https://127.0.0.1:9092",
  "active": true,
  "organization": "example_org"
}

id

一个唯一的、字符串化的非负整数。建议使用 4 位或 5 位数字，以避免干扰现有的数据源 ID。

srcID

与 Kapacitor 服务关联的 InfluxDB 服务器或集群的唯一、字符串化的非负整数 id。

name

您想要用作 Kapacitor 连接的显示名称的任何字符串。

url

Kapacitor 服务器的 URL。

active

如果为 true，则指定这是在 Chronograf 中显示 Kapacitor 相关信息时应使用的 Kapacitor 连接。

organization

您希望 Kapacitor 连接关联到的组织的 ID。

`.kap` 文件中的环境变量

`.kap` 文件支持使用环境变量来填充 Kapacitor 连接详细信息。可以使用 {{ .VARIABLE_KEY }} 语法加载环境变量。

{
  "id": "10000",
  "srcID": "10000",
  "name": "My Kapacitor",
  "url": "{{ .KAPACITOR_URL }}",
  "active": true,
  "organization": "example_org"
}