Telegraf 1.31 Release Notes

By Josh Powers / Product
Jun 12, 2024

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:

  • OpenMetrics Parser (parsers.openmetrics)
    • Parse OpenMetrics-style Prometheus metrics
    • Contributed by srebhan
  • Parquet Parser (parsers.parquet)
    • Generate metrics from parsing Parquet files
    • Contributed by powersj
  • Smartctl Output (inputs.smartctl)
    • Collect metrics from smartctl JSON output
    • Contributed by powersj
  • Timestamp Processor (processors.timestamp)
    • Parse fields containing timestamps into timestamps in other formats
    • Contributed by powersj

Important changes

Here are some changes to highlight:

  • CLI Option: Remote URL retries
    • A new --url-config-retry-attempts CLI option lets users set the number of retry attempts starting from a URL-based configuration file. The default remains 3.
    • Users can set this -1 to try forever, however, note that Telegraf will block starting until it obtains the configuration.
  • CLI Option: Reload URL interval
    • Introduces the --url-config-check-interval CLI option that checks that the remote URL is updated. The existing --watch-config option is only used for local files.
    • This option checks the Last-Modified header to determine if an update is required.
  • Deprecation Removals
    • All deprecation removal messages were updated to either v1.35.0 (June 2025) or v1.40 (September 2026).
    • If you find any issues with the replacements, please file issues.
  • Retry Errors on Startup
    • In general, if Telegraf detects errors connecting to inputs, it will fail to start. This is to ensure the user is aware of the error(s) and prevent the user from assuming everything is working when Telegraf is not collecting everything configured.
    • Some users may want to collect whatever is possible. To enable this, a new set of startup error behavior configuration options was introduced and added to a number of plugins. These options allow the user to either ‘error’ the current behavior, ‘retry’ to allow additional retries of the plugin, or ‘ignore’ to disable that plugin from further attempts.
  • Procstat with Multiple Selection Criteria
    • The proctstat input plugin now allows the user to define multiple filter selection criteria.
    • With this new capability, users can define more finely tuned search parameters to reduce the output and generated metrics.
  • Procstat Fields
    • PR #15186 changes the meaning of inputs.procstat fields read_bytes and write_bytes on Linux to now contain all I/O operations for consistency with other operating-systems. The previous values are output as disk_read_bytes and disk_write_bytes measuring only the I/O on the storage layer.

Downloads

Head to our Downloads page to get the latest Telegraf release. If you have issues or 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.