{"meta":{"title":"Rapprochement des métriques d’utilisation de Copilot entre les tableaux de bord, les API et les rapports","intro":"Copilot Les métriques d’utilisation sont dérivées des mêmes données de télémétrie sous-jacentes, mais sont agrégées et présentées différemment entre les tableaux de bord, les API et les rapports exportés.","product":"GitHub Copilot","breadcrumbs":[{"href":"/fr/enterprise-cloud@latest/copilot","title":"GitHub Copilot"},{"href":"/fr/enterprise-cloud@latest/copilot/reference","title":"Informations de référence"},{"href":"/fr/enterprise-cloud@latest/copilot/reference/copilot-usage-metrics","title":"Métriques d’utilisation de Copilot"},{"href":"/fr/enterprise-cloud@latest/copilot/reference/copilot-usage-metrics/reconciling-usage-metrics","title":"Rapprochement des métriques d’utilisation de Copilot"}],"documentType":"article"},"body":"# Rapprochement des métriques d’utilisation de Copilot entre les tableaux de bord, les API et les rapports\n\nCopilot Les métriques d’utilisation sont dérivées des mêmes données de télémétrie sous-jacentes, mais sont agrégées et présentées différemment entre les tableaux de bord, les API et les rapports exportés.\n\nLe 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.\n\n* Les tableaux de bord des Copilot métriques d’utilisation sont disponibles au niveau **de l’entreprise** et de **l’organisation**.\n* Les Copilot API de métriques d’utilisation prennent en charge les enregistrements **de niveau entreprise, organisation, référentiel et utilisateur** .\n* 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](/fr/enterprise-cloud@latest/copilot/reference/copilot-usage-metrics/team-level-metrics) ».\n* 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](/fr/enterprise-cloud@latest/copilot/reference/copilot-usage-metrics/copilot-usage-metrics#repository-level-fields-api-only) ».\n\n## Prérequis\n\nLes 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.\n\nSi 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.\n\nCopilot 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.\n\nNe 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.\n\n## Alignement des métriques\n\nLe tableau de bord et les API utilisent des définitions partagées pour les métriques clés :\n\n| Concept                                                             | Métrique du tableau de bord                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | Champ d’API ou d’exportation | Remarques |\n| :------------------------------------------------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------------------------- | :-------- |\n| Utilisateurs actifs                                                 | Utilisateurs actifs quotidiens/hebdomadaires/totaux                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |                              |           |\n| `user_initiated_interaction_count` > 0                              | Un utilisateur est considéré comme actif s’il interagit avec Copilot son IDE le jour même.                                                                                                                                                                                                                                                                                                                                                                                                                                       |                              |           |\n| Taux d’acceptation                                                  | Taux d’acceptation de la complétion de code                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |                              |           |\n| `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.                                                                                                                                                                                                                                                                                                                                                                                                                              |                              |           |\n| Adoption de l’agent                                                 | Graphique d’adoption de l’agent                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |                              |           |\n| `totals_by_feature` where feature = « agent »                       | Reflète les utilisateurs qui interagissent avec le Copilot agent.                                                                                                                                                                                                                                                                                                                                                                                                                                                                |                              |           |\n| Utilisation de la langue                                            | Graphiques d’utilisation du langage                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |                              |           |\n| `totals_by_language_feature` ou `totals_by_language_model`          | Le tableau de bord visualise ces champs agrégés.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |                              |           |\n| Cohorte d’adoption/phase                                            | Distribution de cohorte d’adoption (tableau de bord d’impact)                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |                              |           |\n| `ai_adoption_phase`, `totals_by_ai_adoption_phase`                  | Les définitions de phase sont partagées, mais les populations diffèrent. Le tableau de bord inclut tous les utilisateurs actifs sur les 28 derniers jours, tandis que le champ agrégé `totals_by_ai_adoption_phase` compte les utilisateurs actifs à la date spécifique de l’enregistrement. Les nombres et pourcentages de cohortes du tableau de bord et de l’API ne correspondent donc pas. Les utilisateurs affichés comme « Utilisateurs passifs » dans le tableau de bord correspondent à la valeur de l’API `No Cohort` . |                              |           |\n\nPour obtenir des descriptions complètes des champs, consultez [GitHub métriques d’utilisation de Copilot](/fr/enterprise-cloud@latest/copilot/reference/copilot-usage-metrics).\n\n## Différences entre les rapports\n\nDe 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.\n\n### Fenêtres Délai\n\nChaque source de données agrège les données différemment.\n\n| Origine             | Fenêtre de temps           | Méthode d’agrégation                                                                                                 |\n| :------------------ | :------------------------- | :------------------------------------------------------------------------------------------------------------------- |\n| 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.               |\n| APIs                | Quotidien                  | Chaque enregistrement représente un jour unique par utilisateur, ce qui active l’analyse des tendances quotidiennes. |\n| Exportations NDJSON | Quotidien                  | Reflète la sortie de l’API pour les outils BI et les rapports à long terme.                                          |\n\nL’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. Toutefois, cela ne permet pas de faire correspondre les décomptes des cohortes d’adoption, car le tableau de bord compte les utilisateurs distincts sur l’ensemble de la période, tandis que les champs agrégés de l’API contiennent des décomptes quotidiens.\n\n### Télémétrie différée\n\nÉ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.\n\n### Gestion des horaires d'exportation\n\nLes 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.\n\n## `Unknown` Valeurs\n\nLa 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.\n\n| Décomposition   | Explanation                                                                                                                                                                                                                                                                                                           |\n| :-------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| Language        | Indiqué comme `Unknown` lorsque l’IDE ne peut pas identifier le langage de programmation du fichier actif.                                                                                                                                                                                                            |\n| 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`).                                                                                                                                                                    |\n| 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-mini`peuvent 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. |\n\n`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.\n\n## Utilisateurs identifiés par la télémétrie côté serveur\n\nCopilot 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.\n\nCela 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."}