| title | summary | aliases | ||
|---|---|---|---|---|
遥测 |
介绍遥测的场景，如何禁用功能和查看遥测状态。 |
|
开启遥测后，TiUP 会收集使用情况信息，并将这些信息分享给 PingCAP 用于改善产品。
注意：
- 从 TiUP v1.11.3 起，TiUP 遥测功能默认关闭，即 TiUP 默认不再收集使用情况信息。如果从 v1.11.3 之前的 TiUP 版本升级至 v1.11.3 或更高 TiUP 版本，遥测保持升级前的开启或关闭状态。
- 在 v8.1.0 到 v8.5.1 及其之间的版本中，TiDB 和 TiDB Dashboard 移除了遥测功能。
- 从 TiDB v8.5.3 开始，TiDB 重新引入遥测功能，但其行为已更改为仅将遥测相关信息输出到日志文件，不再通过网络发送给 PingCAP。
以下章节具体描述了 TiUP 收集并分享的使用情况信息。若收集的使用情况信息有变化，将在版本更新说明中告知。
注意：
在任何情况下，集群中用户存储的数据都不会被收集。另请参阅隐私政策。
当 TiUP 遥测功能开启时，执行 TiUP 命令时会将使用情况信息分享给 PingCAP，包括（但不限于）：
- 随机生成的遥测标示符
- 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 地址，使用情况信息将会发送并存储于美国的公有云服务器。
可参阅隐私政策了解详情。