From cf032765816eb8304fbcb41e268ba7d23cde11f7 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Wed, 3 Dec 2025 17:35:36 +0000 Subject: [PATCH 1/6] Initial plan From 36c4b009175a258a28df95ea45572cd0a9e8021d Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Wed, 3 Dec 2025 17:48:54 +0000 Subject: [PATCH 2/6] Add Telegraf concurrent_writes documentation for InfluxDB v3 Core and Enterprise Co-authored-by: jstirnaman <212227+jstirnaman@users.noreply.github.com> --- .../use-telegraf/configure.md | 30 +++++++++++++++++++ 1 file changed, 30 insertions(+) diff --git a/content/shared/influxdb3-write-guides/use-telegraf/configure.md b/content/shared/influxdb3-write-guides/use-telegraf/configure.md index afaafa1e33..8cb42c8e26 100644 --- a/content/shared/influxdb3-write-guides/use-telegraf/configure.md +++ b/content/shared/influxdb3-write-guides/use-telegraf/configure.md @@ -19,6 +19,7 @@ to {{% product-name %}}. - [token](#token) - [organization](#organization) - [bucket](#bucket) + - [concurrent_writes](#concurrent_writes) - [Other Telegraf configuration options](#other-telegraf-configuration-options) - [Start Telegraf](#start-telegraf) @@ -57,6 +58,7 @@ in the `telegraf.conf`. token = "AUTH_TOKEN" organization = "" bucket = "DATABASE_NAME" +{{% show-in "enterprise,core" %}} concurrent_writes = 5{{% /show-in %}} ``` {{% /code-placeholders %}} @@ -110,8 +112,36 @@ The name of the {{% product-name %}} database to write data to. > [!Note] > An InfluxDB v2 _**bucket**_ is synonymous with an {{% product-name %}} _**database**_. +#### concurrent_writes + +{{% show-in "enterprise,core" %}} + +The number of concurrent write connections to use when writing to {{% product-name %}}. +For optimal write performance, configure multiple concurrent writers. + +**Recommendation:** Set `concurrent_writes` to at least `2` in nearly all situations. +For tuning, start with `min(number of CPU cores / 2, 10)`. + +```toml +[[outputs.influxdb_v2]] + urls = ["http://{{< influxdb/host >}}"] + token = "${INFLUX_TOKEN}" + organization = "" + bucket = "DATABASE_NAME" + concurrent_writes = 5 +``` + +> [!Important] +> When using two or more concurrent writes, the sending order of metrics is not guaranteed. + +{{% /show-in %}} + ### Other Telegraf configuration options +> [!Note] +> Use the `influxdb_v2` output plugin (not the v1 plugin) for writing to {{% product-name %}}. +> The v1 output plugin may work but is not recommended. + For more plugin configuration options, see the [`influxdb_v2` output plugin README](/telegraf/v1/output-plugins/influxdb_v2/) on GitHub. From 28f7a6c19b4b6acd73777e85c3d3e4fbd89df541 Mon Sep 17 00:00:00 2001 From: Jason Stirnaman Date: Tue, 16 Dec 2025 16:16:53 -0600 Subject: [PATCH 3/6] Update content/shared/influxdb3-write-guides/use-telegraf/configure.md --- content/shared/influxdb3-write-guides/use-telegraf/configure.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/shared/influxdb3-write-guides/use-telegraf/configure.md b/content/shared/influxdb3-write-guides/use-telegraf/configure.md index 8cb42c8e26..735b5830dc 100644 --- a/content/shared/influxdb3-write-guides/use-telegraf/configure.md +++ b/content/shared/influxdb3-write-guides/use-telegraf/configure.md @@ -58,7 +58,7 @@ in the `telegraf.conf`. token = "AUTH_TOKEN" organization = "" bucket = "DATABASE_NAME" -{{% show-in "enterprise,core" %}} concurrent_writes = 5{{% /show-in %}} + concurrent_writes = 5 ``` {{% /code-placeholders %}} From fb8091434c03700b6dbf7a683141cec6c8df83c8 Mon Sep 17 00:00:00 2001 From: Jason Stirnaman Date: Tue, 16 Dec 2025 16:17:01 -0600 Subject: [PATCH 4/6] Update content/shared/influxdb3-write-guides/use-telegraf/configure.md --- content/shared/influxdb3-write-guides/use-telegraf/configure.md | 2 -- 1 file changed, 2 deletions(-) diff --git a/content/shared/influxdb3-write-guides/use-telegraf/configure.md b/content/shared/influxdb3-write-guides/use-telegraf/configure.md index 735b5830dc..0d416cbb62 100644 --- a/content/shared/influxdb3-write-guides/use-telegraf/configure.md +++ b/content/shared/influxdb3-write-guides/use-telegraf/configure.md @@ -114,8 +114,6 @@ The name of the {{% product-name %}} database to write data to. #### concurrent_writes -{{% show-in "enterprise,core" %}} - The number of concurrent write connections to use when writing to {{% product-name %}}. For optimal write performance, configure multiple concurrent writers. From b2c2f00e24626959d0d8fbb08d84bd6f255318ae Mon Sep 17 00:00:00 2001 From: Jason Stirnaman Date: Tue, 16 Dec 2025 16:17:07 -0600 Subject: [PATCH 5/6] Update content/shared/influxdb3-write-guides/use-telegraf/configure.md --- content/shared/influxdb3-write-guides/use-telegraf/configure.md | 1 - 1 file changed, 1 deletion(-) diff --git a/content/shared/influxdb3-write-guides/use-telegraf/configure.md b/content/shared/influxdb3-write-guides/use-telegraf/configure.md index 0d416cbb62..edfe1eb257 100644 --- a/content/shared/influxdb3-write-guides/use-telegraf/configure.md +++ b/content/shared/influxdb3-write-guides/use-telegraf/configure.md @@ -132,7 +132,6 @@ For tuning, start with `min(number of CPU cores / 2, 10)`. > [!Important] > When using two or more concurrent writes, the sending order of metrics is not guaranteed. -{{% /show-in %}} ### Other Telegraf configuration options From 238a8ad480a2fb6029d8c6903ced283e2fa609ab Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Tue, 16 Dec 2025 22:26:49 +0000 Subject: [PATCH 6/6] fix: wrap concurrent_writes section with show-in directive for core/enterprise only Co-authored-by: jstirnaman <212227+jstirnaman@users.noreply.github.com> --- .../shared/influxdb3-write-guides/use-telegraf/configure.md | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/content/shared/influxdb3-write-guides/use-telegraf/configure.md b/content/shared/influxdb3-write-guides/use-telegraf/configure.md index edfe1eb257..176d910ca2 100644 --- a/content/shared/influxdb3-write-guides/use-telegraf/configure.md +++ b/content/shared/influxdb3-write-guides/use-telegraf/configure.md @@ -58,7 +58,7 @@ in the `telegraf.conf`. token = "AUTH_TOKEN" organization = "" bucket = "DATABASE_NAME" - concurrent_writes = 5 +{{% show-in "enterprise,core" %}} concurrent_writes = 5{{% /show-in %}} ``` {{% /code-placeholders %}} @@ -112,6 +112,8 @@ The name of the {{% product-name %}} database to write data to. > [!Note] > An InfluxDB v2 _**bucket**_ is synonymous with an {{% product-name %}} _**database**_. +{{% show-in "enterprise,core" %}} + #### concurrent_writes The number of concurrent write connections to use when writing to {{% product-name %}}. @@ -132,6 +134,7 @@ For tuning, start with `min(number of CPU cores / 2, 10)`. > [!Important] > When using two or more concurrent writes, the sending order of metrics is not guaranteed. +{{% /show-in %}} ### Other Telegraf configuration options