配置 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 插件,请按照以下步骤操作。
- 从可用Telegraf 插件的完整列表中找到您想要启用的插件。
- 点击插件名称右侧的View,在 GitHub 上打开插件页面。例如,查看MQTT 插件 GitHub 页面。
- 将示例配置复制并粘贴到您的 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 Core 和本文档提供反馈和错误报告。要获得支持,请使用以下资源
具有年度合同或支持合同的客户可以 联系 InfluxData 支持。