テレメトリ

バージョン 1.7.0 以降、hf_xet Python パッケージおよび hf-xet Rust クレートは、各アップロードとダウンロードの後に Hub へ短いレポートを送信します。これらのレポートを用いて、hf_xet のバージョン、オペレーティングシステム、ネットワークごとに転送が失敗する頻度や速度を把握し、問題の特定と修正を行います。

Git Xet 0.2.1 以前のバージョンでは、テレメトリを送信しません。

収集される情報

各レポートは1つの転送を説明します。1つのコミットで複数のファイルをアップロードすることも、一度に複数のファイルをダウンロードすることも、それぞれ1つの転送に該当します。

レポートには、ファイル名、ファイルパス、ファイル内容、ファイルハッシュ、リポジトリ名、ユーザー名は含まれません。

レポートは、転送と同じアクセストークンを使用して Xet ストレージサーバーに送信されます。サーバーがレポートを保存する際、あなたの IP アドレス、トークンが属する Hub アカウント（ログインしていない場合は「anonymous」）、トークンが発行されたリポジトリ、およびトークンが読み取りアクセスまたは書き込みアクセスを許可しているかどうかを追加します。

レポートが送信されるタイミング

hf_xet は、アップロードまたはダウンロードが完了した時点で、成功したかどうかにかかわらず、1回レポートを送信します。5分以上実行される転送では、完了するまで5分ごとに進捗レポートが送信されます。

レポートは約 1 KB です。転送と同時送信され、転送速度を低下させることはありません。レポートの送信に失敗した場合は破棄され、再試行は行われません。転送が完了すると、hf_xet は最後のレポートが送信されるまで最大 2 秒間待機するため、プログラムが即座に終了してもレポートが失われることはありません。

オプトアウト

テレメトリはデフォルトで有効になっています。無効にするには、HF_HUB_DISABLE_TELEMETRY=1を設定してください:

export HF_HUB_DISABLE_TELEMETRY=1

これは、huggingface_hub およびその他の Hugging Face Python ライブラリでテレメトリを無効にするのと同じ変数です。huggingface_hub のドキュメントの HF_HUB_DISABLE_TELEMETRY を参照してください。

hf_xet は、DO_NOT_TRACK、DISABLE_TELEMETRY、HF_HUB_OFFLINE、または TRANSFORMERS_OFFLINE が 1、true、yes、または on に設定されている場合も、テレメトリを無効にします。

hf_xet のテレメトリのみを無効にするには、HF_XET_TELEMETRY_ENABLED=0 を設定してください。