Le Copilot tableau de bord des métriques d’utilisation, les API et les fichiers d’exportation utilisent tous les mêmes données de télémétrie sous-jacentes, mais ils agrègent et les présentent différemment. La compréhension de ces différences vous aide à rapprocher les nombres entre les sources et à approuver votre analyse lors de la préparation de rapports internes.
- Les tableaux de bord des Copilot métriques d’utilisation sont disponibles au niveau de l’entreprise et de l’organisation.
- Les Copilot API de métriques d’utilisation prennent en charge les enregistrements de niveau entreprise, organisation, référentiel et utilisateur .
- Les totaux au niveau de l’équipe ne sont pas pré-agrégés. Ils sont construits en joignant le rapport des équipes utilisateur au rapport des métriques d’utilisation par utilisateur. Consultez « Métriques d’utilisation Copilot au niveau de l’équipe ».
- Les rapports par dépôt fournissent l’activité quotidienne des pull requests pour les dépôts ayant eu une activité le jour demandé. Consultez « Données disponibles dans les métriques d’utilisation Copilot ».
Prérequis
Les métriques d’utilisation basées sur Copilot l’IDE dépendent des données de télémétrie des IDE des utilisateurs. Si un développeur a désactivé la télémétrie dans son IDE, son activité détaillée basée sur Copilot l’IDE, telle que par IDE, par fonctionnalité et les répartitions de lignes de code, n’apparaît pas dans le tableau de bord, les rapports d’API ou les données exportées. Toutefois, les données de télémétrie côté serveur peuvent toujours exposer ces utilisateurs dans votre nombre d’utilisateurs actifs même lorsque la télémétrie du client n’est pas disponible.
Si vous remarquez des utilisateurs manquants ou des numéros d’adoption inattendus faibles, vérifiez les paramètres de télémétrie de l’IDE avant de résoudre d’autres causes. Pour connaître les versions d’IDE et d’extension prises en charge, consultez Coverage and requirements for Copilot usage metrics.
Copilot CLI Les métriques (daily_active_cli_users et totals_by_cli) sont collectées et signalées séparément des données de télémétrie IDE. L’utilisation de l’interface CLI ne contribue pas aux nombres d’utilisateurs actifs basés sur l’IDE ou à d’autres métriques IDE.
Ne faites pas correspondre totals_by_3rd_party_agent[].user_initiated_interaction_count, qui compte les tâches déclenchées par l’utilisateur agent app, avec le user_initiated_interaction_count de niveau supérieur, qui compte les sollicitations explicites issues d’autres sources de télémétrie prises en charge.
Attribution de l’organisation
Les métriques d’utilisation au niveau Copilot de l’organisation sont basées sur l’appartenance à l’organisation, et non sur l’endroit où des actions individuelles se produisent. Pour apparaître dans les métriques d’une entreprise, un utilisateur doit disposer d’un siège actif Copilot affecté dans cette entreprise.
Une fois qu’un utilisateur dispose d’un siège dans l’entreprise, son utilisation est attribuée à chaque organisation de cette entreprise à laquelle il appartient, quel que soit l’emplacement où le siège est attribué. Par exemple:
- Si des licences sont attribuées dans une organisation dédiée à des fins administratives, les utilisateurs continuent d’apparaître dans les indicateurs des autres organisations de l’entreprise auxquelles ils appartiennent.
- Si un utilisateur dispose également d’un Copilot siège dans une organisation distincte en dehors de l’entreprise, son activité est toujours incluse dans les métriques au niveau de l’organisation de l’entreprise tant qu’elle dispose d’au moins un siège au sein de l’entreprise.
L’utilisation d’un seul utilisateur peut apparaître dans plusieurs tableaux de bord d’organisation, tandis que cet utilisateur n’est compté qu’une seule fois dans le total au niveau de l’entreprise. N’ajoutez pas de totaux au niveau de l’organisation pour calculer un total d’entreprise.
Les rapports au niveau de l’organisation sont disponibles à partir du 12 décembre 2025.
Interprétation des métriques de cycle de vie des requêtes de tirage dans différents contextes.
Les métriques de cycle de vie des demandes de tirage sont disponibles au niveau de l’organisation et de l’entreprise. Lorsque vous comparez des rapports, gardez à l’esprit ce qui suit :
- Déduplication : les rapports au niveau de l’entreprise dédupliquent les utilisateurs au sein des organisations. Les rapports au niveau de l’organisation ne le font pas.
- Données des pull requests uniquement : les métriques du cycle de vie des pull requests peuvent apparaître même si les métriques d’utilisation de l’IDE sont absentes, car les données des pull requests sont dérivées de l’activité du référentiel.
- Moment de l’attribution : si un dépôt ou une organisation est transféré d’un propriétaire à un autre, la création des demandes de tirage, l’examen et les événements de fusion peuvent être attribués à différentes entités en fonction du moment où chaque événement s’est produit.
Alignement des métriques
Le tableau de bord et les API utilisent des définitions partagées pour les métriques clés :
| Concept | Métrique du tableau de bord | Champ d’API ou d’exportation | Remarques |
|---|---|---|---|
| Utilisateurs actifs | Utilisateurs actifs quotidiens/hebdomadaires/totaux | ||
user_initiated_ > 0 | Un utilisateur est considéré comme actif s’il interagit avec Copilot son IDE le jour même. | ||
| Taux d’acceptation | Taux d’acceptation de la complétion de code | ||
code_acceptance_ ÷ code_generation_ | Les deux sources calculent le taux d’acceptation de la même façon, même si l’arrondi peut différer. | ||
| Adoption de l’agent | Graphique d’adoption de l’agent | ||
totals_by_feature where feature = « agent » | Reflète les utilisateurs qui interagissent avec le Copilot agent. | ||
| Utilisation de la langue | Graphiques d’utilisation du langage | ||
totals_by_language_ ou totals_by_language_ | Le tableau de bord visualise ces champs agrégés. | ||
| Cohorte d’adoption/phase | Distribution de cohorte d’adoption (tableau de bord d’impact) | ||
ai_adoption_phase, totals_by_ai_ | Les définitions de phase sont partagées. Le tableau de bord utilise une population glissante sur 28 jours. Dans totals_by_ai_, total_engaged_ compte les utilisateurs actifs sur la journée spécifique de l’enregistrement, tandis que users_in_phase_ contient la population de phases propagée de 28 jours à compter de ce jour. Ne comparez pas le nombre quotidien directement à la population glissante du tableau de bord. Les utilisateurs affichés comme « Chat-first users » dans le tableau de bord correspondent à la valeur de l’API No Cohort. |
Pour obtenir des descriptions complètes des champs, consultez GitHub métriques d’utilisation de Copilot.
Différences entre les rapports
De petites différences entre les données de tableau de bord, les rapports d’API et les exportations sont attendues. Ces variations sont généralement causées par des différences dans les fenêtres de temps, l’étendue ou la fraîcheur des données.
Fenêtres Délai
Chaque source de données agrège les données différemment.
| Origine | Fenêtre de temps | Méthode d’agrégation |
|---|---|---|
| Dashboard | Fenêtre mobile de 28 jours | Les métriques sont agrégées en continu au cours des 28 derniers jours pour faciliter les fluctuations. |
| APIs | Quotidien | Chaque enregistrement représente un jour unique par utilisateur, ce qui active l’analyse des tendances quotidiennes. |
| Exportations NDJSON | Quotidien | Reflète la sortie de l’API pour les outils BI et les rapports à long terme. |
L’alignement de votre période de rapport avec la fenêtre de 28 jours du tableau de bord rend la plupart des comparaisons plus cohérentes. Pour les cohortes d’adoption, distinguez le nombre quotidien total_engaged_users de la population glissante users_in_phase_28d. Alignez la date et l’étendue de l’instantané lors de la comparaison des populations glissantes. N’ajoutez pas de nombres d’utilisateurs actifs quotidiens pour calculer une population distincte de 28 jours, car le même utilisateur peut être actif plusieurs jours.
Télémétrie différée
Étant donné que la télémétrie IDE est traitée de façon asynchrone, les données des derniers jours peuvent apparaître incomplètes ou manquantes. Les données d’un jour donné sont disponibles au plus tard dans les deux jours UTC complets suivant la fin de cette journée. Les baisses apparentes dans les métriques quotidiennes récentes se résorbent souvent une fois la télémétrie traitée.
Gestion des horaires d'exportation
Les fichiers NDJSON reflètent les données disponibles au moment de l’exportation. Si un fichier est téléchargé avant que de nouvelles données de télémétrie ne soient traitées, les données peuvent se retarder derrière le tableau de bord ou l’API. Si votre export inclut des jours toujours compris dans la fenêtre de traitement de deux jours UTC complets, exportez à nouveau les données une fois cette fenêtre close.
Unknown Valeurs
La valeur Unknown apparaît dans certaines répartitions d’API ou d’exportation lorsque les données de télémétrie du client IDE manquent de détails suffisants pour catégoriser l’activité. Ce comportement est attendu et n’indique pas les données manquantes.
| Décomposition | Explanation |
|---|---|
| Language | Indiqué comme Unknown lorsque l’IDE ne peut pas identifier le langage de programmation du fichier actif. |
| Caractéristique | S’affiche lorsqu’un client plus ancien envoie un événement générique sans spécifier de mode conversation (par exemple, chat_panel_unknown_). |
| Model | Apparaît lorsque l’événement ne dispose pas d’informations identifiant le modèle utilisé. Certains modèles internes (par exemple) gpt-4o-minipeuvent apparaître parallèlement Unknown lorsqu’ils sont utilisés pour les opérations non orientées utilisateur, telles que la synthèse ou la détection d’intention. |
Les ventilations des modèles peuvent inclure des modèles que les développeurs n’ont pas sélectionnés directement. Par exemple, Copilot peut utiliser d’autres modèles pour la sélection automatique du modèle ou pour les tâches en arrière-plan.
Unknown les valeurs sont exclues des visualisations de tableau de bord, mais s’affichent dans les données API et NDJSON à des fins d’exhaustivité. La quantité de Unknown données diminue lorsque les utilisateurs effectuent une mise à niveau vers des versions d’IDE et d’extension plus récentes qui envoient des données de télémétrie plus riches.
Utilisateurs identifiés par la télémétrie côté serveur
Copilot Les métriques d’utilisation combinent les données de télémétrie côté client et côté serveur pour identifier les utilisateurs actifs. Les utilisateurs confirmés comme actifs grâce à la télémétrie côté serveur, mais pour lesquels aucune télémétrie côté client n’a été reçue, sont inclus dans votre total d’utilisateurs actifs (par exemple daily_active_users). Le cas échéant, ces utilisateurs peuvent également apparaître dans totals_by_ide (et, dans les rapports par utilisateur, cela inclut les versions les plus récemment détectées de l’IDE et de l’extension Copilot). Toutefois, les autres répartitions dimensionnelles (totals_by_feature, totals_by_language_feature, totals_by_language_model, totals_by_model_feature) et les métriques de lignes de code restent vides.
Cela signifie que le nombre d’utilisateurs actifs de niveau supérieur peut être supérieur à la somme des utilisateurs reflétés dans les tableaux de répartition. Ce comportement est attendu et n’indique pas d’erreur de données.
Résolution des problèmes liés aux données d’utilisation manquantes
Les répartitions détaillées dépendent des données de télémétrie côté client de l’IDE ou Copilot CLI. Cette télémétrie fournit des données sur les fonctionnalités, les langages, les modèles, les suggestions acceptées et les lignes de code. Les données de télémétrie côté serveur peuvent montrer qu’un utilisateur était actif, mais elles ne peuvent pas observer ce qui se passe dans l’éditeur.
Avant d’examiner un écart, attendez deux jours UTC complets après la fermeture du jour d’activité pour le traitement. Si la télémétrie côté client est toujours manquante, les rapports peuvent contenir des nombres inférieurs ou des répartitions vides même lorsque les données côté serveur affichent l’activité. Les causes courantes sont les suivantes :
| Cause | Effet sur vos rapports | Ce que vous pouvez vérifier |
|---|---|---|
La télémétrie est désactivée dans l’IDE, par exemple avec le telemetry.telemetry paramètre dans VS Code. | L’IDE n’envoie aucune activité détaillée. L’utilisateur peut toujours être considéré comme actif par le biais de la télémétrie côté serveur, mais les répartitions par fonctionnalité, langue et lignes de code sont vides. | Vérifiez que la télémétrie IDE est activée pour vos développeurs. |
| Un proxy réseau, un pare-feu ou un VPN bloque le Copilot point de terminaison de télémétrie. | Identique lorsque la télémétrie est désactivée. | Autorisez le point de terminaison de télémétrie du Copilot client. Consultez « Référentiel de la liste d'autorisation de Copilot ». |
| Le client n’est pas un IDE pris en charge et n’envoie Copilot pas de données de télémétrie. | L’utilisateur peut être considéré comme actif par le biais de données de télémétrie côté serveur, mais le client n’apparaît pas dans totals_by_ide des répartitions détaillées. | Utilisez un IDE pris en charge pour les métriques complètes. |
Si un écart persiste après avoir vérifié les causes ci-dessus, contactez contactez-nous via le portail GitHub Support et incluez les utilisateurs concernés, les IDEs, les versions et les dates.