收集的内容
每次运行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:
针对当前 shell 会话
在 PowerShell 中设置XBOX_TELEMETRY_OPTOUT:
1、true 和 yes 会关闭遥测,无论其他配置如何。将
XBOX_TELEMETRY__ENABLED 设置为 false 也会关闭遥测。
针对每个新终端
为你的帐户设置该变量。在 Windows 上,运行以下命令,然后重新打开终端;如果你使用 IDE 的集成终端,还需重新打开 IDE:export 行添加到 shell 的启动文件(例如 ~/.zshrc 或
~/.bashrc)中,方法与安装将 CLI 添加到 PATH 的方法相同。
遥测数据的去向
发布版本会将遥测数据发送到 Microsoft 拥有的 Azure Monitor Application Insights 资源,你无法更改该资源。CLI 会忽略APPLICATIONINSIGHTS_CONNECTION_STRING,因此为自己的应用程序设置该变量的主机不会重定向 CLI 的遥测数据。