{"meta":{"title":"Métriques d’utilisation Copilot au niveau de l’équipe","intro":"Créez des métriques d’utilisation au niveau GitHub Copilot de l’équipe en joignant le rapport quotidien des équipes utilisateur au rapport quotidien des métriques d’utilisation par utilisateur.","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/team-level-metrics","title":"Métriques au niveau de l’équipe"}],"documentType":"article"},"body":"# Métriques d’utilisation Copilot au niveau de l’équipe\n\nCréez des métriques d’utilisation au niveau GitHub Copilot de l’équipe en joignant le rapport quotidien des équipes utilisateur au rapport quotidien des métriques d’utilisation par utilisateur.\n\nLes Copilot API de métriques d’utilisation ne publient pas de rapport d’équipe pré-agrégé unique. Les métriques au niveau de l’équipe sont construites en joignant le rapport des **équipes utilisateur** (qui répertorie les appartenances d’équipe de chaque utilisateur pour un jour donné) avec le rapport **des métriques d’utilisation par utilisateur** (qui contient l’activité de Copilot chaque utilisateur pour ce jour). L’agrégation des lignes jointes par `team_id` produit des métriques au niveau de l’équipe.\n\nLa même méthode de jointure prend en charge tout découpage au niveau des équipes dont vous avez besoin : par `(team, day)`, par `(team, day, language)`, par `(team, day, IDE)`, sur des fenêtres glissantes, et ainsi de suite.\n\n> \\[!NOTE]\n> Si vous avez uniquement besoin d’une vue basée sur l’interface utilisateur de l’adoption au niveau de l’équipe, le mappage de l’équipe utilisateur du tableau de bord d’impact expose les données de cohorte d’adoption au niveau de l’équipe en mode natif, sans vous obliger à créer la jointure décrite dans cet article. Consultez « [Affichage du tableau de bord d’impact Copilot](/fr/enterprise-cloud@latest/copilot/how-tos/administer-copilot/view-impact-dashboard) ». Utilisez la jointure manuelle décrite ci-dessous lorsque vous avez besoin de données NDJSON brutes par équipe, telles que pour les rapports décisionnels personnalisés ou les métriques au niveau de l’équipe au-delà des cohortes d’adoption.\n\n## Extraction des rapports\n\nLes deux rapports référencés dans ce guide sont téléchargés en deux étapes. Tout d’abord, appelez le point de terminaison REST pour le jour souhaité. Le point de terminaison retourne des URL signées limitées dans le temps à partir desquelles vous pouvez télécharger les fichiers de rapport. Téléchargez ensuite les fichiers JSON délimités par des sauts de ligne (NDJSON) auxquels ces URL renvoient. Les lignes d’appartenance utilisateur-équipe et les lignes par utilisateur se trouvent dans ces fichiers NDJSON ; elles ne sont pas renvoyées directement par le point de terminaison REST.\n\n| Report                                                    | Point de terminaison                                                                    |\n| :-------------------------------------------------------- | :-------------------------------------------------------------------------------------- |\n| Équipes d’utilisateurs de l’organisation                  | `GET /orgs/{org}/copilot/metrics/reports/user-teams-1-day?day=YYYY-MM-DD`               |\n| Équipes utilisateur d’entreprise                          | `GET /enterprises/{enterprise}/copilot/metrics/reports/user-teams-1-day?day=YYYY-MM-DD` |\n| Métriques d’utilisation par utilisateur de l’organisation | `GET /orgs/{org}/copilot/metrics/reports/users-1-day?day=YYYY-MM-DD`                    |\n| Métriques d’utilisation par utilisateur d’entreprise      | `GET /enterprises/{enterprise}/copilot/metrics/reports/users-1-day?day=YYYY-MM-DD`      |\n\nChaque point de terminaison retourne une réponse du formulaire :\n\n```json\n{\n  \"download_links\": [\n    \"https://example.com/copilot-user-teams-report-1.ndjson\"\n  ],\n  \"report_day\": \"2026-05-07\"\n}\n```\n\nTéléchargez le fichier à chaque URL avant l’expiration du lien afin de récupérer les lignes correspondant à ce rapport.\n\nPour obtenir des schémas de demande et de réponse complets, des exigences d’authentification et des points de terminaison associés, consultez [Points de terminaison d’API REST pour les métriques d’utilisation Copilot](/fr/enterprise-cloud@latest/rest/copilot/copilot-usage-metrics). Pour obtenir une vue d’ensemble de la façon dont les champs de métrique d’utilisation individuels sont définis, consultez [Données disponibles dans les métriques d’utilisation Copilot](/fr/enterprise-cloud@latest/copilot/reference/copilot-usage-metrics/copilot-usage-metrics).\n\nPour une période de plusieurs jours, appelez les points de terminaison journaliers une fois par jour et agrégez les résultats quotidiens. Consultez ci-dessous [la création de rapports d’équipe à fenêtre glissante](#building-rolling-window-team-reports).\n\n## Rapports impliqués\n\nLes métriques au niveau de l’équipe proviennent de la jonction de deux familles de rapports : les rapports d’équipes utilisateur pour l’appartenance à l’équipe et les rapports de métriques d’utilisation par utilisateur pour l’activité.\n\n### Rapports d’équipes utilisateur\n\nCes rapports répertorient les appartenances d’équipe de chaque utilisateur le jour donné.\n\n| Report                                                               | Étendue                                                                                                                                  | Champs clés |\n| :------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------- | :---------- |\n| `organization_user_teams_1_day`                                      | Appartenance des utilisateurs aux équipes de l’organisation pour la journée considérée. Inclut uniquement les équipes de l’organisation. |             |\n| `user_id`, , `user_login`, `day``organization_id`, , `team_id``slug` |                                                                                                                                          |             |\n| `enterprise_user_teams_1_day`                                        | Adhésion à l’équipe Enterprise pour un jour. Inclut à la fois les équipes d’entreprise et les équipes métier.                            |             |\n| `user_id`, , `user_login`, `day``enterprise_id`, , `team_id``slug`   |                                                                                                                                          |             |\n\nUn utilisateur appartenant à plusieurs équipes le même jour apparaît dans plusieurs lignes : une ligne par `(user, team)` paire.\n\n> \\[!IMPORTANT]\n> **Les équipes avec moins de 5 utilisateurs assis Copilot sont exclues des rapports des équipes d’utilisateurs.**\n>\n> Implications:\n>\n> * Une équipe avec moins de 5 utilisateurs assis sur une journée donnée n’apparaît pas dans le rapport des équipes utilisateur de ce jour, même si ses membres ont Copilot une activité. L’activité figure toujours dans le rapport de métriques d’utilisation par utilisateur, mais aucune ligne d’équipe n’existe dans le résultat de la jointure.\n> * Une équipe qui franchit le seuil pendant une période de plusieurs jours est présente sur certains jours et absente sur d’autres. Seuls les jours où l’équipe était au-dessus du seuil contribuent à ses totaux.\n> * Si vous additionnez à nouveau les lignes d’équipe pour les comparer à un total d’entreprise ou d’organisation, la somme sera inférieure au total de l’entité. L’écart provient de l’activité des utilisateurs qui appartiennent uniquement à des équipes en dessous du seuil : ils n’ont aucune ligne d’équipe dans le résultat de la jointure, de sorte que leur activité n’est représentée dans aucun agrégat d’équipe.\n\n### Rapports de métriques d’utilisation par utilisateur\n\nCes rapports contiennent l’activité de Copilot chaque utilisateur pour une journée donnée.\n\n| Report                                                                                              | Étendue                                                                                                                                    | Champs clés |\n| :-------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------- | :---------- |\n| `organization_users_1_day`                                                                          | Une ligne par `(user_id, day, organization_id)` avec l’activité Copilot de l’utilisateur au sein de cette organisation pour cette journée. |             |\n| `user_id`, `day`, , `organization_id``enterprise_id`, compteurs d’activité, tableaux de répartition |                                                                                                                                            |             |\n| `users_1_day`                                                                                       | Une ligne par `(user_id, day, enterprise_id)`, avec l’activité de l’utilisateurCopilot au sein de cette entreprise pour ce jour.           |             |\n| `user_id`, `day`, `enterprise_id`, compteurs d’activité, tableaux de répartition                    |                                                                                                                                            |             |\n\nPour obtenir la liste complète des champs disponibles dans ces rapports, consultez [Données disponibles dans les métriques d’utilisation Copilot](/fr/enterprise-cloud@latest/copilot/reference/copilot-usage-metrics/copilot-usage-metrics).\n\n> \\[!WARNING]\n> Ne joignez pas les rapports par utilisateur sur 28 jours glissants (`users_28_day`, `organization_users_28_day`) avec le rapport quotidien utilisateur-équipe. Le rapport sur les équipes des utilisateurs reflète l’appartenance à une équipe à une date donnée. Par conséquent, le fait de joindre 28 jours d’activité à un instantané d’appartenance pris sur une seule journée attribue l’ensemble des 28 jours d’activité aux équipes auxquelles l’utilisateur appartient le jour de la jointure. Cela attribue incorrectement l’activité aux mauvaises équipes chaque fois que la composition des équipes a changé pendant la période. Joignez toujours l’activité quotidienne avec les données quotidiennes utilisateur-équipe, puis agrégez selon la fenêtre souhaitée.\n\n### Rapports au niveau de l’entité\n\nLes rapports au niveau de l’entité (`enterprise_28_day`, , `organization_28_day`, `enterprise_1_day``organization_1_day`) sont des totaux pré-agrégés pour l’ensemble de l’entreprise ou de l’organisation. Ils n’incluent pas `user_id` ni `team_id`, et ne peuvent pas être combinés avec le rapport sur les équipes d’utilisateurs pour produire des répartitions par équipe. Utilisez-les directement lorsque vous souhaitez obtenir les totaux de l’entreprise ou de l’organisation ; pour les totaux au niveau de l’équipe, utilisez la jointure entre les user-teams quotidiens et les métriques quotidiennes par utilisateur décrite ci-dessous.\n\n## Example\n\nCet exemple minimal de bout en bout génère les métriques des équipes de l’organisation pour une journée. Les exemples de lignes NDJSON ci-dessous pour chaque rapport d’entrée sont similaires aux lignes que vous trouverez dans le fichier téléchargé à partir de l’un `download_links` de ces rapports (voir [Extraction des rapports](#fetching-the-reports) ci-dessus).\n\nDeux utilisateurs ont une activité Copilot le 07/05/2026 dans l’organisation `999` :\n\n* **Alice** (`user_id=1001`) appartient à deux équipes ce jour-là : `frontend` (`team_id=42`) et `backend` (`team_id=43`).\n* **Bob** (`user_id=1002`) appartient à `frontend` (`team_id=42`) uniquement.\n\n### Entrée : `organization_user_teams_1_day`\n\n```json\n{\"user_id\": 1001, \"user_login\": \"alice\", \"day\": \"2026-05-07\", \"organization_id\": \"999\", \"team_id\": 42, \"slug\": \"frontend\"}\n{\"user_id\": 1001, \"user_login\": \"alice\", \"day\": \"2026-05-07\", \"organization_id\": \"999\", \"team_id\": 43, \"slug\": \"backend\"}\n{\"user_id\": 1002, \"user_login\": \"bob\",   \"day\": \"2026-05-07\", \"organization_id\": \"999\", \"team_id\": 42, \"slug\": \"frontend\"}\n```\n\nAlice apparaît deux fois : une ligne par équipe à laquelle elle appartient.\n\n### Entrée : `organization_users_1_day`\n\n```json\n{\"user_id\": 1001, \"user_login\": \"alice\", \"day\": \"2026-05-07\", \"organization_id\": \"999\", \"enterprise_id\": \"13213\",\n \"user_initiated_interaction_count\": 50, \"code_generation_activity_count\": 40, \"code_acceptance_activity_count\": 12,\n \"loc_suggested_to_add_sum\": 200, \"loc_added_sum\": 88, \"used_chat\": true,  \"used_agent\": true,  ...}\n{\"user_id\": 1002, \"user_login\": \"bob\",   \"day\": \"2026-05-07\", \"organization_id\": \"999\", \"enterprise_id\": \"13213\",\n \"user_initiated_interaction_count\": 30, \"code_generation_activity_count\": 25, \"code_acceptance_activity_count\": 7,\n \"loc_suggested_to_add_sum\": 80,  \"loc_added_sum\": 24, \"used_chat\": true,  \"used_agent\": false, ...}\n```\n\nUne ligne par `(user, day, organization)`. Les totaux d’activité sont pour la journée, additionnés sur toutes les surfaces.\n\n### Résultat joint et agrégé\n\nEffectuez une jointure interne entre les deux rapports sur `(user_id, day, organization_id)`, puis regroupez par `team_id` et agrégez. La `active_users` colonne ci-dessous est une sortie d’agrégation (`COUNT(DISTINCT user_id)`et non un champ du rapport par utilisateur). Les colonnes numériques restantes sont des sommes des champs de rapport correspondants.\n\n| team\\_id | slug              | utilisateurs\\_actifs | nombre\\_d'activités\\_d'acceptation\\_du\\_code | loc\\_added\\_sum |\n| :------- | :---------------- | :------------------- | :------------------------------------------- | :-------------- |\n| 42       | frontend          | 2                    | 19                                           | 112             |\n| 43       | Serveur principal | 1                    | 12                                           | 88              |\n\nDeux lignes équipe-jour, une par équipe. La `frontend` ligne agrège à la fois l’activité d’Alice et de Bob. La `backend` ligne contient uniquement l’activité d’Alice.\n\nL’activité d’Alice contribue aux **deux** équipes. Les valeurs 12 et 88 de sa ligne sont comptabilisées dans `frontend` puis à nouveau dans `backend`. Cela correspond à l’objectif des métriques par équipe (chaque équipe voit l’activité de ses membres), mais réagréger les deux lignes d’équipe en un total unique pour l’organisation entraîne un double comptage d’Alice. Pour les totaux de l’organisation, interrogez directement `organization_users_1_day` sans effectuer la jointure utilisateur-équipe.\n\n## Comment construire des métriques au niveau de l’équipe\n\nPour n’importe quelle tranche au niveau de l’équipe, les quatre mêmes étapes s’appliquent.\n\n1. **Sélectionnez la paire de rapports.**\n\n   * Pour les équipes de l’organisation, associez `organization_user_teams_1_day` à `organization_users_1_day`. L’ID d’entité partagée est `organization_id`.\n   * Pour les équipes grandes entreprises et commerciales, associez `enterprise_user_teams_1_day` à `users_1_day`. L’ID d’entité partagée est `enterprise_id`.\n\n2. **Effectuez une jointure interne entre les deux rapports** sur `(user_id, day, entity_id)`. Les trois clés doivent correspondre. La jointure est de type un-à-plusieurs du côté des équipes : un utilisateur appartenant à plusieurs équipes correspond à plusieurs lignes utilisateur-équipe.\n\n3. **Filtrer par `day`** au jour où vous le souhaitez. Les deux rapports portent la même `day` valeur.\n\n4. **Regrouper par `team_id`** (et `slug` pour le nom d’affichage de l’équipe), puis agréger. Utiliser :\n\n   * `COUNT(DISTINCT user_id)` pour les nombres d’utilisateurs distincts, tels que les utilisateurs actifs.\n   * `SUM(...)` pour les compteurs de volume tels que `code_generation_activity_count`, `loc_added_sum`et `user_initiated_interaction_count`.\n\nLa jointure est une jointure interne : une équipe apparaît dans le résultat pour une journée donnée uniquement si au moins un de ses membres a eu une activité ce jour-là. Pour lister les équipes sans activité sur la journée, effectuez une jointure externe gauche à partir du rapport utilisateur-équipe et considérez les compteurs nuls comme égaux à zéro.\n\n### Couper par langage, IDE, fonctionnalité ou modèle\n\nLes répartitions par dimension sont stockées dans des champs tableau sur chaque ligne utilisateur (`totals_by_ide`, `totals_by_language_feature`, `totals_by_language_model`, `totals_by_model_feature`). Pour regrouper par dimension, développez le tableau correspondant dans le cadre de la jointure, ajoutez les colonnes de dimension à votre regroupement, puis agrégez les compteurs propres à cette dimension.\n`language` et `ide` se trouvent dans des tableaux distincts, donc un tableau croisé `(language × ide)` au niveau de l’équipe nécessite deux requêtes combinées dans votre application.\n\n### Création de rapports d’équipe sur fenêtre glissante\n\nPour produire un rapport d’équipe sur une fenêtre glissante (par exemple un cumul sur 28 jours) :\n\n1. Appelez les points de terminaison quotidiens pour chaque jour de la fenêtre.\n2. Joignez chaque jour le rapport de métriques d’utilisation par utilisateur (`organization_users_1_day` ou `users_1_day`) avec le rapport des équipes utilisateur (`organization_user_teams_1_day` ou `enterprise_user_teams_1_day`) du même jour sur `(user_id, day, entity_id)`.\n3. Filtrez `day` dans la fenêtre et retirez `day` du regroupement.\n\nLes compteurs de volume sont cumulables d’un jour à l’autre ; additionnez-les sur toute la fenêtre. Les nombres d’utilisateurs distincts doivent être évalués comme `COUNT(DISTINCT user_id)` sur les lignes jointes de la fenêtre complète. Ils ne peuvent pas être additionnés sur les nombres quotidiens.\n\nLa jointure quotidienne garantit que l’activité de chaque journée est attribuée aux équipes auxquelles l’utilisateur appartenait **ce jour-là**. Sans cela, les changements d’appartenance à une équipe au cours de la période entraîneraient une attribution incorrecte de l’activité à de mauvaises équipes.\n\n## Limitations et mises en garde\n\n* **Les utilisateurs de plusieurs équipes contribuent à chaque équipe à laquelle ils appartiennent.** Soyez prudent lorsque vous réagrégez les lignes d’équipe en un total d’organisation ou d’entreprise : les utilisateurs appartenant à plusieurs équipes seront comptés plusieurs fois. Utilisez directement le rapport par utilisateur (sans joindre les équipes utilisateur) pour les totaux de l’organisation ou de l’entreprise.\n* **Les équipes en dessous du seuil sont absentes du rapport sur les équipes utilisateur.** Les équipes avec moins de 5 utilisateurs assis sur Copilot une journée donnée sont exclues. Leur activité n’est donc pas représentée dans les résultats au niveau de l’équipe, même si l’activité est toujours dans le rapport par utilisateur.\n* **Les nombres d’utilisateurs distincts ne peuvent pas être additionnés sur plusieurs jours.** Lors d’un cumul sur plusieurs jours, évaluez `COUNT(DISTINCT user_id)` sur les lignes jointes de l’ensemble de la fenêtre plutôt que d’additionner les décomptes quotidiens.\n* **Davantage de surfaces fonctionnelles sont désormais suivies.** Les compteurs de volume (`code_generation_activity_count`, `code_acceptance_activity_count` et les compteurs `loc_*`) agrègent l’activité provenant de plusieurs surfacesCopilot : complétions en ligne dans l’IDE, actions dans le panneau de conversation et (pour les compteurs de lignes acceptées) modifications Copilot agent. Pour en savoir plus sur la couverture par surface et par compteur, consultez [Données disponibles dans les métriques d’utilisation Copilot](/fr/enterprise-cloud@latest/copilot/reference/copilot-usage-metrics/copilot-usage-metrics). Si vous utilisiez auparavant des métriques similaires provenant d’une surface qui ne comptabilisait que les complétions en ligne dans l’IDE, attendez-vous à des valeurs plus élevées dans ces compteurs et établissez une nouvelle référence plutôt que de comparer directement avant/après la transition.\n* **Tirez parti des nouvelles dimensions.** Des répartitions par IDE, par fonctionnalité, par `(language, feature)`, par `(language, model)` et par-`(model, feature)` sont disponibles sur chaque ligne utilisateur, permettant de produire des rapports au niveau des équipes qui n’étaient pas pris en charge par les précédentes surfaces de métriques d’équipe.\n\n## Étapes suivantes\n\n* Pour obtenir la référence complète du schéma et du champ pour le rapport des métriques d’utilisation par utilisateur, consultez [Données disponibles dans les métriques d’utilisation Copilot](/fr/enterprise-cloud@latest/copilot/reference/copilot-usage-metrics/copilot-usage-metrics).\n* Pour obtenir des exemples de charges utiles JSON à partir des points de terminaison des métriques d’utilisation, consultez [Exemple de schéma pour les métriques d’utilisation de Copilot](/fr/enterprise-cloud@latest/copilot/reference/copilot-usage-metrics/example-schema).\n* Pour obtenir des conseils sur la réconciliation des métriques entre le tableau de bord, les API et les exportations, consultez [Rapprochement des métriques d’utilisation de Copilot entre les tableaux de bord, les API et les rapports](/fr/enterprise-cloud@latest/copilot/reference/copilot-usage-metrics/reconciling-usage-metrics)."}