大网数据广告活动
数据库部署与 SQL 参考

遥测

· 52CE 我爱测

以下章节具体描述了 TiUP 收集并分享的使用情况信息。若收集的使用情况信息有变化,将在版本更新说明中告知。

遥测

开启遥测后,TiUP 会收集使用情况信息,并将这些信息分享给 {{{ .company }}} 用于改善产品。

注意:

  • 从 TiUP v1.11.3 起,TiUP 遥测功能默认关闭,即 TiUP 默认不再收集使用情况信息。如果从 v1.11.3 之前的 TiUP 版本升级至 v1.11.3 或更高 TiUP 版本,遥测保持升级前的开启或关闭状态。
  • 在 v8.1.0 到 v8.5.2 及其之间的版本中,TiDB 和 TiDB Dashboard 移除了遥测功能。
  • 在 v8.5.3 到 v8.5.6 及其之间的版本中,TiDB 重新引入遥测功能,但其行为已更改为仅将遥测相关信息输出到日志文件,不再通过网络发送给 {{{ .company }}}。
  • 从 v8.5.7 开始,TiDB 和 TiDB Dashboard 中的遥测功能已被弃用。

开启遥测后哪些使用情况信息会被收集?

以下章节具体描述了 TiUP 收集并分享的使用情况信息。若收集的使用情况信息有变化,将在版本更新说明中告知。

注意:

在任何情况下,集群中用户存储的数据都不会被收集。另请参阅隐私政策。

当 TiUP 遥测功能开启时,执行 TiUP 命令时会将使用情况信息分享给 {{{ .company }}},包括(但不限于):

  • 随机生成的遥测标示符
  • TiUP 命令的执行情况,如命令执行是否成功、命令执行耗时等
  • 使用 TiUP 进行部署的情况,如部署的目标机器硬件信息、组件版本号、修改过的部署配置名称等

使用 TiUP 时,可通过设置 TIUP_CLUSTER_DEBUG=enable 环境变量输出执行命令时收集的使用情况信息,例如:

TIUP_CLUSTER_DEBUG=enable tiup cluster list

开启遥测功能

可通过执行以下命令开启 TiUP 遥测功能:

tiup telemetry enable

禁用遥测功能

可通过执行以下命令禁用 TiUP 遥测功能:

tiup telemetry disable

查看遥测启用状态

对于 TiUP 遥测,可通过执行以下命令查看遥测状态:

tiup telemetry status

使用情况信息合规性

为了满足不同国家或地区对于此类信息的合规性要求,使用情况信息会按照不同的操作者 IP 地址发送到位于不同国家的服务器,具体如下:

  • 若为中国大陆 IP 地址,使用情况信息将会发送并存储于中国大陆境内的公有云服务器。
  • 若为中国大陆以外 IP 地址,使用情况信息将会发送并存储于美国的公有云服务器。

可参阅隐私政策了解详情。

本文来自 PingCAP / TiDB 文档贡献者,按 CC BY-SA 3.0 整理版式与相对链接,保留正文与代码。图示请参阅原文。作者与贡献记录。

资料来源与适用范围

资料来源
PingCAP / TiDB 文档贡献者
适用范围
master 文档快照(2026-11-16)
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY-SA 3.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。