收集的內容
每次執行xbox 最多會建立一個事件 xbox.cli.command_invocation,只包含下列欄位,不含其他任何內容:
CLI 未定義的命令或選項名稱會以
unknown 傳送或予以省略,因此輸入在錯誤位置的值絕不會被傳送。
大概位置
CLI 絕不會傳送您的位置。不過,Application Insights 會從傳送事件的 IP 位址推導出大概位置 (國家/地區、區域或州,以及城市),並將其儲存在每個事件上。IP 位址本身不會保留;它會儲存為0.0.0.0。此位置僅用於了解各市場的採用情況。選擇退出會停止所有遙測,包括此位置。
不會收集的內容
CLI 不會收集引數或選項值、要求或回應本文、PlayFab 遊戲 ID、賣方 ID、沙箱 ID、使用者名稱、租用戶或帳戶 ID、存取權杖、檔案路徑、設定的祕密、錯誤訊息或電腦名稱。事件的傳送時機
當命令成功時,CLI 會將事件儲存在磁碟上,並由之後的執行傳送,因此命令不需要等候網路。當命令失敗時,CLI 最多會等候 300 毫秒,以傳送其事件和任何已儲存的事件。在 CI 中,由於 CLI 可能不會再次執行,它會在結束之前傳送事件,而不是將其儲存。當端點速度緩慢時,這可能會增加最多約 5 秒,而如果事件未在該時間內傳送,就會被捨棄。版本標頭
與遙測分開,CLI 使用存取權杖傳送的每個要求都會帶有User-Agent: XboxDevCLI/<version> 標頭 (例如 XboxDevCLI/0.1.0.9),讓這些服務可以分辨哪些 CLI 版本在呼叫它們。此標頭不包含其他任何內容,而選擇退出遙測並不會將其移除。
首次執行揭露
CLI 第一次在電腦上收集遙測時,會將此通知寫入 stderr 一次:選擇退出
針對單一命令
傳遞--disable-telemetry:
針對目前的殼層工作階段
在 PowerShell 中設定XBOX_TELEMETRY_OPTOUT:
1、true 和 yes 會關閉遙測,無論其他設定為何。將 XBOX_TELEMETRY__ENABLED 設定為 false 也會將其關閉。
針對每個新的終端機
為您的帳戶設定變數。在 Windows 上,請執行下列命令,然後重新開啟您的終端機,如果您使用 IDE 的整合式終端機,也請重新開啟 IDE:export 行新增至殼層的啟動檔案 (例如 ~/.zshrc 或 ~/.bashrc),方式與安裝將 CLI 新增至 PATH 相同。
遙測的傳送目的地
發行組建會將遙測傳送至 Microsoft 擁有的 Azure Monitor Application Insights 資源,您無法變更此資源。CLI 會忽略APPLICATIONINSIGHTS_CONNECTION_STRING,因此為自己的應用程式設定此變數的主機,不會重新導向 CLI 的遙測。