Pourquoi GitHub CLI collecte les données de télémétrie
À mesure que l’usage de GitHub CLI par les agents progresse, la compréhension de l’utilisation réelle des fonctionnalités permet à GitHub d’améliorer le produit. Les données de télémétrie nous aident à hiérarchiser le travail de développement et à évaluer si les fonctionnalités répondent aux besoins réels des utilisateurs.
Par exemple, lorsqu’une nouvelle sous-commande est livrée, la télémétrie indique si quelqu’un l’utilise et comment. Si l’adoption est faible, cela signale un besoin de revoir la détectabilité ou la conception de la fonctionnalité. Lorsqu’une sous-commande est fréquemment utilisée avec certains indicateurs, cela met en évidence les domaines dans lesquels des améliorations de l’expérience sont nécessaires.
Important
Les données de télémétrie ne sont pas collectées lorsque la cible est GitHub Enterprise Server ou que l’utilisateur s’est authentifié auprès d’un hôte GitHub Enterprise Server.
Examen des données de télémétrie
GitHub CLI est open source. Vous pouvez passer en revue l’implémentation de la télémétrie dans le référentiel [cli/cli](https://github.com/cli/cli) . Si vous souhaitez voir exactement ce qui serait envoyé sans l’envoyer réellement, vous pouvez activer le mode de journalisation à l’aide d’une variable d’environnement ou d’une option de configuration.
**Variable d’environnement :**
export GH_TELEMETRY=log
**Configuration de l’interface CLI :**
gh config set telemetry log
En mode journalisation, la charge utile JSON qui serait normalement envoyée est imprimée à stderr à la place. Cela vous permet d’inspecter chaque champ avant de décider s’il faut activer la télémétrie. Par exemple:
GH_TELEMETRY=log gh skill install github/awesome-copilot git-commit --agent github-copilot --scope project
Ceci imprime quelque chose comme :
Telemetry payload:
{
"events": [
{
"type": "skill_install",
"dimensions": {
"agent": "",
"agent_hosts": "github-copilot",
"architecture": "arm64",
"ci": "false",
"device_id": "1e9a73a6-c8bd-4e1e-be02-78f4b11de4e1",
"github_actions": "false",
"invocation_id": "96d4862f-26c9-4385-961d-d749ae519c81",
"is_tty": "true",
"os": "darwin",
"repo_visibility": "public",
"skill_host_type": "github.com",
"skill_names": "git-commit",
"skill_owner": "github",
"skill_repo": "awesome-copilot",
"timestamp": "2026-04-24T11:54:51.057Z",
"upstream_source": "none",
"version": "2.91.0"
}
},
{
"type": "command_invocation",
"dimensions": {
"agent": "",
"architecture": "arm64",
"ci": "false",
"command": "gh skill install",
"device_id": "1e9a73a6-c8bd-4e1e-be02-78f4b11de4e1",
"flags": "agent,scope",
"github_actions": "false",
"invocation_id": "96d4862f-26c9-4385-961d-d749ae519c81",
"is_tty": "true",
"os": "darwin",
"timestamp": "2026-04-24T11:54:51.057Z",
"version": "2.91.0"
}
}
]
}
Certaines commandes peuvent inclure des dimensions de télémétrie supplémentaires en fonction du contexte. Dans cet exemple, les skill_ champs sont inclus, car repo_visibility est public.
Remarque
Cette commande ne peut journaliser que les données de télémétrie pour la commande et le contexte exacts dans lesquels elle s’est exécutée. La modification des variables d’environnement ou des comptes authentifiés peut modifier les événements et les dimensions d’événement incluses dans la charge utile.
Comment refuser
Vous pouvez désactiver les données de télémétrie que vous voyez dans le mode décrit ci-dessus à l’aide log d’une variable d’environnement ou d’une option de configuration.
**Variables d’environnement :**
export GH_TELEMETRY=false
Toute valeur falsy fonctionne : 0, false, disabled ou une chaîne vide. Vous pouvez également utiliser la DO_NOT_TRACK convention :
export DO_NOT_TRACK=true
**Configuration de l’interface CLI :**
gh config set telemetry disabled
Remarque
Les variables d’environnement sont prioritaires sur la valeur de configuration.
Où les données sont envoyées
Les événements de télémétrie sont envoyés à l'infrastructure d'analyses interne de GitHub. Pour plus d’informations sur la façon de GitHub gérer vos données, consultez Déclaration de confidentialité générale GitHub.
Informations supplémentaires
GitHub CLI vous permet d’ajouter des fonctionnalités au produit en installant des extensions développées et tierces, y compris des agents. Ces extensions peuvent collecter leurs propres données d’utilisation et ne sont pas contrôlées par la désactivation. Consultez la documentation de l’extension spécifique pour en savoir plus sur ses rapports de télémétrie et si elle peut être désactivée.
Cette page décrit la collecte de données côté client pour GitHub CLI (gh). Elle ne s'applique pas à GitHub Copilot ou à CLI GitHub Copilot, qui gèrent séparément la collecte de données. Pour plus d’informations sur le CLI GitHub Copilot, consultez À propos de GitHub Copilot CLI et Utilisation responsable de l’interface CLI GitHub Copilot.