手动配置 Telegraf
使用 Telegraf influxdb_v2
输出插件来收集指标并将指标写入 InfluxDB 2.7 Bucket。本文介绍如何在新的和现有的 Telegraf 配置中启用 influxdb_v2
输出插件,然后使用自定义配置文件启动 Telegraf。
查看将 Telegraf 与 InfluxDB 2.7 一起使用的要求。
配置 Telegraf 输入和输出插件
在 Telegraf 配置文件(通常名为 telegraf.conf
)中配置 Telegraf 输入和输出插件。输入插件收集指标。输出插件定义指标发送的目标位置。
请参阅 Telegraf 插件 以获取可用插件的完整列表。
手动添加 Telegraf 插件
要手动添加任何可用的 Telegraf 插件,请按照以下步骤操作。
- 从可用 Telegraf 插件 的完整列表中找到您要启用的插件。
- 单击插件名称右侧的 查看 以在 GitHub 上打开插件页面。例如,在此处查看 MQTT 插件 GitHub 页面 here。
- 将示例配置复制并粘贴到您的 Telegraf 配置文件(通常名为
telegraf.conf
)中。
启用和配置 InfluxDB v2 输出插件
要将数据发送到 InfluxDB 2.7 实例,请在 telegraf.conf
中启用 influxdb_v2
输出插件。
在 UI 中查找示例 InfluxDB v2 输出插件配置
在左侧的导航菜单中,选择 数据 (加载数据) > Telegraf。
单击 InfluxDB 输出插件。
单击 复制到剪贴板 以复制示例配置,或单击 下载配置 以保存副本。
将示例配置粘贴到您的
telegraf.conf
中,并指定以下选项。
InfluxDB 输出插件配置包含以下选项
urls
您的 InfluxDB 2.7 实例的 URL 数组。有关要使用哪个 URL 的信息,请参阅 InfluxDB URL。InfluxDB 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 create
或 influx telegrafs update
命令。有关更多信息,请参阅
启动 Telegraf
使用 --config
标志启动 Telegraf 服务,以指定您的 telegraf.conf
的位置。
telegraf --config /path/to/custom/telegraf.conf
此页内容是否对您有帮助?
感谢您的反馈!
支持和反馈
感谢您成为我们社区的一份子!我们欢迎并鼓励您提供关于 InfluxDB 和本文档的反馈和错误报告。要寻求支持,请使用以下资源
拥有年度合同或支持合同的客户可以联系 InfluxData 支持。