Telegraf 1.29 版本发布说明

作者：Josh Powers / 开发者, 产品
2023 年 12 月 13 日

导航到

Telegraf 的新功能版本现已发布

您可以在我们的下载页面上找到最新 Telegraf 版本的二进制文件。非常感谢所有为这项工作做出贡献的开源社区成员！

新插件

这些是最新插件，在此版本中首次提供

  • 过滤器处理器 (processors.filter)
    • 设置规则，能够保留或删除特定指标
    • 由 srebhan 贡献
  • LDAP 输入 (inputs.ldap)
    • 监控 LDAP 服务器的监控后端
    • 由 srebhan 贡献
  • OpenSearch 输出 (outputs.opensearch)
    • 将指标发送到 OpenSearch
    • 由 mannukalra 贡献
  • Systemd 密钥存储 (secretstores.systemd)
    • 使用 systemd 作为后端的密钥存储
    • 由 srebhan 贡献

重要变更

以下是一些需要重点关注的变更

  • 密钥全局选项
    • 引入了一个新的 --unprotected 全局标志。
    • 设置后，此标志指示 Telegraf 不尝试保留锁定的内存页。此选项可能构成安全风险，因为解密的密钥可能会被交换到磁盘，但允许在无法保留锁定内存的环境中执行。
  • 弃用 fieldpass 和 fielddrop 修饰符
    • 为了更好地对齐命名约定，指标修饰符 fieldpass 和 fielddrop 被替换为 fieldinclude 和 fieldexclude。
    • 所有选项将继续有效，但文档和示例已使用新术语更新。
  • Oracle 和 IBM Netezza SQL 支持
    • SQL 输入插件现在具有 Oracle 和 IBM Netezza 的驱动程序。
  • Stackdriver 分布
    • Stackdriver 输出现在可以接受直方图并将它们作为 Stackdriver 分布发送。
    • 这仅支持 Prometheus 指标版本 1 直方图。版本 2 直方图的稀疏布局需要使用合并聚合器。
  • 从 inputs.procstat 中删除全零字段
    • 到目前为止，Telegraf 报告了字段 cpu_time_guest、cpu_time_guest_nice、cpu_time_idle、cpu_time_irq、cpu_time_nice、cpu_time_soft_irq 和 cpu_time_steal，但底层库从未设置这些字段。因此，这些字段始终为零。
  • 迁移的引入
    • 用户可以使用新的 telegraf config migrate 命令迁移多个已弃用的插件和插件选项。这适用于计划在 v1.30.0 中删除的所有插件和选项（见下一节）。
    • 对于每个给定的配置文件，该命令都会生成一个带有 .migrated 后缀的迁移版本。
    • 请在使用迁移版本之前检查修改并进行测试！
    • 还请仔细检查命令的输出，因为由于不明确的设置、调整后的指标格式或复杂的设置，某些迁移需要进一步的人工干预。
    • 注意：迁移命令不会保留迁移插件的注释！

弃用移除

这是计划删除多个插件和选项之前的最终版本。多年来，用户已收到关于这些移除的警告。移除列表包括

  • 插件
    • inputs.cassandra 已替换为 inputs.jolokia2
    • inputs.httpjson 已替换为 inputs.http
    • inputs.io 已替换为 inputs.diskio
    • inputs.jolokia 已替换为 inputs.jolokia2
    • inputs.kafka_consumer_legacy 已替换为 inputs.kafka_consumer
    • inputs.snmp_legacy 已替换为 inputs.snmp
    • inputs.tcp_listener 已替换为 inputs.socket_listener
    • inputs.udp_listener 已替换为 inputs.socket_listener
    • outputs.riemann_legacy 已替换为 outputs.riemann
  • 配置选项
    • inputs.disk: mountpoints 已替换为 mount_points
    • inputs.mqtt_consumer: metric_buffer 已被忽略
    • inputs.nats_consumer: metric_buffer 已被忽略
    • inputs.influxdb : url 已替换为 urls

下载

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

InfluxDB 大学

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