メインコンテンツへスキップ
XBOX CLI は、どのコマンドが使用されているか、それらの信頼性、所要時間を Microsoft が把握できるように、 限られた匿名の使用状況テレメトリを収集します。テレメトリは無効にすることができます。テレメトリによって コマンドの出力や終了コードが変わることはありません。 Microsoft は、Microsoft のプライバシーに関する声明に記載されているとおりに このデータを取り扱います。ソフトウェアによるデータ収集については、リポジトリの プライバシーに関する通知で説明しています。

収集される内容

xbox を実行するたびに、最大 1 つのイベント xbox.cli.command_invocation が作成されます。このイベントには次のフィールドのみが 含まれ、それ以外は含まれません。 CLI で定義されていないコマンド名やオプション名は、unknown として送信されるか除外されるため、誤った場所に 入力された値が送信されることはありません。

おおよその位置情報

CLI が位置情報を送信することはありません。ただし、Application Insights は、イベントを送信する IP アドレスから おおよその位置情報 (国、地域または州、都市) を推定し、すべてのイベントに保存します。IP アドレス自体は 保持されず、0.0.0.0 として保存されます。この位置情報は、各市場での普及状況を把握するためにのみ使用されます。 オプトアウトすると、この位置情報を含むすべてのテレメトリが停止します。

収集されない内容

CLI は、引数やオプションの値、リクエストやレスポンスの本文、PlayFab タイトル ID、販売者 ID、サンドボックス ID、ユーザー名、テナント ID やアカウント ID、アクセス トークン、ファイル パス、 構成されたシークレット、エラー メッセージ、マシン名を収集しません。

イベントが送信されるタイミング

コマンドが成功すると、CLI はイベントをディスクに保存し、後の実行でそのイベントを送信します。そのため、 コマンドがネットワークを待つことはありません。コマンドが失敗すると、CLI はそのイベントと保存済みのイベントの送信を最大 300 ミリ秒待機します。CLI が再度実行されない可能性がある CI では、イベントを保存する代わりに、 終了前にイベントを送信します。エンドポイントが遅い場合は最大で約 5 秒かかることがあり、その時間内に送信されなかった イベントは破棄されます。

バージョン ヘッダー

テレメトリとは別に、CLI がアクセス トークンと共に送信するすべてのリクエストには、XboxDevCLI/0.1.0.9 のような User-Agent: XboxDevCLI/<version> ヘッダーが含まれます。これにより、各サービスはどの CLI バージョンから呼び出されているかを 判別できます。このヘッダーにはそれ以外の情報は含まれず、テレメトリをオプトアウトしても 削除されません。

初回実行時の通知

CLI がマシンで初めてテレメトリを収集するときに、次の通知を stderr に 1 回だけ書き込みます。

オプトアウト

1 つのコマンドの場合

--disable-telemetry を渡します。

現在のシェル セッションの場合

PowerShell で XBOX_TELEMETRY_OPTOUT を設定します。
bash または zsh の場合:
値 1、true、yes は、他の構成にかかわらずテレメトリを無効にします。 XBOX_TELEMETRY__ENABLED を false に設定しても無効になります。

すべての新しいターミナルの場合

アカウントに変数を設定します。Windows では次のコマンドを実行してから、ターミナルを開き直します。IDE の統合ターミナルを 使用している場合は IDE も開き直します。
Linux と macOS では、インストールで CLI を PATH に追加したときと同じ方法で、 ~/.zshrc や ~/.bashrc などのシェルのスタートアップ ファイルに export 行を追加します。

テレメトリの送信先

リリース ビルドは、Microsoft が所有する Azure Monitor Application Insights リソースにテレメトリを送信します。 この送信先は変更できません。CLI は APPLICATIONINSIGHTS_CONNECTION_STRING を無視するため、ホストが 独自のアプリケーション用にこの変数を設定しても、CLI のテレメトリがリダイレクトされることはありません。
最終更新日 2026年11月19日