{"meta":{"title":"Copilot Nutzungsmetriken auf Teamebene","intro":"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.","product":"GitHub Copilot","breadcrumbs":[{"href":"/de/copilot","title":"GitHub Copilot"},{"href":"/de/copilot/reference","title":"Verweis"},{"href":"/de/copilot/reference/copilot-usage-metrics","title":"Copilot-Nutzungsmetriken"},{"href":"/de/copilot/reference/copilot-usage-metrics/team-level-metrics","title":"Metriken auf Teamebene"}],"documentType":"article"},"body":"# Copilot Nutzungsmetriken auf Teamebene\n\nErstellen 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.\n\nDie 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.\n\nDasselbe 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.\n\n> \\[!NOTE]\n> Wenn Sie nur eine UI-basierte Ansicht der Akzeptanz auf Teamebene benötigen, stellt die Benutzer-Team-Zuordnung des Impact-Dashboards die Kohortendaten zur Akzeptanz auf Teamebene direkt bereit, ohne dass Sie die in diesem Artikel beschriebene Verknüpfung erstellen müssen. Siehe [Anzeigen des Copilot-Impact-Dashboards](/de/copilot/how-tos/administer-copilot/view-impact-dashboard). Verwenden Sie die unten beschriebene manuelle Verknüpfung, wenn Sie unformatierte NDJSON-Daten wie z. B. für benutzerdefinierte BI-Berichte oder Metriken auf Teamebene benötigen, die über die Einführungskohorten hinausgehen.\n\n## Abrufen der Berichte\n\nDie 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 (newline-delimited JSON, NDJSON) herunter, auf die diese URLs verweisen. Die Benutzerteams und Zeilen pro Benutzer befinden sich in diesen NDJSON-Dateien; sie werden nicht inline vom REST-Endpunkt zurückgegeben.\n\n| Bericht                                            | Endpunkt                                                                                |\n| :------------------------------------------------- | :-------------------------------------------------------------------------------------- |\n| Benutzerteams der Organisation                     | `GET /orgs/{org}/copilot/metrics/reports/user-teams-1-day?day=YYYY-MM-DD`               |\n| Benutzerteams für Unternehmen                      | `GET /enterprises/{enterprise}/copilot/metrics/reports/user-teams-1-day?day=YYYY-MM-DD` |\n| Nutzungsmetriken pro Benutzer für die Organisation | `GET /orgs/{org}/copilot/metrics/reports/users-1-day?day=YYYY-MM-DD`                    |\n| Nutzungsmetriken pro Benutzer für Unternehmen      | `GET /enterprises/{enterprise}/copilot/metrics/reports/users-1-day?day=YYYY-MM-DD`      |\n\nJeder Endpunkt gibt eine Antwort des Formulars zurück:\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\nLaden Sie die Datei unter jeder URL innerhalb der Gültigkeitsdauer des Links herunter, um die Datenzeilen dieses Berichts abzurufen.\n\nVollständige Anforderungs- und Antwortschemas, Authentifizierungsanforderungen und zugehörige Endpunkte finden Sie unter [REST-API-Endpunkte für Copilot Nutzungsmetriken](/de/rest/copilot/copilot-usage-metrics). Eine Übersicht über die Definition einzelner Verwendungsmetrikfelder finden Sie unter [In den Nutzungsmetriken von Copilot verfügbare Daten](/de/copilot/reference/copilot-usage-metrics/copilot-usage-metrics).\n\nRufen 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](#building-rolling-window-team-reports).\n\n## Zugehörige Berichte\n\nMetriken auf Teamebene stammen aus der Teilnahme an zwei Berichtsfamilien: Benutzerteamsberichte für die Teammitgliedschaft und Benutzernutzungsmetriken für Aktivitäten.\n\n### Benutzerteamsberichte\n\nIn diesen Berichten werden die Teammitgliedschaften jedes Benutzers an einem bestimmten Tag aufgelistet.\n\n| Bericht                                                                | Geltungsbereich                                                                                      | Schlüsselfelder |\n| :--------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------- | :-------------- |\n| `organization_user_teams_1_day`                                        | Mitgliedschaft im Organisationsteam für den Tag. Umfasst nur Teams der Organisation.                 |                 |\n| `user_id`, `user_login`, `day`, `organization_id`, , `team_id`, `slug` |                                                                                                      |                 |\n| `enterprise_user_teams_1_day`                                          | Enterprise-Teammitgliedschaft für den Tag. Umfasst Sowohl Unternehmensteams als auch Geschäftsteams. |                 |\n| `user_id`, `user_login`, `day`, `enterprise_id`, , `team_id`, `slug`   |                                                                                                      |                 |\n\nEin Benutzer, der zu mehreren Teams am selben Tag gehört, wird in mehreren Zeilen angezeigt – eine Zeile pro `(user, team)` Paar.\n\n> \\[!IMPORTANT]\n> **Teams mit weniger als 5 sitzenden Copilot Benutzern werden von den Benutzerteamsberichten ausgeschlossen.**\n>\n> Auswirkungen:\n>\n> * 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.\n> * 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.\n> * 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.\n\n### Berichte zu Nutzungsmetriken pro Benutzer\n\nDiese Berichte enthalten die Aktivitäten jedes Copilot Benutzers für einen bestimmten Tag.\n\n| Bericht                                                                                         | Geltungsbereich                                                                                                                        | Schlüsselfelder |\n| :---------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------- | :-------------- |\n| `organization_users_1_day`                                                                      | Eine Zeile pro `(user_id, day, organization_id)` mit der Copilot Aktivität des Benutzers innerhalb dieser Organisation für diesen Tag. |                 |\n| `user_id`, `day`, `organization_id`, `enterprise_id`, Aktivitätszähler, Aufschlüsselungs-Arrays |                                                                                                                                        |                 |\n| `users_1_day`                                                                                   | Eine Zeile pro `(user_id, day, enterprise_id)` mit der Copilot-Aktivität des Benutzers innerhalb des Unternehmens für diesen Tag.      |                 |\n| `user_id`, `day`, `enterprise_id`, Aktivitätszähler, Aufschlüsselungs-Arrays                    |                                                                                                                                        |                 |\n\nDie vollständige Liste der felder, die in diesen Berichten verfügbar sind, finden Sie unter [In den Nutzungsmetriken von Copilot verfügbare Daten](/de/copilot/reference/copilot-usage-metrics/copilot-usage-metrics).\n\n> \\[!WARNING]\n> 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.\n\n### Berichte auf Entitätsebene\n\nDie 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.\n\n## Example\n\nDieses minimale End-to-End-Beispiel erzeugt einen Tag mit Organisationsteammetriken. Die folgenden NDJSON-Beispielzeilen für jeden Eingabebericht entsprechen den Zeilen, die Sie in der Datei finden würden, die aus einem dieser Berichte `download_links` heruntergeladen wurde (siehe [Abrufen der obigen Berichte](#fetching-the-reports) ).\n\nZwei Benutzer haben Copilot Aktivität am 2026-05-07 in der Organisation `999`:\n\n* **Alice** (`user_id=1001`) gehört zu zwei Teams an diesem Tag: `frontend` (`team_id=42`) und `backend` (`team_id=43`).\n* **Bob** (`user_id=1002`) gehört nur zu `frontend` (`team_id=42`).\n\n### Eingabe: `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 erscheint zweimal – eine Zeile pro Team, zu der sie gehört.\n\n### Eingabe: `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\nEine Zeile pro `(user, day, organization)`. Aktivitätssummen gelten für den Tag, summiert über alle Oberflächen.\n\n### Verknüpftes und aggregiertes Ergebnis\n\nVerknü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.\n\n| team\\_id | Slug     | aktive\\_Benutzer | code\\_acceptance\\_activity\\_count | loc\\_added\\_sum |\n| :------- | :------- | :--------------- | :-------------------------------- | :-------------- |\n| 42       | frontend | 2                | 19                                | 112             |\n| 43       | Back-End | 1                | 12                                | 88              |\n\nZwei 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.\n\nAlices 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.\n\n## Erstellen von Metriken auf Teamebene\n\nFür jeden Ausschnitt auf Teamebene gelten dieselben vier Schritte.\n\n1. **Wählen Sie das Berichtspaar aus.**\n\n   * Für Organisationsteams `organization_user_teams_1_day` mit `organization_users_1_day` koppeln. Die ID der gemeinsam genutzten Entität ist `organization_id`.\n   * Für Unternehmens- und Geschäftsteams kombinieren Sie `enterprise_user_teams_1_day` mit `users_1_day`. Die ID der gemeinsam genutzten Entität ist `enterprise_id`.\n\n2. **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.\n\n3. **Filtern nach `day`** bis zum gewünschten Tag. Beide Berichte tragen denselben `day` Wert.\n\n4. **Gruppieren nach `team_id`** (und `slug` für den Anzeigenamen des Teams) und aggregieren. Verwenden Sie:\n\n   * `COUNT(DISTINCT user_id)` für die Anzahl eindeutiger Benutzer, z. B. aktive Benutzer.\n   * `SUM(...)` für Lautstärkezähler wie `code_generation_activity_count`, `loc_added_sum`, und `user_initiated_interaction_count`.\n\nDer Join ist ein innerer 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 linken Join ausgehend vom Bericht „Benutzer-Teams“ aus und behandeln Null-Zähler als null.\n\n### Ausschneiden nach Sprache, IDE, Feature oder Modell\n\nAufschlü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.\n`language` und `ide` befinden sich in getrennten Arrays, sodass eine `(language × ide)`-Kreuztabelle auf Teamebene zwei Abfragen erfordert, die in Ihrer Anwendung kombiniert werden.\n\n### Erstellen von Teamberichten im Rollfenster\n\nSo erstellen Sie einen Teambericht mit gleitendem Zeitraum (z. B. eine 28-Tage-Zusammenfassung):\n\n1. Rufen Sie die täglichen Endpunkte für jeden Tag im Fenster auf.\n2. 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)`.\n3. Ziehen Sie `day` in das Fenster, und entfernen Sie `day` aus der Gruppierung.\n\nVolumenzä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.\n\nDie 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.\n\n## Einschränkungen und Vorbehalte\n\n* **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).\n* **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.\n* **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.\n* **Weitere Funktionsbereiche werden erfasst.** Die Volumenzähler (Zähler `code_generation_activity_count`, `code_acceptance_activity_count` und `loc_*`) 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](/de/copilot/reference/copilot-usage-metrics/copilot-usage-metrics). 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.\n* **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\n## Nächste Schritte\n\n* Die vollständige Schema- und Feldreferenz für den Bericht über benutzerspezifische Nutzungsmetriken finden Sie unter [In den Nutzungsmetriken von Copilot verfügbare Daten](/de/copilot/reference/copilot-usage-metrics/copilot-usage-metrics).\n* Beispiel: JSON-Nutzlasten von den Endpunkten für Nutzungsmetriken finden Sie unter [Beispielschema für Copilot Nutzungsmetriken](/de/copilot/reference/copilot-usage-metrics/example-schema).\n* Anleitungen zur Abstimmung von Metriken über das Dashboard, APIs und Exporte finden Sie unter [Abstimmung der Copilot-Nutzungsmetriken über Dashboards, APIs und Berichte hinweg](/de/copilot/reference/copilot-usage-metrics/reconciling-usage-metrics)."}