文档文档

配置 Telegraf 以写入 InfluxDB 3 Core

InfluxDB 3 Core 处于公开 Alpha 阶段

InfluxDB 3 Core 处于公开 alpha 阶段,可用于测试和反馈,但不适用于生产环境。产品和本文档都在不断完善中。我们欢迎并鼓励您提供关于 alpha 体验的反馈,并邀请您加入我们的公共渠道以获取更新和分享反馈。

Alpha 预期和建议

使用 Telegraf influxdb_v2 输出插件 来收集指标并将指标写入 InfluxDB 3 Core。此插件使用 InfluxDB v2 HTTP API 写入端点,InfluxDB 3 Core 提供此端点。了解如何启用和配置 influxdb_v2 输出插件以将数据写入 InfluxDB 3 Core。

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

配置 Telegraf 输入和输出插件

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

本指南假设您已经安装了 InfluxDB 3 Core 并已阅读入门指南

添加 Telegraf 插件

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

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

启用和配置 InfluxDB v2 输出插件

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

[[outputs.influxdb_v2]]
  urls = ["https://#:8181"]
  token = "
AUTH_TOKEN
"
organization = "" bucket = "
DATABASE_NAME
"

替换以下内容

  • DATABASE_NAME:要将数据写入的数据库的名称

  • AUTH_TOKEN:您的 InfluxDB 3 Core 授权令牌。将其存储在密钥存储或环境变量中,以避免暴露原始令牌字符串。

    在 alpha 阶段,InfluxDB 3 Core 不需要授权令牌。对于 token 选项,请提供任意非空令牌字符串。

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

urls

URL 字符串数组。要写入 InfluxDB 3 Core,请包含您的 InfluxDB 3 Core URL

["https://#:8181"]

token

您的 InfluxDB 3 Core 授权令牌。

在 alpha 阶段,InfluxDB 3 Core 不需要授权令牌。对于 token 选项,请提供任意非空令牌字符串。

将您的授权令牌存储为环境变量

为了防止在您的 Telegraf 配置文件中出现纯文本令牌,我们建议您将令牌存储为环境变量,然后在您的配置文件中使用字符串插值引用环境变量。例如

[[outputs.influxdb_v2]]
  urls = ["https://#:8181"]
  token = "${INFLUX_TOKEN}"
  # ...

organization

对于 InfluxDB 3 Core,请将其设置为空字符串 ("")。

bucket

要将数据写入的 InfluxDB 3 Core 数据库的名称。

InfluxDB v2 bucket 与 InfluxDB 3 Core database 同义。

其他 Telegraf 配置选项

有关更多插件配置选项,请参阅 GitHub 上的 influxdb_v2 输出插件 README

启动 Telegraf

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

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

此页是否对您有帮助?

感谢您的反馈!


Flux 的未来

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

阅读更多

InfluxDB 3 开源版本现已公开 Alpha

InfluxDB 3 开源版本现已可用于 alpha 测试,根据 MIT 或 Apache 2 许可获得许可。

我们正在发布两个产品作为 alpha 版本的一部分。

InfluxDB 3 Core 是我们新的开源产品。它是一个用于时间序列和事件数据的最新数据引擎。InfluxDB 3 Enterprise 是一个商业版本,它建立在 Core 的基础上,增加了历史查询功能、读取副本、高可用性、可扩展性和细粒度的安全性。

有关如何开始使用的更多信息,请查看