From 88bc2f45338c6abf8028da5241bbf49642584822 Mon Sep 17 00:00:00 2001 From: lilin90 Date: Thu, 28 May 2026 10:41:18 +0800 Subject: [PATCH 1/3] *: deprecate and remove telemetry --- pd-configuration-file.md | 6 ++++-- system-variables.md | 1 + tidb-configuration-file.md | 1 + 3 files changed, 6 insertions(+), 2 deletions(-) diff --git a/pd-configuration-file.md b/pd-configuration-file.md index c128d49a9def1..8248c2815caa9 100644 --- a/pd-configuration-file.md +++ b/pd-configuration-file.md @@ -542,9 +542,11 @@ Configuration items related to the [TiDB Dashboard](/dashboard/dashboard-intro.m > **Warning:** > -> Starting from v8.1.0, the telemetry feature in TiDB Dashboard is removed, and this configuration item is no longer functional. It is retained solely for compatibility with earlier versions. +> - For versions from v8.1.0 to v8.5.1, TiDB removes the telemetry feature and this configuration item no longer takes effect. It is retained solely for compatibility with earlier versions. +> - Starting from v8.5.3, TiDB reintroduces the telemetry feature. However, it only logs telemetry-related information locally and no longer sends data to PingCAP over the network. +> - Starting from v8.5.7, TiDB deprecates this configuration item and removes the telemetry feature again. -+ Before v8.1.0, this configuration item controls whether to enable telemetry collection in TiDB Dashboard. ++ Controls whether to enable telemetry collection in TiDB Dashboard. + Default value: `false` ## `replication-mode` diff --git a/system-variables.md b/system-variables.md index c16e0dc2ee434..6e48a7540b25a 100644 --- a/system-variables.md +++ b/system-variables.md @@ -2909,6 +2909,7 @@ Query OK, 0 rows affected (0.09 sec) > - For versions earlier than v8.1.0, TiDB periodically reports telemetry data to PingCAP. > - For versions from v8.1.0 to v8.5.1, TiDB removes the telemetry feature and the `tidb_enable_telemetry` variable no longer takes effect. It is retained solely for compatibility with earlier versions. > - Starting from v8.5.3, TiDB reintroduces the telemetry feature. However, it only logs telemetry-related information locally and no longer sends data to PingCAP over the network. +> - Starting from v8.5.7, TiDB deprecates this system variable and removes the telemetry feature again. - Scope: GLOBAL - Persists to cluster: Yes diff --git a/tidb-configuration-file.md b/tidb-configuration-file.md index d28d953d16f40..ee4d875fdd677 100644 --- a/tidb-configuration-file.md +++ b/tidb-configuration-file.md @@ -183,6 +183,7 @@ The TiDB configuration file supports more options than command-line parameters. > > - For versions from v8.1.0 to v8.5.1, TiDB removes the telemetry feature and this configuration item no longer takes effect. It is retained solely for compatibility with earlier versions. > - Starting from v8.5.3, TiDB reintroduces the telemetry feature. However, it only logs telemetry-related information locally and no longer sends data to PingCAP over the network. +> - Starting from v8.5.7, TiDB deprecates this configuration item and removes the telemetry feature again. - Controls whether to enable telemetry collection in a TiDB instance. - Default value: `false` From c958a83b4e8c26ee7943852ba0da8baaa91b4ae1 Mon Sep 17 00:00:00 2001 From: Lilian Lee Date: Thu, 28 May 2026 10:51:29 +0800 Subject: [PATCH 2/3] Potential fix for pull request finding Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> --- system-variables.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/system-variables.md b/system-variables.md index 6e48a7540b25a..54ece963d3fab 100644 --- a/system-variables.md +++ b/system-variables.md @@ -2908,7 +2908,7 @@ Query OK, 0 rows affected (0.09 sec) > > - For versions earlier than v8.1.0, TiDB periodically reports telemetry data to PingCAP. > - For versions from v8.1.0 to v8.5.1, TiDB removes the telemetry feature and the `tidb_enable_telemetry` variable no longer takes effect. It is retained solely for compatibility with earlier versions. -> - Starting from v8.5.3, TiDB reintroduces the telemetry feature. However, it only logs telemetry-related information locally and no longer sends data to PingCAP over the network. +> - For versions from v8.5.3 to v8.5.6, TiDB reintroduces the telemetry feature. However, it only logs telemetry-related information locally and no longer sends data to PingCAP over the network. > - Starting from v8.5.7, TiDB deprecates this system variable and removes the telemetry feature again. - Scope: GLOBAL From 87b94d84504ae05065ca3b2fc964f120c20ab2db Mon Sep 17 00:00:00 2001 From: lilin90 Date: Thu, 28 May 2026 10:58:46 +0800 Subject: [PATCH 3/3] Update telemetry version ranges and notes MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Adjust telemetry lifecycle wording to match actual releases: expand the removed range from v8.1.0–v8.5.1 to v8.1.0–v8.5.2, and clarify the reintroduced period as v8.5.3–v8.5.6 (telemetry only logs locally). Also reaffirm that telemetry is removed again starting v8.5.7 and add a brief control description to the PD config. Affected files: pd-configuration-file.md, system-variables.md, telemetry.md, tidb-configuration-file.md. --- pd-configuration-file.md | 4 ++-- system-variables.md | 2 +- telemetry.md | 5 +++-- tidb-configuration-file.md | 4 ++-- 4 files changed, 8 insertions(+), 7 deletions(-) diff --git a/pd-configuration-file.md b/pd-configuration-file.md index 8248c2815caa9..03fc363dd4fe7 100644 --- a/pd-configuration-file.md +++ b/pd-configuration-file.md @@ -542,8 +542,8 @@ Configuration items related to the [TiDB Dashboard](/dashboard/dashboard-intro.m > **Warning:** > -> - For versions from v8.1.0 to v8.5.1, TiDB removes the telemetry feature and this configuration item no longer takes effect. It is retained solely for compatibility with earlier versions. -> - Starting from v8.5.3, TiDB reintroduces the telemetry feature. However, it only logs telemetry-related information locally and no longer sends data to PingCAP over the network. +> - For versions from v8.1.0 to v8.5.2, TiDB removes the telemetry feature and this configuration item no longer takes effect. It is retained solely for compatibility with earlier versions. +> - For versions from v8.5.3 to v8.5.6, TiDB reintroduces the telemetry feature. However, it only logs telemetry-related information locally and no longer sends data to PingCAP over the network. > - Starting from v8.5.7, TiDB deprecates this configuration item and removes the telemetry feature again. + Controls whether to enable telemetry collection in TiDB Dashboard. diff --git a/system-variables.md b/system-variables.md index 54ece963d3fab..7825e7eebb05f 100644 --- a/system-variables.md +++ b/system-variables.md @@ -2907,7 +2907,7 @@ Query OK, 0 rows affected (0.09 sec) > **Warning:** > > - For versions earlier than v8.1.0, TiDB periodically reports telemetry data to PingCAP. -> - For versions from v8.1.0 to v8.5.1, TiDB removes the telemetry feature and the `tidb_enable_telemetry` variable no longer takes effect. It is retained solely for compatibility with earlier versions. +> - For versions from v8.1.0 to v8.5.2, TiDB removes the telemetry feature and the `tidb_enable_telemetry` variable no longer takes effect. It is retained solely for compatibility with earlier versions. > - For versions from v8.5.3 to v8.5.6, TiDB reintroduces the telemetry feature. However, it only logs telemetry-related information locally and no longer sends data to PingCAP over the network. > - Starting from v8.5.7, TiDB deprecates this system variable and removes the telemetry feature again. diff --git a/telemetry.md b/telemetry.md index ab26cf226f261..ab34e13bdbd4d 100644 --- a/telemetry.md +++ b/telemetry.md @@ -11,8 +11,9 @@ When the telemetry feature is enabled, TiUP collects usage information and share > **Note:** > > - Starting from TiUP v1.11.3, the telemetry feature in TiUP is disabled by default, which means TiUP usage information is not collected by default. If you upgrade from a TiUP version earlier than v1.11.3 to v1.11.3 or a later version, the telemetry feature keeps the same status as before the upgrade. -> - For versions from v8.1.0 to v8.5.1, the telemetry feature in TiDB and TiDB Dashboard is removed. -> - Starting from v8.5.3, TiDB reintroduces the telemetry feature. However, it only logs telemetry-related information locally and no longer sends data to PingCAP over the network. +> - For versions from v8.1.0 to v8.5.2, the telemetry feature in TiDB and TiDB Dashboard is removed. +> - For versions from v8.5.3 to v8.5.6, TiDB reintroduces the telemetry feature. However, it only logs telemetry-related information locally and no longer sends data to PingCAP over the network. +> - Starting from v8.5.7, the telemetry feature in TiDB and TiDB Dashboard is removed again. ## What is shared when telemetry is enabled? diff --git a/tidb-configuration-file.md b/tidb-configuration-file.md index ee4d875fdd677..abb005895e5b3 100644 --- a/tidb-configuration-file.md +++ b/tidb-configuration-file.md @@ -181,8 +181,8 @@ The TiDB configuration file supports more options than command-line parameters. > **Warning:** > -> - For versions from v8.1.0 to v8.5.1, TiDB removes the telemetry feature and this configuration item no longer takes effect. It is retained solely for compatibility with earlier versions. -> - Starting from v8.5.3, TiDB reintroduces the telemetry feature. However, it only logs telemetry-related information locally and no longer sends data to PingCAP over the network. +> - For versions from v8.1.0 to v8.5.2, TiDB removes the telemetry feature and this configuration item no longer takes effect. It is retained solely for compatibility with earlier versions. +> - For versions from v8.5.3 to v8.5.6, TiDB reintroduces the telemetry feature. However, it only logs telemetry-related information locally and no longer sends data to PingCAP over the network. > - Starting from v8.5.7, TiDB deprecates this configuration item and removes the telemetry feature again. - Controls whether to enable telemetry collection in a TiDB instance.