From c45de638dce6b86de2d69dc392b9a393b0d2663c Mon Sep 17 00:00:00 2001 From: Scott Anderson Date: Tue, 24 Mar 2026 10:14:35 -0600 Subject: [PATCH 1/2] chore(telegraf): add important warnings to Telegraf 1.38.0 release notes (#6981) * chore(telegraf): add important warnings to Telegraf 1.38.0 release notes * Apply suggestions from code review Co-authored-by: Jason Stirnaman --------- Co-authored-by: Jason Stirnaman --- content/telegraf/v1/release-notes.md | 50 +++++++++++++++++++++------- 1 file changed, 38 insertions(+), 12 deletions(-) diff --git a/content/telegraf/v1/release-notes.md b/content/telegraf/v1/release-notes.md index 973f4b651..e7cc54ee1 100644 --- a/content/telegraf/v1/release-notes.md +++ b/content/telegraf/v1/release-notes.md @@ -43,8 +43,34 @@ menu: ## v1.38.0 {date="2026-03-09"} +> [!Warning] +> #### Panic in the Heartbeat output plugin +> +> Telegraf v1.38.0 introduced a panic in the +> [Heartbeat output plugin](/telegraf/v1/output-plugins/heartbeat/) that +> prevents Telegraf from starting when the plugin is enabled. Telegraf v1.38.2 +> will include a fix, but in the meantime, to use the Heartbeat output plugin, +> revert back to Telegraf v1.37.x _(recommended)_, use a Telegraf nightly build, +> or build Telegraf from source. + ### Important Changes +> [!Important] +> #### Changes to Linux memory usage tracking +> +> Starting in Telegraf v1.36.0, the `used_percent` field reported by the `mem` +> input plugin on Linux increased by roughly 6-20% for the same memory state. +> This was caused by an upstream change in the +> [gopsutil](https://github.com/shirou/gopsutil) dependency (v4.25.8), which +> changed the `Used` memory calculation from `Total - Free - Buffers - Cached` +> to `Total - Available` (using the kernel's `MemAvailable` from +> `/proc/meminfo`). The new formula is more accurate as the old one assumed all +> cached and buffered memory was immediately reclaimable, which is not always the +> case. Dashboards or alerts based on `used_percent` thresholds may need +> adjustment. The raw fields (`free`, `buffered`, `cached`, `available`, +> `total`) are unaffected and can be used to compute either definition in +> queries. + - PR [#17961](https://github.com/influxdata/telegraf/pull/17961) makes the **strict environment variable handling the default**! In case you need the old behavior you can opt-out using the `--non-strict-env-handling` flag. @@ -1429,7 +1455,7 @@ The `telegraf config migrate` command might be able to help with the migration. - [#16469](https://github.com/influxdata/telegraf/pull/16469) `deps` Bump google.golang.org/api from 0.214.0 to 0.219.0 - [#16396](https://github.com/influxdata/telegraf/pull/16396) `deps` Bump k8s.io/api from 0.31.3 to 0.32.1 - [#16482](https://github.com/influxdata/telegraf/pull/16482) `deps` Update Apache arrow from 0.0-20240716144821-cf5d7c7ec3cf to 18.1.0 -- [#16423](https://github.com/influxdata/telegraf/pull/16423) `deps` Update ClickHouse SQL driver from 1.5.4 to to 2.30.1 +- [#16423](https://github.com/influxdata/telegraf/pull/16423) `deps` Update ClickHouse SQL driver from 1.5.4 to 2.30.1 ## v1.33.1 {date="2025-01-10"} @@ -2427,7 +2453,7 @@ can help with migrating to newer plugins. #### Inputs -- [LDAP](https://github.com/influxdata/telegraf/tree/master/plugins/inputs/ldap) (`inputs.inputs.ldap`) +- [LDAP](https://github.com/influxdata/telegraf/tree/master/plugins/inputs/ldap) (`inputs.ldap`) #### Outputs @@ -4512,7 +4538,7 @@ The signing for RPM digest has changed to use sha256 to improve security. Due to - Cloudwatch (`cloudwatch`): Fix metrics collection. - CPU (`cpu`): Update `shirou/gopsutil` from v2 to v3. - Directory Monitor (`directory_monitor`): - - Fix to when when data format is CSV and `csv_skip_rows>0` and `csv_header_row_count>=1`. + - Fix to when data format is CSV and `csv_skip_rows>0` and `csv_header_row_count>=1`. - Adds the ability to create and name a tag containing the filename. - ElasticSearch (`elasticsearch_query`): Add debug query output. - HTTP Listener v2: (`http_listener_v2`): Fix panic on close to check that Telegraf is closing. @@ -4954,7 +4980,7 @@ The signing for RPM digest has changed to use sha256 to improve security. Due to ### Output plugin updates -- [Elasticsearch Output](https://github.com/influxdata/telegraf/tree/master/plugins/outputs/elasticsearch/README.md): Add ability to to enable gzip compression. +- [Elasticsearch Output](https://github.com/influxdata/telegraf/tree/master/plugins/outputs/elasticsearch/README.md): Add ability to enable gzip compression. @@ -6716,7 +6742,7 @@ for details about the mapping. - Improve cloudwatch output performance. - Add x509_cert input plugin. - Add IPSIpAddress syntax to ipaddr conversion in snmp plugin. -- Add Filecount filecount input plugin. +- Add Filecount input plugin. - Add support for configuring an AWS `endpoint_url`. - Send all messages before waiting for results in Kafka output plugin. - Add support for lz4 compression to Kafka output plugin. @@ -6829,8 +6855,8 @@ for details about the mapping. ### Release notes - The Cassandra (`cassandra`) input plugin has been deprecated in favor of the Jolokia2 (`jolokia2`) - input plugin which is much more configurable and more performant. There is - an [example configuration](https://github.com/influxdata/telegraf/tree/release-1.8/plugins/inputs/jolokia2/examples) to help you + input plugin which is much more configurable and more performant. The + [example configuration](https://github.com/influxdata/telegraf/tree/release-1.8/plugins/inputs/jolokia2/examples) will help you get started. - For plugins supporting TLS, you can now specify the certificate and keys @@ -7628,9 +7654,9 @@ plugins, not just statsd. - On systemd Telegraf will no longer redirect it's stdout to /var/log/telegraf/telegraf.log. On most systems, the logs will be directed to the systemd journal and can be accessed by `journalctl -u telegraf.service`. Consult the systemd journal -documentation for configuring journald. There is also a [`logfile` config option](https://github.com/influxdata/telegraf/blob/release-1.8/etc/telegraf.conf#L70) -available in 1.1, which will allow users to easily configure telegraf to -continue sending logs to /var/log/telegraf/telegraf.log. +documentation for configuring journald. The [`logfile` config option](https://github.com/influxdata/telegraf/blob/release-1.8/etc/telegraf.conf#L70) +available in 1.1 lets users configure Telegraf to +continue sending logs to `/var/log/telegraf/telegraf.log`. ### Features @@ -7710,8 +7736,8 @@ continue sending logs to /var/log/telegraf/telegraf.log. ### Release Notes **Breaking Change** The SNMP plugin is being deprecated in it's current form. -There is a [new SNMP plugin](https://github.com/influxdata/telegraf/tree/release-1.8/plugins/inputs/snmp) -which fixes many of the issues and confusions +The [new SNMP plugin](https://github.com/influxdata/telegraf/tree/release-1.8/plugins/inputs/snmp) +fixes many of the issues and confusions of its predecessor. For users wanting to continue to use the deprecated SNMP plugin, you will need to change your config file from `[[inputs.snmp]]` to `[[inputs.snmp_legacy]]`. The configuration of the new SNMP plugin is _not_ From 5f7b4fda7b025c6c73c7b195c42e166c35439419 Mon Sep 17 00:00:00 2001 From: Adam S Date: Tue, 24 Mar 2026 16:24:04 -0700 Subject: [PATCH 2/2] Update environment variable for use-pacha-tree option (#6983) As noted in: https://github.com/influxdata/influxdb_pro/blob/85d1f74441fe37026f05a490e2387e11de70ae63/ent/influxdb3_pacha_tree/README.md#pachatree-storage-engine --- content/shared/influxdb3-cli/config-options.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/shared/influxdb3-cli/config-options.md b/content/shared/influxdb3-cli/config-options.md index d82eafaba..aa0ef46e6 100644 --- a/content/shared/influxdb3-cli/config-options.md +++ b/content/shared/influxdb3-cli/config-options.md @@ -291,7 +291,7 @@ Enables the PachaTree storage engine. | influxdb3 serve option | Environment variable | | :--------------------- | :----------------------------- | -| `--use-pacha-tree` | `INFLUXDB3_USE_PACHA_TREE` | +| `--use-pacha-tree` | `INFLUXDB3_ENTERPRISE_USE_PACHA_TREE` | ***