Copilot Nutzungsmetriken auf Teamebene

Erstellen Sie Nutzungsmetriken auf Teamebene GitHub Copilot, indem Sie den täglichen Bericht zu Benutzer-Teams mit dem täglichen Bericht zu den Nutzungsmetriken pro Benutzer zusammenführen.

Wer kann dieses Feature verwenden?

Unternehmensbesitzer, Organisationsadministratoren, Abrechnungsmanager und Personen mit einer benutzerdefinierten Enterprise-Rolle mit der Berechtigung "Unternehmensmetriken Copilot anzeigen".

In diesem Artikel

Die Copilot Verwendungsmetriken-APIs veröffentlichen keinen einzelnen vorab aggregierten Teambericht. Metriken auf Teamebene werden erstellt, indem sie dem Bericht " Benutzerteams " beitreten (der die Teammitgliedschaften jedes Benutzers für einen bestimmten Tag auflistet) mit dem Bericht über benutzerbezogene Nutzungsmetriken (der die Aktivitäten der einzelnen Benutzer Copilot für diesen Tag enthält). Das Aggregieren der verknüpften Zeilen nach team_id ergibt Metriken auf Teamebene.

Dasselbe Join-Rezept ermöglicht jede Aufschlüsselung auf Teamebene, die Sie benötigen: pro (team, day), pro (team, day, language), pro (team, day, IDE), über gleitende Zeitfenster und so weiter.

Abrufen der Berichte

Die beiden Berichte, auf die in diesem Handbuch verwiesen wird, werden in zwei Schritten heruntergeladen. Rufen Sie zuerst den REST-Endpunkt für den gewünschten Tag auf. Der Endpunkt gibt zeitlich begrenzte signierte URLs zurück, aus denen Sie die Berichtsdateien herunterladen können. Laden Sie dann die JSON-Dateien herunter, auf die diese URLs verweisen. Die Zeilen zum Benutzerteam und die Zeilen pro Benutzer befinden sich in diesen JSON-Dateien; sie werden nicht direkt vom REST-Endpunkt zurückgegeben.

BerichtEndpunkt
Benutzerteams der OrganisationGET /orgs/{org}/copilot/metrics/reports/user-teams-1-day?day=YYYY-MM-DD
Benutzerteams für UnternehmenGET /enterprises/{enterprise}/copilot/metrics/reports/user-teams-1-day?day=YYYY-MM-DD
Nutzungsmetriken pro Benutzer für die OrganisationGET /orgs/{org}/copilot/metrics/reports/users-1-day?day=YYYY-MM-DD
Nutzungsmetriken pro Benutzer für UnternehmenGET /enterprises/{enterprise}/copilot/metrics/reports/users-1-day?day=YYYY-MM-DD

Jeder Endpunkt gibt eine Antwort des Formulars zurück:

{
  "download_links": [
    "https://example.com/copilot-user-teams-report-1.json"
  ],
  "report_day": "2026-05-07"
}

Laden Sie die Datei unter jeder URL innerhalb der Gültigkeitsdauer des Links herunter, um die Datenzeilen dieses Berichts abzurufen.

Vollständige Anforderungs- und Antwortschemas, Authentifizierungsanforderungen und zugehörige Endpunkte finden Sie unter REST-API-Endpunkte für Copilot Nutzungsmetriken. Eine Übersicht über die Definition einzelner Verwendungsmetrikfelder finden Sie unter In den Nutzungsmetriken von Copilot verfügbare Daten.

Rufen Sie für ein mehrtägiges Fenster die täglichen Endpunkte einmal pro Tag auf, und aggregieren Sie die täglichen Ergebnisse. Siehe unten Erstellen von Teamberichten in einem gleitenden Zeitfenster.

Zugehörige Berichte

Metriken auf Teamebene stammen aus der Teilnahme an zwei Berichtsfamilien: Benutzerteamsberichte für die Teammitgliedschaft und Benutzernutzungsmetriken für Aktivitäten.

Benutzerteamsberichte

In diesen Berichten werden die Teammitgliedschaften jedes Benutzers an einem bestimmten Tag aufgelistet.

BerichtGeltungsbereichSchlüsselfelder
organization_user_teams_1_dayMitgliedschaft im Organisationsteam für den Tag. Umfasst nur Teams der Organisation.
user_id, user_login, day, organization_id, , team_id, slug
enterprise_user_teams_1_dayEnterprise-Teammitgliedschaft für den Tag. Umfasst Sowohl Unternehmensteams als auch Geschäftsteams.
user_id, user_login, day, enterprise_id, , team_id, slug

