テレメトリー

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

注記：
TiUP v1.11.3 以降では、 TiUPのテレメトリ機能はデフォルトで無効になっています。つまり、 TiUP の使用状況情報はデフォルトでは収集されません。TiUP バージョンTiUPより前のバージョンから v1.11.3 以降のバージョンにアップグレードすると、テレメトリ機能はアップグレード前と同じ状態を維持します。
TiSpark v3.0.3 以降では、TiSpark のテレメトリ機能はデフォルトで無効になっており、TiSpark の使用状況情報はデフォルトでは収集されません。
v8.1.0 以降では、TiDB および TiDB ダッシュボードのテレメトリ機能が削除されます。

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

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

注記：
いずれの場合も、TiDB クラスターに保存されているユーザーデータは共有されません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 以下に設定できます。例:

cat {spark.log} | grep Telemetry report | 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 プライバシーポリシー参照。