Le tableau de bord des mesures d’utilisation Copilot, les API et les fichiers d’exportation utilisent tous les mêmes données télémétriques sous-jacentes, mais ils les 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 métriques d’utilisation Copilot sont disponibles au niveau de l’entreprise et de l’organisation .
- Les API de métriques d’utilisation Copilot prennent en charge les enregistrements au niveau de l’entreprise, de l’organisation et des utilisateurs.
Prérequis
Les métriques d’utilisation basées sur l’IDE Copilot 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é basée sur l’IDE Copilot n’apparaît pas dans le tableau de bord, les rapports d’API ou les données exportées.
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.
Les métriques de Copilot CLI (daily_active_cli_users et totals_by_cli) sont collectées et rapportées séparément de la télémétrie de l’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.
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_interaction_count` > 0 | Un utilisateur est considéré comme actif s’il interagit avec Copilot dans son IDE le jour même. |
| Taux d’acceptation | Taux d’acceptation de la complétion de code |
code_acceptance_activity_count ÷ code_generation_activity_count | 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 agent Copilot. |
| Utilisation de la langue | Graphiques d’utilisation du langage |
totals_by_language_feature ou totals_by_language_model | Le tableau de bord visualise ces champs agrégés. |
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 garantit des comparaisons cohérentes.
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 sont généralement finalisées dans un délai de trois jours UTC complets. Les baisses apparentes dans les métriques quotidiennes récentes se résolvent souvent une fois que la télémétrie est entièrement 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. La réexportation du fichier après la fenêtre de trois jours fournit l’affichage le plus précis.
`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_mode). |
| 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. |
`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.