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 Repo 或我们的 社区网站 上发布，我们将进行查看。

InfluxDB 大学

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

测试邀请

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