InfluxData Releases Telegraf 1.21.0

By Samantha Wang / Product
Dec 15, 2021

A new Telegraf feature-bearing release includes seven new plugins, SNMP plugin performance improvements, and plugin deprecation warnings. 

• Telegraf 1.21.0 – release notes
• The binaries for the latest Telegraf release can be found on our downloads page.

Many thanks to the 70+ open source community members who contributed to this effort!

Key features

SNMP enhancements

• The SNMP Plugin now relies on the gosnmi library to parse MIB files directly to improve the performance of Telegraf.
• The plugin no longer requires the installation of snmptranslate
• Breaking Change: If your MIBs are not stored in the default location then they they will need to be moved or designated in the plugin configuration setting path = ["/usr/share/snmp/mibs"]

MQTT topics as tags, fields, and measurements

• The MQTT Input Plugin now extracts MQTT topic into tags, fields, and measurements.

Implementation of deprecation warnings

• If you are currently using a Telegraf plugin or plugin setting that has been deprecated, we have added a warning message noting the version it was deprecated in and the replacement (if applicable).
• Example plugin message: W! DeprecationWarning: Plugin "inputs.httpjson" deprecated since version 1.6.0 and will be removed in 2.0.0: use 'inputs.http' instead
• View all deprecated plugins in our docs or by running telegraf -deprecation-list.

RPM digest now uses SHA256

• Implemented RPM builds to use sha256 digest algorithm to resolve an issue where RPM packages were not installable on RHEL with FIPS.
• The previous md5 algorithm is known to be unsafe and FIPS enabled systems do not allow its use for file manifests.
• ***Note: Due to this change, RPM builds may not be compatible with RHEL6 and older releases (Telegraf only supports releases in RHEL production - see more)

Other enhancements

• JSON v2 Parser
  • To allow users to gather specific elements from an array, this pull request allows users to define field/tag tables within an object table. This will allow a user to gather a field/tag while still maintaining the original relationship within the JSON. See example on how to use the feature.
• Regex Processor
  • We extended the Regex processor to be able to rename measurements, tags, and fields using regular expressions.
• Modbus Input
  • We added options to enable debugging of Modbus connections and to more fine-tune connection handling.
• OPC UA Input
  • We added an option to select the source (server/source/Telegraf) of the metric timestamp.
• Kafka Consumer Input
  • We added a max_processing_time configuration field to fix a problem where the plugin would continually abandon and resubscribe to a topic partition when the Telegraf would take longer than the 100ms sarama default.
• Directory Monitor Input
  • We added the ability to create and name a tag containing the filename parsed.

New inputs

• Intel PMU Input Plugin (intel_pmu)
  • This plugin exposes Intel PMU (Performance Monitoring Unit) metrics available through Linux Perf subsystem. Contributed by @bkotlowski.
• Logical Volume Manager Input Plugin (lvm)
  • This plugin collects information about physical volumes, volume groups, and logical volumes in Linux. Contributed by @InfluxData
• OpenStack Input Plugin (openstack)
  • This plugin collects metrics on OpenStack services. Contributed by @singamSrikar.

New aggregator

• Starlark Aggregator (starlark)
  • This plugin allows a user to implement a custom aggregator plugin with a Starlark script. Contributed by @essobedo.

New outputs

• Azure Event Hubs Output Plugin (event_hubs)
  • This plugin will send metrics to a single Azure Event Hub within an Event Hubs namespace. Contributed by @tomconte.
• GroundWork Output Plugin (groundwork)
  • This plugin writes to a GroundWork Monitor instance. Contributed by @VladislavSenkevich.
• MongoDB Output Plugin (mongodb)
  • This plugin sends metrics to MongoDB and automatically creates the collections as time series collections when they don't already exist. Contributed by @bustedware.

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.