Connectez GitHub Copilot à Observagent.
Utilisez l'export OpenTelemetry de Copilot, individuel ou géré par l'organisation, pour envoyer la télémétrie de Copilot Chat, CLI, et de l'application de bureau à Observagent.
Utiliser l'export OpenTelemetry intégré de Copilot
GitHub Copilot prend en charge l'export OpenTelemetry pour l'extension Copilot Chat dans VS Code, le processus hôte d'agent qui alimente Copilot CLI, et l'application de bureau Copilot. Il y a deux façons de l'activer : un développeur individuel définissant des variables d'environnement dans son propre terminal, ou un administrateur d'organisation distribuant une configuration de télémétrie gérée.
- Une configuration individuelle s'applique uniquement aux instances VS Code lancées depuis la session de terminal où les variables sont définies.
- Une configuration gérée par l'organisation s'applique via
managed-settings.json, MDM natif (Registre Windows ou préférences gérées macOS), ou des paramètres résolus depuis le compte GitHub connecté. - Les deux chemins configurent le point de terminaison d'export OTLP, le transport (
otlp-httpouotlp-grpc), et les en-têtes d'exportateur tels qu'un jeton d'authentification. - Les noms de champs et signaux disponibles peuvent varier selon la version de Copilot ; confirmez le schéma actuel dans la documentation OpenTelemetry de Copilot de GitHub avant un déploiement large.
Offre minimum requise
GitHub Copilot Free (configuration individuelle du client).
- Utilisez un compte avec Copilot activé et un client pris en charge. Les modèles disponibles et les quotas dépendent de l’offre.
- Les paramètres gérés à l’échelle de l’organisation nécessitent les permissions d’administration d’entreprise correspondantes. Vérifiez que votre organisation autorise la configuration de télémétrie.
Conditions examinées le .
Étapes d'intégration
Sélectionnez une plateforme pour voir les commandes et chemins propres à votre ordinateur. La configuration du projet et la vérification de la livraison sont communes à toutes les plateformes.
- Étape 1
Créer un projet et une clé de projet
Dans Observagent, activez Journaux et Métriques sur un projet, activez la surveillance et générez une clé de projet avec la permission telemetry:write.
- Utilisez une clé distincte pour Copilot afin que Observagent puisse attribuer cette source de manière fiable.
- Étape 2
Configurer l'export OTLP individuel
Définissez ces variables dans le terminal à partir duquel vous lancerez VS Code, puis démarrez VS Code depuis cette même session pour qu’il les hérite.
- Les variables d'environnement s'appliquent à cette fenêtre PowerShell ; la fermer les efface sauf si vous les rendez persistantes.
- VS Code n’hérite que des variables définies avant son lancement.
PowerShell$env:OTEL_EXPORTER_OTLP_ENDPOINT = "https://dashboard.observagent.cloud" $env:OTEL_EXPORTER_OTLP_HEADERS = "Authorization=Bearer YOUR_PROJECT_KEY" $env:OTEL_EXPORTER_OTLP_PROTOCOL = "http/protobuf" code . - Étape 3
Ou appliquer une configuration gérée par l’organisation
Sous Windows, un administrateur distribue cette configuration via une politique MDM dans le Registre Windows, ou via le chemin de fichier managed-settings.json documenté par GitHub pour votre version de Copilot.
- Les noms de champs dans la configuration gérée peuvent varier selon la version de Copilot ; confirmez le schéma actuel avant un déploiement large.
- Les paramètres gérés s'appliquent à l'extension Copilot Chat, au processus hôte derrière Copilot CLI et à l'application de bureau Copilot.
- Étape 4
Relancer et vérifier la livraison
Fermez complètement VS Code ou l'application de bureau Copilot, rouvrez-la depuis la session configurée, effectuez une requête Copilot Chat ou CLI, puis vérifiez les journaux et métriques du projet dans Observagent.
- Effectuez une véritable action Copilot Chat ou CLI ; ouvrir l'application seule peut ne pas générer d'événement de requête.
- Laissez jusqu'à une minute pour l'intervalle d'export avant de vérifier dans Observagent.
Diagnostiquer les échecs d'export
- Rien n'arrive après la configuration individuelle : les variables ont été définies dans un terminal, mais VS Code fonctionnait déjà ou a été lancé depuis une session différente qui ne les a jamais vues.
- Le paramètre géré n'a aucun effet : un autre canal de livraison (MDM, politique au niveau du compte, ou un chemin
managed-settings.jsondifférent) a priorité ; vérifiez l'ordre de résolution des paramètres pour votre plateforme. - 401/403 d'Observagent : l'en-tête bearer est manquant, malformé, révoqué, ou manque de
telemetry:write. - Connexion refusée ou incompatibilité de protocole : confirmez que le transport (
otlp-httpvsotlp-grpc) correspond à ce que votre point de terminaison de collecteur attend. - Seules certaines surfaces rapportent : Copilot Chat, Copilot CLI, et l'application de bureau ont été ajoutés à l'export OpenTelemetry géré à des moments différents ; confirmez que vos versions installées le prennent toutes en charge.
Vérifier ce qui est exporté
Traitez l'export OpenTelemetry de Copilot comme de la télémétrie opérationnelle (requêtes, chronométrage, activité d'outils, et erreurs), pas un flux garanti sans invite. Confirmez ce que votre version de Copilot installée inclut dans ses journaux et métriques avant d'activer ceci pour des dépôts contenant du contenu sensible, et préférez le chemin géré avec des en-têtes à moindre privilège pour un déploiement à l'échelle de l'organisation. Observagent applique ses propres contrôles de contenu côté serveur comme limite supplémentaire.