Données collectées
Chaque exécution dexbox crée au plus un événement, xbox.cli.command_invocation, avec ces champs
et rien d’autre :
Un nom de commande ou d’option que la CLI ne définit pas est envoyé comme
unknown ou omis : une valeur
saisie au mauvais endroit n’est donc jamais envoyée.
Emplacement approximatif
La CLI n’envoie jamais votre emplacement. Toutefois, Application Insights déduit un emplacement approximatif (pays, région ou état, et ville) à partir de l’adresse IP qui envoie l’événement, et le stocke avec chaque événement. L’adresse IP elle-même n’est pas conservée ; elle est stockée sous la forme0.0.0.0. L’emplacement
est utilisé uniquement pour comprendre l’adoption selon les marchés. La désactivation arrête toute
télémétrie, y compris cet emplacement.
Données non collectées
La CLI ne collecte pas les valeurs des arguments ou des options, les corps de requête ou de réponse, les ID de titre PlayFab, les ID de vendeur, les ID de sandbox, les noms d’utilisateur, les ID de locataire ou de compte, les jetons d’accès, les chemins de fichiers, les secrets configurés, les messages d’erreur ni le nom de la machine.Moment de l’envoi de l’événement
Lorsqu’une commande réussit, la CLI enregistre l’événement sur le disque, et une exécution ultérieure l’envoie : la commande n’attend donc pas le réseau. Lorsqu’une commande échoue, la CLI attend au plus 300 millisecondes pour envoyer son événement et ceux qui ont été enregistrés. En CI, où la CLI risque de ne pas être exécutée à nouveau, elle envoie l’événement avant de se terminer au lieu de l’enregistrer. Cela peut ajouter jusqu’à environ 5 secondes lorsque le point de terminaison est lent, et l’événement est abandonné s’il n’est pas envoyé dans ce délai.En-tête de version
Indépendamment de la télémétrie, chaque requête que la CLI envoie avec un jeton d’accès comporte un en-têteUser-Agent: XboxDevCLI/<version>, comme XboxDevCLI/0.1.0.9, afin que ces services puissent
savoir quelles versions de la CLI les appellent. Il ne contient rien d’autre, et la désactivation de la télémétrie ne
le supprime pas.
Avis lors de la première exécution
La première fois que la CLI collecte de la télémétrie sur une machine, elle écrit cet avis sur stderr, une seule fois :Désactiver la télémétrie
Pour une seule commande
Passez--disable-telemetry :
Pour la session de shell actuelle
DéfinissezXBOX_TELEMETRY_OPTOUT dans PowerShell :
1, true et yes désactivent la télémétrie, quelle que soit la configuration par ailleurs. Définir
XBOX_TELEMETRY__ENABLED sur false la désactive également.
Pour chaque nouveau terminal
Définissez la variable pour votre compte. Sous Windows, exécutez cette commande, puis rouvrez votre terminal, ainsi que votre IDE si vous utilisez son terminal intégré :export au fichier de démarrage de votre shell, comme ~/.zshrc ou
~/.bashrc, de la même manière que la page Installation ajoute la CLI au PATH.
Destination de la télémétrie
Les builds de version envoient la télémétrie à une ressource Azure Monitor Application Insights appartenant à Microsoft, que vous ne pouvez pas modifier. La CLI ignoreAPPLICATIONINSIGHTS_CONNECTION_STRING : un hôte qui
la définit pour sa propre application ne redirige donc pas la télémétrie de la CLI.