テレメトリー

テレメトリ機能を有効にすると、 TiUP は使用状況情報を収集し、その情報を PingCAP と共有して、製品の改善方法の理解に役立てます。

注記：
TiUP v1.11.3以降、 TiUPのテレメトリ機能はデフォルトで無効化されており、 TiUPの使用状況情報はデフォルトで収集されません。v1.11.3より前のTiUPバージョンからv1.11.3以降のバージョンにアップグレードした場合、テレメトリ機能はアップグレード前と同じ状態を維持します。
バージョン v8.1.0 から v8.5.1 では、TiDB および TiDB ダッシュボードのテレメトリ機能が削除されます。
v8.5.3以降、TiDBはテレメトリ機能を再度導入しました。ただし、テレメトリ関連の情報はローカルにのみ記録され、ネットワーク経由でPingCAPにデータが送信されなくなりました。

テレメトリを有効にすると何が共有されますか?

以下のセクションでは、 TiUPの共有される使用状況情報について詳しく説明します。共有される使用状況情報は、時間の経過とともに変更される可能性があります。これらの変更（もし変更があった場合）は、リリースノートで発表されます。

注記：
いずれの場合も、TiDBクラスタに保存されたユーザーデータは共有されませんPingCAPプライバシーポリシーも参照してください。

TiUPでテレメトリ収集機能が有効になっている場合、次のような (ただしこれらに限定されない) TiUPの使用状況の詳細が共有されます。

ランダムに生成されたテレメトリ ID。
実行が成功したかどうかや実行時間などのTiUPコマンドの実行ステータス。
ハードウェアのサイズ、TiDB コンポーネントのバージョン、変更されたデプロイメント構成名などのデプロイメント特性。

PingCAPに共有される使用状況情報の全内容を表示するには、 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プライバシーポリシー参照。