Telegraf 1.29 Release Notes

By Josh Powers / Developer, Product
Dec 13, 2023

Navigate to:

A new feature-bearing release for Telegraf is now available:

You can find the binaries for the latest Telegraf release on our Downloads page. Many thanks to all the open source community members who contributed to this effort!

New Plugins

These are the newest plugins, first available in this version:

  • Filter Processor (processors.filter)
    • Set rules with the ability to keep or drop specific metrics
    • Contributed by srebhan
  • LDAP Input (inputs.ldap)
    • Monitor LDAP servers’ monitoring backend
    • Contributed by srebhan
  • OpenSearch Output (outputs.opensearch)
    • Send metrics to OpenSearch
    • Contributed by mannukalra
  • Systemd Secret Store (secretstores.systemd)
    • Secret store to use systemd as a backend
    • Contributed by srebhan

Important Changes

Here are some changes to highlight:

  • Secrets Global Option
    • Introduced a new --unprotected global flag.
    • When set, this flag instructs Telegraf to not attempt to reserve locked memory pages. This option might pose a security risk as decrypted secrets might be swapped out to disk, but allows for execution in environments where reserving locked memory is not possible.
  • Deprecate fieldpass and fielddrop modifiers
    • In order to better align the naming conventions, the metric modifiers fieldpass and fielddrop are replaced with fieldinclude and fieldexclude.
    • All options will continue to work, but the documentation and examples were updated with the new terms.
  • Oracle and IBM Netezza SQL Support
    • The SQL input plugin now has drivers for both Oracle and IBM Netezza.
  • Stackdriver Distributions
    • The Stackdriver output can now take histograms and send them as a Stackdriver distribution.
    • This only supports Prometheus metric version 1 histograms. The sparse layout of version 2 histograms requires using the merge aggregator.
  • Removed all-zero fields from inputs.procstat
    • Up to now, Telegraf reports the fields cpu_time_guest, cpu_time_guest_nice, cpu_time_idle, cpu_time_irq, cpu_time_nice, cpu_time_soft_irq and cpu_time_steal, which the underlying library never sets. As a consequence, those fields were always zero.
  • Introduction of Migrations
    • Users can migrate several deprecated plugins and plugin options using the new telegraf config migrate command. This works for all plugins and options scheduled for removal in v1.30.0 (see next section).
    • For each given configuration file, the command generates a migrated version with a .migrated suffix.
    • Please check the modifications and test the migrated version before using it!
    • Please also check the output of the command carefully as some migrations require further manual intervention due to ambiguous settings, adapted metric formats, or complex setups.
    • Note: The migration command will not keep comments for migrated plugins!

Deprecation Removals

This is the final release before the planned removal of several plugins and options. Users have been warned about these removals via warnings for multiple years. The list of removals includes:

  • Plugins
    • inputs.cassandra replaced with inputs.jolokia2
    • inputs.httpjson replaced with inputs.http
    • inputs.io replaced by inputs.diskio
    • inputs.jolokia replaced by inputs.jolokia2
    • inputs.kafka_consumer_legacy replaced by inputs.kafka_consumer
    • inputs.snmp_legacy replaced by inputs.snmp
    • inputs.tcp_listener replaced by inputs.socket_listener
    • inputs.udp_listener replaced by inputs.socket_listener
    • outputs.riemann_legacy replaced by outputs.riemann
  • Config Options
    • inputs.disk: mountpoints replaced by mount_points
    • inputs.mqtt_consumer: metric_buffer is ignored
    • inputs.nats_consumer: metric_buffer is ignored
    • inputs.influxdb : url replaced by urls

Downloads

Head to our Downloads page to get the latest Telegraf release. If you find issues or have questions, please join our InfluxDB Community Slack, post them in our InfluxDB GitHub Repo, or our Community Site, and we will take a look.

InfluxDB University

Learn more about collecting data with Telegraf by taking the free InfluxDB University Data Collection with Telegraf course.