Telegraf 配置迁移

作者： Sven Rebhan / 开发者
2024 年 3 月 4 日

导航到

在 v1.30.0 版本中，Telegraf 将移除一些长期弃用的插件。这些插件已经弃用多年，现在有更好的支持和配置选项的插件已经取代了它们。Telegraf 的这个版本还移除了一些配置选项。

弃用插件的完整列表包括

  • inputs.cassandra
  • inputs.httpjson
  • inputs.io
  • inputs.jolokia
  • inputs.kafka_consumer_legacy
  • inputs.snmp_legacy
  • inputs.tcp_listener
  • inputs.udp_listener
  • outputs.riemann_legacy

从 v1.30.0 版本开始，如果配置中存在任何插件或选项，Telegraf 将显示错误消息并停止运行。

迁移配置

为了帮助用户适应他们的配置，Telegraf 随附了一个迁移工具，可以帮助您在可能的情况下用新的、维护的等效插件和选项替换弃用的插件和选项。

要迁移位于 /etc/telegraf/telegraf.conf 和 /etc/telegraf/telegraf.d 的现有配置，您可以运行

$ sudo telegraf config migrate

如果您的配置不同或者您只想迁移特定文件，请使用 --config 和 --config-directory 选项，例如

$ telegraf  –config mytelegraf.conf –config-directory ~/telegraf.d config migrate

该命令将加载每个配置文件，如有需要则应用可用迁移，并且在应用了任何迁移的情况下，将迁移后的配置保存到同一位置的具有.migrated文件后缀的文件中。

重要提示

  • 请仔细阅读迁移命令的输出！某些插件无法自动转换，或者没有可用的直接替代品。这些情况需要手动迁移配置。此外，度量属性如名称、标签键或字段键可能会更改。迁移命令将在这些情况下通知您。
  • 请检查迁移后的配置！默认情况下，原始配置文件保持原样且未更改。如果迁移工具的更改是正确的，您应该手动替换配置文件。
  • 迁移工具将删除迁移插件的注释，并保留任何未受影响、未更改插件的注释。

下载

前往我们的下载页面获取最新的Telegraf版本。如果您发现问题或有疑问，请加入我们的InfluxDB社区Slack，在InfluxDB GitHub 仓库或社区网站上发布，我们将进行检查。

InfluxDB大学

通过免费学习InfluxDB大学的使用Telegraf收集数据课程，了解更多关于使用Telegraf收集数据的信息。

测试呼吁

如果您有兴趣参与测试您所使用的插件和系统的错误修复和功能，请填写此表格。Telegraf维护者将在拉取请求中标记您以测试工件。这将帮助我们更好地处理发布后可能出现的错误。