Ce qui est recueilli
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é sous la forme
unknown ou omis; ainsi, une valeur
tapée au mauvais endroit n’est jamais envoyée.
Emplacement approximatif
La CLI n’envoie jamais votre emplacement. Toutefois, Application Insights déduit un emplacement approximatif (pays, région ou province/É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 sert uniquement à comprendre l’adoption dans les différents marchés. La désactivation arrête toute
la télémétrie, y compris cet emplacement.
Ce qui n’est pas recueilli
La CLI ne recueille pas les valeurs des arguments ou des options, les corps des requêtes ou des réponses, 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 fichier, les secrets configurés, les messages d’erreur ni le nom de l’ordinateur.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; ainsi, la commande n’attend 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 pourrait ne pas s’exécuter de nouveau, elle envoie plutôt 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
retire pas.
Avis à la première exécution
La première fois que la CLI recueille de la télémétrie sur un ordinateur, elle écrit cet avis sur stderr, une seule fois :Désactivation
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 la commande suivante, 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 façon que 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 changer. La CLI ignoreAPPLICATIONINSIGHTS_CONNECTION_STRING; ainsi, un hôte qui
la définit pour sa propre application ne redirige pas la télémétrie de la CLI.