収集される内容
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 を設定します。
1、true、yes は、他の構成にかかわらずテレメトリを無効にします。
XBOX_TELEMETRY__ENABLED を false に設定しても無効になります。
すべての新しいターミナルの場合
アカウントに変数を設定します。Windows では次のコマンドを実行してから、ターミナルを開き直します。IDE の統合ターミナルを 使用している場合は IDE も開き直します。PATH に追加したときと同じ方法で、
~/.zshrc や ~/.bashrc などのシェルのスタートアップ ファイルに export 行を追加します。
テレメトリの送信先
リリース ビルドは、Microsoft が所有する Azure Monitor Application Insights リソースにテレメトリを送信します。 この送信先は変更できません。CLI はAPPLICATIONINSIGHTS_CONNECTION_STRING を無視するため、ホストが
独自のアプリケーション用にこの変数を設定しても、CLI のテレメトリがリダイレクトされることはありません。