GitHub CLI collecte désormais une télémétrie pseudonymisée

• La télémétrie pseudonymisée est envoyée par GitHub CLI afin d’obtenir de la visibilité sur l’usage des fonctionnalités et d’aider à améliorer le produit
• L’adoption des sous-commandes et les habitudes d’utilisation des flags servent à définir les priorités, à évaluer si les besoins des utilisateurs sont satisfaits, et à réexaminer la discoverability ainsi que le design
• Grâce à une implémentation open source, il est possible d’examiner directement le code de télémétrie dans le dépôt cli/cli, et le mode logging permet de voir la charge utile JSON avant tout envoi réel
• L’opt-out est possible via les variables d’environnement GH_TELEMETRY=false, DO_NOT_TRACK=true ou gh config set telemetry disabled, les variables d’environnement ayant priorité sur la configuration
• Les événements de télémétrie sont envoyés vers l’infrastructure d’analyse interne de GitHub ; cette page traite uniquement de la collecte de données côté client de gh, tandis que les extensions et Copilot CLI relèvent d’un cadre distinct

---

Télémétrie

• GitHub CLI envoie une télémétrie pseudonymisée afin de contribuer à l’amélioration du produit
• Des informations sont fournies pour permettre aux utilisateurs de comprendre quelles données sont envoyées et pourquoi

Pourquoi collecter la télémétrie

• La nécessité d’obtenir de la visibilité sur l’usage des fonctionnalités de GitHub CLI est mentionnée, en particulier avec l’augmentation de l’adoption agentique, afin de comprendre comment l’outil est réellement utilisé
  • L’équipe utilise ces données pour définir les priorités de travail
  • Elles servent à évaluer si les fonctionnalités répondent réellement aux besoins des utilisateurs
• L’objectif affiché est aussi de vérifier l’adoption après le lancement de nouvelles sous-commandes
  • Si presque personne ne les utilise, il peut être nécessaire de réexaminer la discoverability ou le design de la fonctionnalité
  • Si un usage élevé est constaté avec certains flags, cela permet d’identifier où investir pour proposer une meilleure expérience

Examiner la télémétrie

• GitHub CLI est open source, et l’implémentation de la télémétrie peut être examinée directement dans le dépôt cli/cli
• Pour voir les données qui seraient envoyées sans effectuer d’envoi réel, il est possible d’utiliser le mode logging
  • Méthode par variable d’environnement prise en charge
    • export GH_TELEMETRY=log
  • Méthode via la configuration CLI prise en charge
    • gh config set telemetry log
• En mode logging, la charge utile JSON qui serait normalement envoyée est affichée sur stderr
  • Cela permet de vérifier chaque champ avant de décider de laisser la télémétrie activée
  • Un exemple de commande est donné avec GH_TELEMETRY=log gh repo list --archived
• Les informations d’événement incluses dans l’exemple de payload sont précisées
  • Type d’événement : command_invocation
  • Les dimensions incluent agent, architecture, command, device_id, flags, invocation_id, is_tty, os, timestamp, version
  • Les exemples de valeurs indiquent architecture: arm64, command: gh repo list, flags: archived, os: darwin, version: 2.91.0
• Cette commande ne peut consigner en log que la télémétrie liée à la commande exacte exécutée et à son contexte
  • Si la variable d’environnement change, les events et les dimensions d’événement inclus dans le payload peuvent aussi changer
  • Les éléments inclus peuvent également varier si le compte authentifié change

Comment se désinscrire

• Il est possible de faire un opt-out de la télémétrie vérifiée en mode logging
• Méthode par variable d’environnement prise en charge
  • export GH_TELEMETRY=false
  • Les valeurs falsy 0, false, disabled, et la chaîne vide peuvent être utilisées
  • La convention DO_NOT_TRACK est également prise en charge, avec l’exemple export DO_NOT_TRACK=true
• Méthode via la configuration CLI prise en charge
  • gh config set telemetry disabled
• Les variables d’environnement ont priorité sur la valeur de configuration

Où les données sont envoyées

• Les événements de télémétrie sont envoyés vers l’infrastructure d’analyse interne de GitHub
• Pour plus d’informations sur le traitement des données, il est recommandé de consulter la GitHub General Privacy Statement

Informations supplémentaires

• GitHub CLI permet d’ajouter des fonctionnalités via l’installation d’extensions GitHub et tierces, y compris des agents
• Ces extensions peuvent collecter leurs propres données d’usage
  • Elles ne sont pas contrôlées par les paramètres d’opt-out
  • Il faut consulter la documentation de chaque extension pour savoir comment la télémétrie est envoyée et si elle peut être désactivée
• Cette page traite uniquement de la collecte de données côté client du CLI GitHub gh
  • Elle ne s’applique pas à GitHub Copilot ni à Copilot CLI
  • Copilot CLI gère séparément sa collecte de données
  • Les ressources indiquées sont Using GitHub Copilot CLI et Responsible Use of the GitHub Copilot CLI