Pular para o conteúdo principal
A XBOX CLI coleta telemetria de uso limitada e anônima para ajudar a Microsoft a entender quais comandos são usados, quão confiáveis eles são e quanto tempo levam. Você pode desativá-la. A telemetria nunca altera a saída nem o código de saída de um comando. A Microsoft trata esses dados conforme descrito na Política de Privacidade da Microsoft. O aviso de privacidade do repositório abrange a coleta de dados pelo software.

O que é coletado

Cada execução de xbox cria no máximo um evento, xbox.cli.command_invocation, com estes campos e nada mais: Um nome de comando ou de opção que a CLI não define é enviado como unknown ou omitido; portanto, um valor digitado no lugar errado nunca é enviado.

Localização aproximada

A CLI nunca envia a sua localização. No entanto, o Application Insights deriva uma localização aproximada (país, região ou estado e cidade) do endereço IP que envia o evento e a armazena em todos os eventos. O endereço IP em si não é mantido; ele é armazenado como 0.0.0.0. A localização é usada somente para entender a adoção nos diferentes mercados. Recusar interrompe toda a telemetria, incluindo essa localização.

O que não é coletado

A CLI não coleta valores de argumentos ou de opções, corpos de solicitações ou de respostas, IDs de título do PlayFab, IDs de vendedor, IDs de sandbox, nomes de usuário, IDs de locatário ou de conta, tokens de acesso, caminhos de arquivo, segredos configurados, mensagens de erro nem o nome do computador.

Quando o evento é enviado

Quando um comando é bem-sucedido, a CLI salva o evento em disco, e uma execução posterior o envia, para que o comando não precise aguardar a rede. Quando um comando falha, a CLI aguarda no máximo 300 milissegundos para enviar o evento dele e os eventos salvos. Em CI, onde a CLI pode não ser executada novamente, ela envia o evento antes de sair em vez de salvá-lo. Isso pode adicionar até cerca de 5 segundos quando o ponto de extremidade está lento, e o evento é descartado se não for enviado nesse tempo.

Cabeçalho de versão

Separadamente da telemetria, todas as solicitações que a CLI envia com um token de acesso incluem um cabeçalho User-Agent: XboxDevCLI/<version>, como XboxDevCLI/0.1.0.9, para que esses serviços possam saber quais versões da CLI os chamam. Ele não contém mais nada, e recusar a telemetria não o remove.

Aviso na primeira execução

Na primeira vez em que a CLI coleta telemetria em um computador, ela grava este aviso em stderr, uma única vez:

Recusar

Para um único comando

Passe --disable-telemetry:

Para a sessão atual do shell

Defina XBOX_TELEMETRY_OPTOUT no PowerShell:
No bash ou zsh:
Os valores 1, true e yes desativam a telemetria, independentemente do que mais estiver configurado. Definir XBOX_TELEMETRY__ENABLED como false também a desativa.

Para todos os novos terminais

Defina a variável para a sua conta. No Windows, execute isto e, em seguida, reabra o terminal e o IDE, se você usar o terminal integrado dele:
No Linux e no macOS, adicione a linha export ao arquivo de inicialização do shell, como ~/.zshrc ou ~/.bashrc, da mesma forma que a Instalação adiciona a CLI ao PATH.

Para onde a telemetria vai

Os builds de versão enviam a telemetria para um recurso do Azure Monitor Application Insights de propriedade da Microsoft, que você não pode alterar. A CLI ignora APPLICATIONINSIGHTS_CONNECTION_STRING; portanto, um host que a define para o próprio aplicativo não redireciona a telemetria da CLI.
Última modificação em 19 de novembro de 2026