Ein Benutzer, der zu mehreren Teams am selben Tag gehört, wird in mehreren Zeilen angezeigt – eine Zeile pro (user, team) Paar.

Wichtig

Teams mit weniger als 5 sitzenden Copilot Benutzern werden von den Benutzerteamsberichten ausgeschlossen.

Auswirkungen:

  • Ein Team mit weniger als 5 Benutzern mit zugewiesenem Sitzplatz an einem bestimmten Tag wird im Benutzerteams-Bericht für diesen Tag nicht angezeigt, auch wenn seine Mitglieder Copilot Aktivität aufweisen. Die Aktivität befindet sich weiterhin im Bericht über benutzerbezogene Nutzungsmetriken, aber im Verknüpfungsergebnis ist keine Teamzeile vorhanden.
  • Ein Team, das innerhalb eines mehrtägigen Zeitraums den Schwellenwert überschreitet, ist an manchen Tagen vertreten und an anderen nicht. Nur die Tage, die das Team über dem Schwellenwert lag, tragen zu seinen Summen bei.
  • Wenn Sie die Teamzeilen zusammen addieren, um mit einer Unternehmens- oder Organisationssumme zu vergleichen, ist die Summe niedriger als die Entitätssumme. Der Mangel ist die Aktivität von Benutzern, die nur zu Unterschwellenteams gehören – sie haben keine Teamzeile im Beitrittsergebnis, sodass ihre Aktivität nicht in einem Teamaggregat dargestellt wird.

Berichte zu Nutzungsmetriken pro Benutzer

Diese Berichte enthalten die Aktivitäten jedes Copilot Benutzers für einen bestimmten Tag.

BerichtGeltungsbereichSchlüsselfelder
organization_users_1_dayEine Zeile pro (user_id, day, organization_id) mit der Copilot Aktivität des Benutzers innerhalb dieser Organisation für diesen Tag.
user_id, day, organization_id, enterprise_id, Aktivitätszähler, Aufschlüsselungs-Arrays
users_1_dayEine Zeile pro (user_id, day, enterprise_id) mit der Copilot-Aktivität des Benutzers innerhalb des Unternehmens für diesen Tag.
user_id, day, enterprise_id, Aktivitätszähler, Aufschlüsselungs-Arrays

Die vollständige Liste der felder, die in diesen Berichten verfügbar sind, finden Sie unter In den Nutzungsmetriken von Copilot verfügbare Daten.

Warnung

Verknüpfen Sie die fortlaufenden 28-Tage-Berichte pro Benutzer (users_28_day, organization_users_28_day) nicht mit dem täglichen Bericht zu Benutzerteams. Der Bericht zur Teammitgliedschaft von Benutzern bildet die Teammitgliedschaft für einen einzelnen Tag ab. Wenn also 28 Tage an Aktivitätsdaten mit einer Momentaufnahme der Mitgliedschaft für einen einzelnen Tag verknüpft werden, werden die gesamten 28 Tage der Aktivität den Teams zugeordnet, denen der Benutzer am Tag der Verknüpfung angehört. Dadurch werden Aktivitäten fälschlicherweise den falschen Teams zugeschrieben, wenn sich die Teamzugehörigkeit im betreffenden Zeitraum geändert hat. Verknüpfen Sie tägliche Aktivitätsdaten immer mit täglichen Benutzerteams und aggregieren Sie anschließend auf das gewünschte Zeitfenster.

Berichte auf Entitätsebene

Die Berichte auf Entitätsebene (enterprise_28_day, organization_28_day, enterprise_1_day, organization_1_day) sind vorab aggregierte Summen für das gesamte Unternehmen oder die gesamte Organisation. Sie enthalten weder user_id noch team_id und können nicht mit dem Bericht zu Benutzerteams kombiniert werden, um Aufschlüsselungen pro Team zu erstellen. Verwenden Sie diese direkt, wenn Sie Gesamtwerte für Unternehmen oder Organisationen benötigen; für Gesamtwerte auf Teamebene verwenden Sie den unten beschriebenen Join aus täglichen Benutzer-Teamdaten und täglichen Metriken pro Benutzer.

Example

Dieses minimale End-to-End-Beispiel erzeugt einen Tag mit Organisationsteammetriken. Der folgende JSON-Code für jeden Eingabebericht ist ein Beispiel für die Zeilen, die Sie in der Datei finden würden, die aus einem dieser Berichte download_links heruntergeladen wurde (siehe Abrufen der obigen Berichte ).

Zwei Benutzer haben Copilot Aktivität am 2026-05-07 in der Organisation 999:

  • Alice (user_id=1001) gehört zu zwei Teams an diesem Tag: frontend (team_id=42) und backend (team_id=43).
  • Bob (user_id=1002) gehört nur zu frontend (team_id=42).

