文档文档

手动配置 Telegraf

使用 Telegraf influxdb_v2 输出插件来收集指标并将指标写入 InfluxDB 2.7 Bucket。本文介绍如何在新的和现有的 Telegraf 配置中启用 influxdb_v2 输出插件,然后使用自定义配置文件启动 Telegraf。

查看将 Telegraf 与 InfluxDB 2.7 一起使用的要求

配置 Telegraf 输入和输出插件

在 Telegraf 配置文件(通常名为 telegraf.conf)中配置 Telegraf 输入和输出插件。输入插件收集指标。输出插件定义指标发送的目标位置。

请参阅 Telegraf 插件 以获取可用插件的完整列表。

手动添加 Telegraf 插件

要手动添加任何可用的 Telegraf 插件,请按照以下步骤操作。

  1. 从可用 Telegraf 插件 的完整列表中找到您要启用的插件。
  2. 单击插件名称右侧的 查看 以在 GitHub 上打开插件页面。例如,在此处查看 MQTT 插件 GitHub 页面 here
  3. 将示例配置复制并粘贴到您的 Telegraf 配置文件(通常名为 telegraf.conf)中。

启用和配置 InfluxDB v2 输出插件

要将数据发送到 InfluxDB 2.7 实例,请在 telegraf.conf 中启用 influxdb_v2 输出插件

在 UI 中查找示例 InfluxDB v2 输出插件配置

  1. 在左侧的导航菜单中,选择 数据 (加载数据) > Telegraf

  2. 单击 InfluxDB 输出插件

  3. 单击 复制到剪贴板 以复制示例配置,或单击 下载配置 以保存副本。

  4. 将示例配置粘贴到您的 telegraf.conf 中,并指定以下选项。

InfluxDB 输出插件配置包含以下选项

urls

您的 InfluxDB 2.7 实例的 URL 数组。有关要使用哪个 URL 的信息,请参阅 InfluxDB URLInfluxDB Cloud 需要 HTTPS

token

您的 InfluxDB 2.7 API 令牌。有关查看令牌的信息,请参阅 查看令牌

避免在 telegraf.conf 中存储令牌

我们建议通过设置 INFLUX_TOKEN 环境变量并在您的配置文件中包含该环境变量来存储您的令牌。

export INFLUX_TOKEN=YourAuthenticationToken
$env:INFLUX_TOKEN = "YourAuthenticationToken"
set INFLUX_TOKEN=YourAuthenticationToken
# Make sure to include a space character at the end of this command.

请参阅下面的 telegraf.conf 示例

organization

拥有目标 Bucket 的组织的名称。

bucket

要将数据写入到的 Bucket 的名称。

influxdb_v2 配置示例

以下示例说明了 influxdb_v2 配置。

# ...

[[outputs.influxdb_v2]]
  urls = ["http://localhost:8086"]
  token = "$INFLUX_TOKEN"
  organization = "example-org"
  bucket = "example-bucket"

# ...
写入到 InfluxDB v1.x 和 v2.x

如果 Telegraf 代理已在写入 InfluxDB v1.x 数据库,则启用 InfluxDB v2 输出插件会将数据写入到 v1.x 和 2.7 实例。

将自定义 Telegraf 配置添加到 InfluxDB

要将自定义或手动配置的 Telegraf 配置添加到 InfluxDB 中的 Telegraf 配置集合中,请使用 influx telegrafs createinflux telegrafs update 命令。有关更多信息,请参阅

启动 Telegraf

使用 --config 标志启动 Telegraf 服务,以指定您的 telegraf.conf 的位置。

telegraf --config /path/to/custom/telegraf.conf

此页内容是否对您有帮助?

感谢您的反馈!


Flux 的未来

Flux 即将进入维护模式。您可以继续像当前一样使用它,而无需对您的代码进行任何更改。

阅读更多

现已全面上市

InfluxDB 3 Core 和 Enterprise

快速启动。更快扩展。

获取更新

InfluxDB 3 Core 是一个开源、高速、近实时数据引擎,可实时收集和处理数据,并将其持久化到本地磁盘或对象存储。InfluxDB 3 Enterprise 构建在 Core 的基础上,增加了高可用性、读取副本、增强的安全性以及数据压缩功能,以实现更快的查询和优化的存储。InfluxDB 3 Enterprise 的免费层可供非商业家庭或业余爱好者使用。

有关更多信息,请查看