テレメトリー

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

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

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

以下のセクションでは、 TiUPとTiSparkの共有される使用状況情報について詳しく説明します。共有される使用状況情報は、今後変更される可能性があります。変更があった場合は、リリースノートでお知らせします。

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

TiUP

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

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

PingCAPに共有される使用状況情報の全内容を表示するには、 TiUPコマンド実行時に環境変数TIUP_CLUSTER_DEBUG=enable設定します。例：

TIUP_CLUSTER_DEBUG=enable tiup cluster list

ティスパーク

注記：
v3.0.3 以降、TiSpark ではテレメトリ収集がデフォルトで無効になっており、使用状況情報は収集されず、PingCAP と共有されません。

TiSpark のテレメトリ収集機能が有効になっている場合、Spark モジュールは次のようなもの (ただしこれに限定されません) を含む TiSpark の使用状況の詳細を共有します。

ランダムに生成されたテレメトリ ID。
読み取りエンジンやストリーミング読み取りが有効かどうかなど、TiSpark の一部の構成情報。
TiSpark が配置されているノードのマシンハードウェア情報、OS 情報、コンポーネントバージョン番号などのクラスタ展開情報。

Sparkログに収集されたTiSparkの使用状況情報を表示できます。SparkログレベルをINFO以下に設定できます。例：

grep "Telemetry report" {spark.log} | tail -n 1

テレメトリを有効にする

TiUPテレメトリを有効にする

TiUPテレメトリ収集を有効にするには、次のコマンドを実行します。

tiup telemetry enable

TiSparkテレメトリを有効にする

TiSpark テレメトリ収集を有効にするには、TiSpark 構成ファイルでspark.tispark.telemetry.enable = true構成します。

テレメトリを無効にする

TiUPテレメトリを無効にする

TiUPテレメトリ収集を無効にするには、次のコマンドを実行します。

tiup telemetry disable

TiSparkテレメトリを無効にする

TiSpark テレメトリ収集を無効にするには、TiSpark 構成ファイルでspark.tispark.telemetry.enable = false構成します。

テレメトリステータスを確認する

TiUPテレメトリの場合、次のコマンドを実行してテレメトリのステータスを確認します。

tiup telemetry status

コンプライアンス

さまざまな国や地域のコンプライアンス要件を満たすために、使用情報は送信元マシンの IP アドレスに応じてさまざまな国にあるサーバーに送信されます。

中国本土の IP アドレスの場合、使用情報は中国本土のクラウドサーバーに送信され、保存されます。
中国本土以外の IP アドレスの場合、使用情報は米国のクラウドサーバーに送信され、保存されます。

詳細はPingCAPプライバシーポリシー参照。