Eingabe: organization_user_teams_1_day

{"user_id": 1001, "user_login": "alice", "day": "2026-05-07", "organization_id": "999", "team_id": 42, "slug": "frontend"}
{"user_id": 1001, "user_login": "alice", "day": "2026-05-07", "organization_id": "999", "team_id": 43, "slug": "backend"}
{"user_id": 1002, "user_login": "bob",   "day": "2026-05-07", "organization_id": "999", "team_id": 42, "slug": "frontend"}

Alice erscheint zweimal – eine Zeile pro Team, zu der sie gehört.

Eingabe: organization_users_1_day

{"user_id": 1001, "user_login": "alice", "day": "2026-05-07", "organization_id": "999", "enterprise_id": "13213",
 "user_initiated_interaction_count": 50, "code_generation_activity_count": 40, "code_acceptance_activity_count": 12,
 "loc_suggested_to_add_sum": 200, "loc_added_sum": 88, "used_chat": true,  "used_agent": true,  ...}
{"user_id": 1002, "user_login": "bob",   "day": "2026-05-07", "organization_id": "999", "enterprise_id": "13213",
 "user_initiated_interaction_count": 30, "code_generation_activity_count": 25, "code_acceptance_activity_count": 7,
 "loc_suggested_to_add_sum": 80,  "loc_added_sum": 24, "used_chat": true,  "used_agent": false, ...}

Eine Zeile pro (user, day, organization). Aktivitätssummen gelten für den Tag, summiert über alle Oberflächen.

Verknüpftes und aggregiertes Ergebnis

Verknüpfen Sie die beiden Berichte per Inner Join über (user_id, day, organization_id), gruppieren Sie sie dann nach team_id und aggregieren Sie sie. Die active_users folgende Spalte ist eine Aggregationsausgabe (COUNT(DISTINCT user_id)), kein Feld im Bericht pro Benutzer; die verbleibenden numerischen Spalten sind Summen der übereinstimmenden Berichtsfelder.

team_idNacktschneckeaktive_Benutzercode_acceptance_activity_countloc_added_sum
42frontend219112
43Backend11288

Zwei Zeilen für Teamtage, je eine pro Team. In der frontend Zeile werden die Aktivitäten von Alice und Bob zusammengefasst. Die backend Zeile enthält nur die Aktivität von Alice.

Alices Aktivitäten tragen zu beiden Teams bei. Die 12 und 88 aus ihrer Zeilenanzahl in frontend und wieder in backend. Dies entspricht der Logik von Kennzahlen auf Teamebene – jedes Team sieht die Aktivität seiner Mitglieder –, aber wenn man die beiden Teamzeilen wieder zu einem einzigen Gesamtwert für die Organisation zusammenzählt, wird Alice doppelt gezählt. Fragen Sie organization_users_1_day bei Gesamtergebnissen der Organisation direkt ab, ohne dass die Benutzerteams beitreten.

Erstellen von Metriken auf Teamebene

Für jeden Ausschnitt auf Teamebene gelten dieselben vier Schritte.

  1. Wählen Sie das Berichtspaar aus.

    • Für Organisationsteams organization_user_teams_1_day mit organization_users_1_day koppeln. Die ID der gemeinsam genutzten Entität ist organization_id.
    • Für Unternehmens- und Geschäftsteams kombinieren Sie enterprise_user_teams_1_day mit users_1_day. Die ID der gemeinsamen Entität ist enterprise_id.

  2. Verknüpfen Sie die beiden Berichte per Inner Join über (user_id, day, entity_id). Alle drei Schlüssel müssen übereinstimmen. Die Teilnahme ist 1:n auf der Teamseite – ein Benutzer in mehreren Teams entspricht mehreren Benutzerteamszeilen.

  3. Filtern nach day bis zum gewünschten Tag. Beide Berichte tragen denselben day Wert.

  4. Gruppieren nach team_id (und slug für den Anzeigenamen des Teams) und aggregieren. Verwenden Sie:

    • COUNT(DISTINCT user_id) für die Anzahl eindeutiger Benutzer, z. B. aktive Benutzer.
    • SUM(...) für Lautstärkezähler wie code_generation_activity_count, loc_added_sum, und user_initiated_interaction_count.

Der Join ist ein Inner Join: Ein Team erscheint für einen gegebenen Tag nur dann im Ergebnis, wenn mindestens eines seiner Mitglieder an diesem Tag aktiv war. Um Teams aufzulisten, die an diesem Tag keine Aktivität hatten, führen Sie einen Left Join ausgehend vom Bericht „Benutzer-Teams“ aus und behandeln NULL-Zähler als null.

