文档文档

配置 Telegraf 以将数据写入 InfluxDB 3 Core

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

查看使用 Telegraf 配合 InfluxDB 3 Core 的要求

配置 Telegraf 输入和输出插件

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

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

添加 Telegraf 插件

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

  1. 从可用Telegraf 插件的完整列表中找到您想要启用的插件。
  2. 点击插件名称右侧的View,在 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 令牌请将其存储在密钥存储或环境变量中,以避免暴露原始令牌字符串。

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

urls

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

["https://:8181"]

token

您的 InfluxDB 3 Core 授权令牌。

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

为了防止在 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.conf 的位置,然后启动 Telegraf 服务。

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

此页面是否有帮助?

感谢您的反馈!


InfluxDB 3.8 新特性

InfluxDB 3.8 和 InfluxDB 3 Explorer 1.6 的主要增强功能。

查看博客文章

InfluxDB 3.8 现已适用于 Core 和 Enterprise 版本,同时发布了 InfluxDB 3 Explorer UI 的 1.6 版本。本次发布着重于操作成熟度,以及如何更轻松地部署、管理和可靠地运行 InfluxDB。

更多信息,请查看

InfluxDB Docker 的 latest 标签将指向 InfluxDB 3 Core

在 **2026 年 2 月 3 日**,InfluxDB Docker 镜像的 latest 标签将指向 InfluxDB 3 Core。为避免意外升级,请在您的 Docker 部署中使用特定的版本标签。

如果使用 Docker 来安装和运行 InfluxDB,latest 标签将指向 InfluxDB 3 Core。为避免意外升级,请在您的 Docker 部署中使用特定的版本标签。例如,如果使用 Docker 运行 InfluxDB v2,请将 latest 版本标签替换为 Docker pull 命令中的特定版本标签 — 例如

docker pull influxdb:2