Ausschneiden nach Sprache, IDE, Feature oder Modell

Aufschlüsselungen pro Dimension sind in den Arrayfeldern jeder benutzerspezifischen Zeile enthalten (totals_by_ide, totals_by_language_feature, totals_by_language_model, totals_by_model_feature). Um nach einer Dimension zu gruppieren, erweitern Sie das relevante Array als Teil der Verknüpfung, fügen Sie der Gruppierung die Dimensionsspalten hinzu, und aggregieren Sie die Zähler pro Element, die auf diese Dimension festgelegt sind. language und ide befinden sich in getrennten Arrays, sodass eine (language × ide)-Kreuztabelle auf Teamebene zwei Abfragen erfordert, die in Ihrer Anwendung kombiniert werden.

Erstellen von Teamberichten im Rollfenster

So erstellen Sie einen Teambericht mit gleitendem Zeitraum (z. B. eine 28-Tage-Zusammenfassung):

  1. Rufen Sie die täglichen Endpunkte für jeden Tag im Fenster auf.
  2. Verknüpfen Sie den täglichen Bericht zu den Nutzungsmetriken pro Benutzer (organization_users_1_day oder users_1_day) mit dem Bericht zu den Benutzerteams desselben Tages (organization_user_teams_1_day oder enterprise_user_teams_1_day) über (user_id, day, entity_id).
  3. Ziehen Sie day in das Fenster, und entfernen Sie day aus der Gruppierung.

Volumenzähler sind über Tage hinweg additiv; summieren Sie sie über das Fenster. Zählungen eindeutiger Benutzer müssen als COUNT(DISTINCT user_id) über die zusammengeführten Zeilen des vollständigen Fensters berechnet werden – sie können nicht aus den täglichen Zählungen aufsummiert werden.

Die tagbezogene Verknüpfung stellt sicher, dass die Aktivität jedes Tages den Teams zugeordnet wird, denen der Benutzer an diesem Tag angehörte. Ohne diese Funktion werden Änderungen der Teammitgliedschaft während dieses Zeitfensters Aktivitäten stillschweigend den falschen Teams zuordnen.

Einschränkungen und Vorbehalte

  • Benutzer in mehreren Teams tragen zu jedem Team bei, dem sie angehören. Seien Sie vorsichtig, wenn Sie Teamzeilen wieder in eine Organisation oder eine Unternehmenssumme zusammenfassen – Mehrere Teambenutzer werden mehrmals gezählt. Verwenden Sie für Organisations- oder Unternehmensgesamtsummen direkt den Bericht pro Benutzer (ohne den Join mit den Benutzerteams).
  • Teams unterhalb des Schwellenwerts fehlen im Bericht „Benutzerteams“. Teams mit weniger als 5 sitzenden Copilot Benutzern an einem bestimmten Tag werden ausgeschlossen, sodass ihre Aktivitäten nicht in Ergebnissen auf Teamebene dargestellt werden, obwohl die Aktivität noch im Bericht pro Benutzer enthalten ist.
  • Die Anzahl eindeutiger Benutzer kann nicht über Tage summiert werden. Beim Aufrollen über ein mehrtägiges Fenster werten Sie COUNT(DISTINCT user_id) über die zusammengeführten Zeilen für das gesamte Fenster aus, anstatt tägliche Zählwerte zu summieren.
  • Weitere Funktionsbereiche werden erfasst. Die Volumenzähler (code_generation_activity_count, code_acceptance_activity_count und die loc_* Zähler) fassen Aktivitäten über mehrere Copilot Oberflächen hinweg zusammen – Inline-IDE-Vervollständigungen, Aktionen im Chat-Panel und (bei Zählern für akzeptierte Zeilen) Copilot-Agent Bearbeitungen. Details zur Oberflächenabdeckung pro Zähler finden Sie unter In den Nutzungsmetriken von Copilot verfügbare Daten. Wenn Sie zuvor ähnliche Metriken über eine Oberfläche bezogen haben, die nur Inline-IDE-Vervollständigungen gezählt hat, ist bei diesen Zählern mit höheren Werten zu rechnen; setzen Sie daher die Baseline neu, anstatt die Werte über die Umstellung hinweg zu vergleichen.
  • Nutzen Sie die neuen Dimensionen. Aufschlüsselungen pro IDE, pro Feature, pro (language, feature), pro (language, model) und pro (model, feature) sind in jeder Pro-Benutzer-Zeile verfügbar und ermöglichen Berichte auf Teamebene, die frühere Oberflächen für Teammetriken nicht unterstützten.

Nächste Schritte