Das Copilot Dashboard für Nutzungsmetriken und APIs zeigen Daten mithilfe einer konsistenten Gruppe von Feldern an und exportieren sie. In dieser Referenz werden alle verfügbaren Metriken aufgelistet und beschrieben, wie sie ihre Werte sowohl in visuellen Dashboard- als auch in NDJSON- oder API-Exporten interpretieren.
- Die Copilot Dashboards zur Verwendungsmetrik stehen auf Unternehmens - und Organisationsebene zur Verfügung.
- Die Copilot APIs für Nutzungsmetriken geben Berichte auf Unternehmens- oder Organisationsebene zurück, mit aggregierter sowie mit Granularität auf Repository-Ebene und Granularität auf Ebene einzelner Benutzer. Shapes variieren je nach Bereich und Granularität.
- Metriken auf Teamebene werden nicht vorab aggregiert; Sie erstellen sie, indem Sie dem Bericht "Benutzerteams" mit dem Bericht über benutzerspezifische Nutzungsmetriken beitreten. Siehe Copilot Nutzungsmetriken auf Teamebene.
- Berichte auf Repositoryebene enthalten einen Datensatz pro Repository mit Pull-Anforderungsaktivitäten am angeforderten Tag. Weitere Informationen finden Sie weiter unten in diesem Artikel unter Felder auf Repositoryebene (nur API ).
Anleitungen zum Lesen und Interpretieren dieser Metriken finden Sie unter GitHub Copilot Nutzungsmetriken.
Copilot Metriken des Verwendungsdashboards
Diese Metriken werden direkt im Copilot Verwendungsdashboard angezeigt. Diese Diagramme schließen keine Nutzung von Copilot CLI ein.
| Metric | Description |
|---|---|
| Agenteneinführung | Prozentsatz der Copilotlizenzierten aktiven Benutzer, die einen Agent im aktuellen Kalendermonat ausprobiert haben. |
| Durchschnittliche Chatanfragen pro aktiver Benutzer | Durchschnittliche Anzahl von Chatanfragen pro aktivem Benutzer. |
| Code-Vervollständigungen (vorgeschlagen/akzeptiert) | Gesamtanzahl der angezeigten und akzeptierten Inlinecodevorschläge. |
| Akzeptanzrate der Code-Vervollständigung | Prozentsatz der von Benutzern angenommenen Vorschläge. |
| Täglich aktive Benutzer | Anzahl der eindeutigen Benutzer, die Copilot an einem bestimmten Tag verwendet haben. |
| Aktive Benutzer pro Woche | Anzahl der eindeutigen Benutzer, die Copilot während eines siebentägigen Fensters verwendet haben. |
| Gesamtzahl der aktiven Benutzer | Lizenzierte Benutzer, die im aktuellen Kalendermonat aktiv sind. |
| Sprachverwendung | Verteilung der mit Copilot verwendeten Programmiersprachen. |
| Sprachnutzung pro Tag | Tägliche Aufschlüsselung der verwendeten Sprachen. |
| Modellverwendung | Verteilung von KI-Modellen, die für Chats verwendet werden. |
| Modellnutzung pro Tag | Tägliche Aufschlüsselung der Chatmodellnutzung. |
| Modellnutzung pro Chatmodus | Modellnutzung nach Copilot Funktion (Fragen, Bearbeiten, Planen, Agent). |
| Modellverwendung pro Sprache | Verteilung der Sprachen nach Modell aufgeschlüsselt. |
| Am häufigsten verwendete Chatmodell | Das am häufigsten verwendete Chatmodell in den letzten 28 Tagen. |
| Anforderungen pro Chatmodus | Anzahl der Chatanfragen nach Modus (Fragen, Bearbeiten, Plan, Agent). |
Metriken des Auswirkungsdashboards
Diese Metriken werden im Auswirkungsdashboard angezeigt, das Benutzer zu Einführungskohorten gruppiert und diese Einführung mit pull-Anforderungsausgabe verbindet. Anleitungen zur Interpretation von Adoptionskohorten finden Sie unter GitHub Copilot Nutzungsmetriken.
| Metric | Description |
|---|---|
| Interaktionstrends | Wie sich die Zusammensetzung der Adoptionskohorten der Organisation und der Pull-Request-Durchsatz (insgesamt pro Monat zusammengeführte Pull-Requests) in den letzten sechs Monaten verändert hat. |
| Verteilung der Einführungskohorten | Anteil lizenzierter Benutzer, gruppiert in jede Einführungsphase (passive Benutzer, Phase 1, Phase 2, Phase 3) für den Zeitraum. Passive Benutzer entsprechen dem No Cohort Wert in der API. |
| Akzeptanzmultiplikator | Vergleicht aktive Nutzer (Phase 1, 2 oder 3) mit passiven Nutzern hinsichtlich ausgeliefertem Code (zusammengeführte Pull Requests pro Nutzer und Monat) sowie der Zeit bis zum Zusammenführen von Pull Requests, um die relativen Auswirkungen einer weitergehenden Nutzung von Copilot zu zeigen. |
| Recommendations | Vorgeschlagene Aktionen, z. B. konfigurieren Copilot-Cloud-Agent oder aktivieren Copilot Codeüberprüfung, basierend auf der aktuellen Kohortenverteilung der Organisation. |
Metriken des Codegenerierungs-Dashboards
Diese Metriken werden im Dashboard zur Codegenerierung angezeigt und stellen eine Aufschlüsselung der Art und Weise bereit, wie Code über vom Benutzer initiierte und vom Agent initiierte Aktivitäten generiert wird. Alle Werte werden aus Codezeilen (LoC) abgeleitet, die in der IDE hinzugefügt oder gelöscht wurden.
| Metric | Description |
|---|---|
| Codezeilen, die mit KI geändert wurden | Gesamtanzahl der Codezeilen, die in allen Modi in den letzten 28 Tagen hinzugefügt und gelöscht wurden. |
| Agent-Beitrag | Prozentsatz der Codezeilen, die von Agents (einschließlich Bearbeitungs-, Agent- und benutzerdefinierter Modi) in den letzten 28 Tagen hinzugefügt und gelöscht wurden. |
| Durchschnittliche Zeilen, die vom Agenten gelöscht wurden | Durchschnittliche Anzahl von Zeilen, die von Agents im Namen aktiver Benutzer während des aktuellen Kalendermonats automatisch gelöscht werden. |
| Tägliche Gesamtzahl der hinzugefügten und gelöschten Zeilen | Die Gesamtzahl der Zeilen, die in allen Modi pro Tag zur Codebasis hinzugefügt und gelöscht wurden. |
| Vom Benutzer initiierte Codeänderungen | Von Benutzern vorgeschlagene oder manuell hinzugefügte Zeilen durch Codevervollständigen und Chatpanelaktionen (Einfügen, Kopieren oder Anwenden). |
| Vom Agent initiierte Codeänderungen | Zeilen, die von Agents im Auftrag von Benutzern automatisch zur Codebasis hinzugefügt oder aus ihr gelöscht werden, sowohl im Bearbeitungs-, Agent- als auch im benutzerdefinierten Modus. |
| Vom Benutzer initiierte Codeänderungen pro Modell | Vom Benutzer initiierte Codezeilen, gruppiert nach Modell, das in der IDE verwendet wird. |
| Vom Agent initiierte Codeänderungen pro Modell | Vom Agenten initiierte Codezeilen, gruppiert nach Modellen, die die Aktionen der Agenten ausführen. |
| Vom Benutzer initiierte Codeänderungen pro Sprache | Vom Benutzer initiierte Codezeilen, gruppiert nach Programmiersprache. |
| Vom Agent initiierte Codeänderungen pro Sprache | Vom Agent initiierte Codezeilen, gruppiert nach Programmiersprache. |
API- und Exportfelder
Diese Felder werden in den exportierten NDJSON-Berichten und in den Copilot Verwendungsmetriken-APIs angezeigt. In den meisten Tabellen unten sind der Feldname, sein JSON-Typ, ob der Wert null sein kann, und eine Beschreibung aufgeführt.
Berichte sind je nach Umfang und Granularität unterschiedlich, sodass die in einem Datensatz verfügbaren Felder davon abhängen, aus welchem Bericht sie stammt:
- Benutzerspezifische Berichte (
*-users-1-dayund*-users-28-day) enthalten einen Datensatz pro Benutzer, einschließlichuser_id,user_login,ai_credits_useddieused_*Indikatoren undai_adoption_phase. Sie enthalten keine Anzahl der aktiven Benutzer,pull_requestsodertotals_by_ai_adoption_phase. - Aggregierte Berichte (
enterprise-1-dayundorg-1-day) enthalten einen aggregierten Datensatz pro Unternehmen oder Organisation, einschließlich anzahl aktiver Benutzer,pull_requestsundtotals_by_ai_adoption_phase. Sie enthalten wederuser_id,user_loginnoch dieused_*Indikatoren. - 28-Tage-Berichte (
enterprise-28-dayundorg-28-day) umschließen ein Array täglich aggregierter Datensätze in einemday_totalsFeld mit dem Berichtsfenster auf oberster Ebene. - Benutzerteamsberichte (
*-user-teams-1-day) ordnen Benutzern die Teams zu, zu der sie gehören, sodass Sie Metriken auf Teamebene erstellen können. - Repository-Berichte (
*-repos-1-day) enthalten einen Datensatz pro Repository mit Pull-Request-Aktivitäten für diesen Tag, einschließlich Pull-Requests, die von Copilot-Cloud-Agent erstellt und von Copilot Codeüberprüfung überprüft wurden.
Berichte auf Organisationsebene umfassen neben organization_id auch enterprise_id. Beispielschemas der von den APIs zurückgegebenen Daten finden Sie unter Beispielschema für Copilot Nutzungsmetriken.
In der Spalte "Typ " werden JSON-Schematypen verwendet: string, , integer, number, boolean, , arrayund object. Die Nullable-Spalte gibt an, ob der Wert eines Felds in einem Datensatz vorhanden oder nicht vorhanden sein null kann, in dem es andernfalls angewendet würde. Arrays sind immer vorhanden, können aber leer ([]) sein, sodass sie nicht nullfähig sind.
Felder zur Berichtsidentifikation und Partitionierung
Diese Felder identifizieren den Bereich, das Datum und die (für Exporte) Partition jedes Datensatzes. Welche Elemente genau vorhanden sind, hängt von der Form des Berichts ab.
| Feld | Typ | Nullfähig | Description |
|---|---|---|---|
day | string | Nein | Kalendertag, den dieser Datensatz im YYYY-MM-DD Format darstellt. In 28-tägigen Berichten erscheint day in jedem day_totals-Eintrag statt auf der obersten Ebene. |
enterprise_id | string | Nein | Eindeutige ID des Unternehmens. In Unternehmens- und Organisationsbereichsberichten enthalten. |
organization_id | string | Ja | Eindeutige ID der Organisation. Nur in Berichten auf Organisationsebene enthalten; in Berichten auf Unternehmensebene weggelassen. |
etl_id / day_partition | string | Nein | Partitionsfelder, die für die Haushaltung verwendet werden. In exportierten NDJSON-Dateien enthalten und von den APIs für Nutzungsmetriken zurückgegeben. |
entity_id_partition | integer | Nein | Entitätspartition, die für die Housekeeping verwendet wird. In exportierten NDJSON-Dateien enthalten und von den APIs für Nutzungsmetriken zurückgegeben. |
Benutzerspezifische Berichtsfelder
Benutzerspezifische Berichte enthalten einen Datensatz pro Benutzer für den Berichtszeitraum. Der 28-Tage-Bericht pro Benutzer enthält auch report_start_day und report_end_day, um das Berichtsfenster zu kennzeichnen.
| Feld | Typ | Nullfähig | Description |
|---|---|---|---|
user_id | integer | Nein | Ein eindeutiger Bezeichner für den Benutzer. |
user_login | string | Nein | |
| GitHub Benutzername für den Benutzer. | |||
ai_credits_used | number | Nein | Die Gesamtzahl der KI-Gutschriften, die vom Benutzer im Berichtszeitraum verbraucht wurden. Dieses Feld ist nur in Benutzerberichten enthalten und wird nicht nach Feature, Modell oder Oberfläche aufgeschlüsselt. Diese Metrik dient der Verbrauchsanalyse, nicht den Rechnungsbeträgen. |
user_initiated_ | integer | Nein | Anzahl der expliziten Eingabeaufforderungen, die an Copilot. Zählt nur Nachrichten oder Eingabeaufforderungen, die aktiv an das Modell gesendet werden. Umfasst nicht das Öffnen des Chatpanels, das Wechseln von Modi (z. B. Fragen, Bearbeiten, Plan oder Agent), die Verwendung von Tastenkombinationen zum Öffnen der Inline-Benutzeroberfläche oder Zum Vornehmen von Konfigurationsänderungen. |
code_generation_ | integer | Nein | Anzahl der generierten eindeutigen Copilot Ausgabeereignisse. |
| Enthält: Alle generierten Inhalte, einschließlich Kommentare und Docstrings. | |||
| Mehrere Blöcke: Jeder unterschiedliche Codeblock von einer einzelnen Benutzeraufforderung zählt als separate Generation. | |||
Anmerkung: Diese Metrik ist nicht direkt vergleichbar mit user_initiated_, da eine Eingabeaufforderung mehrere Generationen erzeugen kann. | |||
code_acceptance_ | integer | Nein | Anzahl von Vorschlägen oder Codeblöcken, die von Benutzern akzeptiert werden. |
| Zählt: Alle integrierten Akzeptanzaktionen, wie z. B. "In Datei anwenden", "Am Cursor einfügen", "In Terminal einfügen" und die Verwendung der Schaltfläche Kopieren. | |||
| Zählt nicht: Manuelle Aktionen der Zwischenablage (z. B. Strg+C). | |||
| Granularität: Jede Akzeptanzaktion erhöht den Zähler um eins, unabhängig davon, wie viele Codeblöcke durch die ursprüngliche Eingabeaufforderung generiert wurden. | |||
loc_suggested_ | integer | Nein | Anzahl der Codezeilen Copilot, deren Hinzufügung vorgeschlagen wird (Codevervollständigungen, Inline-Chat, Chatbereich usw.; schließt Agent-Bearbeitungen aus). |
loc_suggested_ | integer | Nein | Codezeilen Copilot, die gelöscht werden sollen, und für die in Zukunft Unterstützung geplant ist. |
loc_added_sum | integer | Nein | Codezeilen, die tatsächlich dem Editor hinzugefügt wurden (akzeptierte Fertigstellungen, angewendete Codeblöcke, Agent und Bearbeitungsmodus). |
loc_deleted_sum | integer | Nein | Zeilen von Code, die aus dem Editor gelöscht wurden (derzeit durch Änderungen von Agenten). |
used_agent | boolean | Nein | Gibt an, ob der Benutzer den Agentmodus an diesem Tag in der IDE verwendet hat. In Copilot Codeüberprüfung ist keine Aktivität enthalten; diese wird separat in used_copilot_ und used_copilot_ erfasst. |
used_chat | boolean | Nein | Gibt an, ob der Benutzer den IDE-Chat an diesem Tag verwendet hat. |
used_cli | boolean | Nein | Gibt an, ob der Benutzer an diesem Tag Copilot CLI verwendet hat. |
used_copilot_ | boolean | Nein | Ob der Benutzer Copilot-Cloud-Agent (früher Copilot-Coding-Agent) an diesem Tag verwendet hat. |
used_copilot_ | boolean | Nein | Gibt an, ob der Benutzer an diesem Tag Copilot-Cloud-Agent verwendet hat. Trägt denselben Wert wie used_copilot_; beide Namen werden aus Gründen der Abwärtskompatibilität beibehalten. |
used_copilot_ | boolean | Ja | Ob sich der Benutzer aktiv mit Copilot Codeüberprüfung diesem Tag beschäftigt hat. Ein Benutzer wird als aktiv betrachtet, wenn er manuell eine Copilot Überprüfung angefordert oder einen Copilot Überprüfungsvorschlag angewendet hat. Null, wenn kein Signal für den Benutzer an diesem Tag vorhanden ist Copilot Codeüberprüfung . |
used_copilot_ | boolean | Ja | Ob dem Benutzer an diesem Tag automatisch Copilot zur Überprüfung seines Pull Requests zugewiesen wurde, ohne dass er sich aktiv an der Überprüfung beteiligt hat. Null, wenn kein Signal für den Benutzer an diesem Tag vorhanden ist Copilot Codeüberprüfung . |
ai_adoption_phase | object | Nein | Die KI-Adoptionsphase des Nutzers für heute. Immer vorhanden; standardmäßig der Phase „Keine Kohorte“ zugeordnet. Siehe Felder für die KI-Einführungsphase. |
totals_by_cli | object | Ja | CLI-spezifische Metriken für den Benutzer. Wird ausgelassen, wenn der Benutzer diesen Tag keine Copilot CLI Verwendung hatte. Siehe Copilot CLI Metrikfelder. |
totals_by_ide | array | Nein | Aufschlüsselung der Benutzeraktivität nach IDE. Siehe Objekte der Aktivitätsaufschlüsselung. |
totals_by_feature | array | Nein | Aufschlüsselung der Aktivität des Benutzers pro Feature. Siehe Objekte der Aktivitätsaufschlüsselung. |
totals_by_language_ | array | Nein | Aufschlüsselung, die Dimensionen Sprache und Funktion kombiniert. Siehe Objekte der Aktivitätsaufschlüsselung. |
totals_by_language_ | array | Nein | Aufschlüsselung nach Sprach- und Modelldimensionen der Chataktivität. Siehe Objekte der Aktivitätsaufschlüsselung. |
totals_by_model_ | array | Nein | Aufschlüsselung der Kombination von Modell- und Featuredimensionen für Chataktivitäten. Siehe Objekte der Aktivitätsaufschlüsselung. |
Aggregierte Enterprise- und Organisationsberichtsfelder
Aggregierte Berichte enthalten einen Datensatz pro Unternehmen oder Organisation, wobei alle Benutzer für den Tag zusammengefasst werden. Die Anzahl der aktiven Benutzer umfasst Benutzer, die über clientseitige und serverseitige Telemetrie identifiziert werden. Benutzer, die nur über serverseitige Telemetriedaten erfasst werden, werden in der Gesamtzahl der aktiven Benutzer mitgezählt, erscheinen jedoch möglicherweise nicht in den Arrays der dimensionalen Aufschlüsselung (totals_by_ide, totals_by_feature und ähnliche). In den folgenden Tabellen werden die Anzahl der aktiven Benutzer und dann die Aktivitätssummen und Aufschlüsselungen aufgeführt.
Anzahl aktiver Benutzer:
| Feld | Typ | Nullfähig | Description |
|---|---|---|---|
daily_active_ | integer | Nein | Anzahl der eindeutigen Benutzer, die Copilot an einem bestimmten Tag verwendet haben. |
weekly_active_ | integer | Nein | Anzahl der eindeutigen Nutzer, die Copilot innerhalb eines gleitenden Sieben-Tage-Zeitraums verwendet haben. |
monthly_active_ | integer | Nein | Anzahl der einzelnen Nutzer, die Copilot innerhalb eines rollierenden 28-Tage-Zeitraums verwendet haben. |
monthly_active_ | integer | Nein | Anzahl der einzelnen Nutzer, die den Chat innerhalb eines rollierenden 28-Tage-Zeitraums genutzt haben. |
monthly_active_ | integer | Nein | Anzahl der einzelnen Nutzer, die den Agentmodus in einem rollierenden 28-Tage-Zeitraum verwendet haben. |
daily_active_ | integer | Nein | Anzahl der eindeutigen Benutzer, die Copilot-Cloud-Agent an einem bestimmten Tag verwendet haben. |
weekly_active_ | integer | Nein | Anzahl der eindeutigen Nutzer, die Copilot-Cloud-Agent innerhalb eines gleitenden Sieben-Tage-Zeitraums verwendet haben. |
monthly_active_ | integer | Nein | Anzahl der einzelnen Nutzer, die Copilot-Cloud-Agent innerhalb eines rollierenden 28-Tage-Zeitraums verwendet haben. |
daily_active_ | integer | Nein | Anzahl der eindeutigen Benutzer, die Copilot Codeüberprüfung an einem bestimmten Tag aktiv benutzt haben. Die aktive Verwendung bedeutet, dass manuell eine Überprüfung angefordert oder ein Vorschlag angewendet wird. Wenn ein Benutzer sowohl aktive als auch passive Signale im selben Zeitraum hat, werden sie nur als aktiv gezählt. |
weekly_active_ | integer | Nein | Die Anzahl der eindeutigen Benutzer, die während eines nachgestellten siebentägigen Fensters Copilot Codeüberprüfung aktiv genutzt haben. Wenn ein Benutzer sowohl aktive als auch passive Signale im selben Zeitraum hat, werden sie nur als aktiv gezählt. |
monthly_active_ | integer | Nein | Die Anzahl eindeutiger Benutzer, die Copilot Codeüberprüfung während eines Zeitraums von 28 Tagen aktiv nutzten. Wenn ein Benutzer sowohl aktive als auch passive Signale im selben Zeitraum hat, werden sie nur als aktiv gezählt. |
daily_passive_ | integer | Nein | Anzahl der einzelnen Nutzer, denen an einem bestimmten Tag automatisch Copilot Codeüberprüfung zur Überprüfung ihrer Pull-Anforderung zugewiesen wurde, ohne dass sie aktiv daran mitgewirkt haben. |
weekly_passive_ | integer | Nein | Anzahl der einzelnen Benutzer, denen in den letzten sieben Tagen automatisch Copilot Codeüberprüfung zur Überprüfung ihrer Pull-Anforderung zugewiesen wurde, ohne dass sie aktiv daran mitgewirkt haben. |
monthly_passive_ | integer | Nein | Anzahl der einzelnen Benutzer, denen in den letzten 28 Tagen automatisch Copilot Codeüberprüfung zur Überprüfung ihrer Pull-Anforderung zugewiesen wurde, ohne dass sie aktiv daran mitgewirkt haben. |
daily_active_ | integer | Ja | Anzahl der eindeutigen Benutzer, die Copilot CLI an einem bestimmten Tag verwendet haben. Diese Anzahl ist unabhängig von der IDE-Anzahl aktiver Benutzer und nicht in IDE-basierten Active-User-Definitionen enthalten. Wird für Unternehmen oder Organisationen ohne CLI-Nutzung an diesem Tag weggelassen. |
Aktivitätssummen und Aufschlüsselungen:
| Feld | Typ | Nullfähig | Description |
|---|---|---|---|
user_initiated_ | integer | Nein | Gesamtzahl der expliziten Prompts, die an Copilot über alle Benutzer hinweg für den Tag gesendet wurden. |
code_generation_ | integer | Nein | Gesamtzahl der eindeutigen Copilot Ausgabeereignisse, die für den betreffenden Tag über alle Benutzer hinweg generiert wurden. |
code_acceptance_ | integer | Nein | Die Gesamtzahl der Vorschläge oder Codeblöcke, die für alle Benutzer für den Tag akzeptiert werden. |
loc_suggested_ | integer | Nein | Summierte Anzahl der Codezeilen, deren Hinzufügen für den Tag vorgeschlagen wurde. Dieselbe Definition wie das Feld pro Benutzer. |
loc_suggested_ | integer | Nein | Aggregierte Codezeilen, die für den Tag gelöscht werden sollen. Dieselbe Definition wie das Feld pro Benutzer. |
loc_added_sum | integer | Nein | Aggregierte Codezeilen, die für den Tag hinzugefügt wurden. Dieselbe Definition wie das Feld pro Benutzer. |
loc_deleted_sum | integer | Nein | Aggregierte Codezeilen, die für den Tag gelöscht wurden. Dieselbe Definition wie das Feld pro Benutzer. |
totals_by_ide | array | Nein | Aggregierte Aufschlüsselung pro IDE-Aktivität. Siehe Objekte der Aktivitätsaufschlüsselung. |
totals_by_feature | array | Nein | Aggregierte Aufschlüsselung der Aktivität nach Feature. Siehe Objekte der Aktivitätsaufschlüsselung. |
totals_by_language_ | array | Nein | Aggregierte Sprach- und Featureaktivitätsaufschlüsselung. Siehe Objekte der Aktivitätsaufschlüsselung. |
totals_by_language_ | array | Nein | Aggregierte Sprach- und Modellaktivitätsaufschlüsselung. Siehe Objekte der Aktivitätsaufschlüsselung. |
totals_by_model_ | array | Nein | Aggregierte Modell- und Featureaktivitätsaufschlüsselung. Siehe Objekte der Aktivitätsaufschlüsselung. |
totals_by_cli | object | Ja | Aggregierte Copilot CLI Metriken für den Tag. Wird ausgelassen, wenn an diesem Tag keine CLI-Verwendung vorhanden ist. Im Gegensatz zum Formular pro Benutzer enthält es kein last_known_cli_. Siehe Copilot CLI Metrikfelder. |
totals_by_ai_ | array | Ja | Aggregierte Werte je Phase für Benutzer und deren durchschnittliche Aktivität. Wird ausgelassen, wenn keine Daten zur Einführungsphase verfügbar sind. Siehe Felder für die KI-Einführungsphase. |
pull_requests | object | Nein | Tägliche Pull-Request-Aktivität eines Unternehmens oder einer Organisation. Siehe Aktivitätsfelder für Pull-Requests. |
Felder des 28-Tage-Berichts
Die 28-Tage-Berichte (enterprise-28-day und org-28-day) sind Wrapper: Sie tragen das Berichtsfenster auf der obersten Ebene und eine Reihe von täglich aggregierten Datensätzen.
| Feld | Typ | Nullfähig | Description |
|---|---|---|---|
report_start_day | string | Nein | Erster Kalendertag des 28-tägigen Berichtsfensters im YYYY-MM-DD Format. |
report_end_day | string | Nein | Letzter Kalendertag des 28-tägigen Berichtsfensters im YYYY-MM-DD Format. |
created_at | string | Nein | Zeitstempel (ISO 8601), als der Bericht generiert wurde. |
day_totals | array | Nein | Sammlung täglich aggregierter Datensätze. Jeder Eintrag weist dieselben Felder wie ein aggregierter 1-Tage-Bericht auf. Siehe Aggregierte Enterprise- und Organisationsberichtsfelder. |
Benutzerteam-Felder
Diese Felder erscheinen im täglichen Bericht „Benutzerteams“ (verfügbar über die REST-API auf Organisations- und Unternehmensebene) und werden verwendet, um teambezogene Metriken durch Verknüpfen mit dem Bericht zu den Nutzungsmetriken pro Benutzer zu erstellen. Die vollständige Verknüpfungsrezept und die Endpunkt-URLs finden Sie unter Copilot Nutzungsmetriken auf Teamebene.
Teams mit weniger als 5 sitzenden Copilot Benutzern an einem bestimmten Tag werden vom Bericht "Benutzerteams" ausgeschlossen.
| Feld | Typ | Nullfähig | Description |
|---|---|---|---|
user_id | integer | Nein | Ein eindeutiger Bezeichner für den Benutzer. |
user_login | string | Nein | |
| GitHub Benutzername für den Benutzer. | |||
day | string | Nein | Der Kalendertag, den dieser Datensatz darstellt. |
organization_id | string | Nein | Eindeutige ID der Organisation, zu der das Team gehört. Nur Organisationsbereich. |
enterprise_id | string | Nein | Eindeutige ID des Unternehmens, zu dem das Team gehört. Nur Enterprise-Bereich. Der Bericht auf Unternehmensebene umfasst sowohl Teams auf Unternehmensebene als auch Geschäftsteams. |
team_id | integer | Nein | Eindeutige ID des Teams, zu dem der Benutzer gehört. |
slug | string | Nein | URL-freundlicher Bezeichner für das Team. |
Felder auf Repositoryebene (nur API)
Berichte auf Repository-Ebene zeigen die tägliche Aktivität bei der Erstellung, Überprüfung, Zusammenführung und bei Vorschlägen für Pull Requests in Repositorys einer Organisation oder eines Unternehmens, einschließlich Pull Requests, die von Copilot-Cloud-Agent erstellt und von Copilot Codeüberprüfung überprüft wurden. Jede Zeile stellt ein Repository dar, das die Abrufanforderungsaktivität am angeforderten Tag hatte; Repositorys ohne Aktivität werden weggelassen. Diese Berichte konzentrieren sich auf die Lebenszyklusaktivität der Pull-Anforderung und können Daten enthalten, auch wenn IDE-Nutzungsmetriken fehlen.
Diese Felder werden vom täglichen Bericht auf Repositoryebene (repos-1-day) zurückgegeben, der über die REST-API im Organisations- und Unternehmensbereich verfügbar ist. Informationen zu den Endpunkt-URLs, Antwortumschlägen, Berechtigungen und Downloadworkflows finden Sie unter REST-API-Endpunkte für Copilot Nutzungsmetriken. Beispielzeilen finden Sie unter Beispielschema für Copilot Nutzungsmetriken.
| Feld | Typ | Nullfähig | Description |
|---|---|---|---|
day | string | Nein | Kalendertag, den dieser Datensatz im YYYY-MM-DD Format darstellt. |
enterprise_id | string | Nein | Eindeutige ID des Unternehmens. Ausgefüllt in Berichten auf Unternehmensebene und in Berichten auf Organisationsebene für Organisationen, die einem Unternehmen gehören. Leer für Organisationen, die keinem Unternehmen gehören. |
organization_id | string | Nein | Eindeutige ID der Organisation, die das Repository besitzt. Sowohl in Berichten auf Unternehmens- als auch auf Organisationsebene enthalten. |
repo_id | integer | Nein | Eindeutige ID des Repositorys. |
repo_owner_name | string | Nein | Anmeldung des Repositorybesitzers. |
repo_name | string | Nein | Repositoryname. |
repo_visibility | string | Nein | Sichtbarkeit des Repositorys. Mögliche Werte sind PRIVATE, INTERNAL und PUBLIC. |
pull_requests | object | Nein | Tägliche Pull-Request-Aktivität im Repository. Siehe Aktivitätsfelder für Pull-Requests. |
Objekte der Aktivitätsgliederung
Die totals_by_* Felder sind Arrays von Aufschlüsselungsobjekten. Das Array ist immer vorhanden, kann aber leer sein. Innerhalb jedes Objekts folgen die Metrikfelder (*_count und loc_*_sum) den gleichen Definitionen wie die Felder auf oberster Ebene pro Benutzer, und die Dimensionsfelder tragen die Werte, die in Strukturabgrenzungswerten dokumentiert sind.
| Objekt | Dimensionsfelder | Description |
|---|---|---|
totals_by_ide[] | ide | Aufschlüsselung nach IDE. In Berichten pro Benutzer enthält jeder Eintrag auch last_known_ide_ und last_known_plugin_. |
totals_by_feature[] | feature | Aufschlüsselung nach Copilot Feature (z. B. Inlinechat oder Chatpanel). |
totals_by_language_ | ||
language, feature | Aufschlüsselung nach Sprache und Funktion. Enthält nicht user_initiated_. | |
totals_by_language_ | ||
language, model | Aufschlüsselung nach Sprache und Modell für Chat-Aktivitäten (nicht Vervollständigungen). | |
totals_by_model_ | ||
model, feature | Aufschlüsselung der Kombination von Modell und Feature für Chataktivitäten (keine Fertigstellungen). |
In Benutzerberichten meldet jeder totals_by_ide[] Eintrag auch die zuletzt erkannten IDE- und Copilot-Chat Erweiterungsversionen für den Benutzer.
| Feld | Typ | Nullfähig | Description |
|---|---|---|---|
last_known_ide_ | object | Ja | Neueste für den Benutzer erkannte IDE-Version: { ide_version, sampled_at }. Wird für aggregierte Aufschlüsselungszeilen weggelassen, z. B. bei dem begrenzten IDE-Bucket „Sonstige“. |
last_known_ide_ | string | Nein | IDE-Versionszeichenfolge. Vorhanden, wenn last_known_ide_ vorhanden ist. |
last_known_ide_ | string | Ja | Zeitstempel (ISO 8601), zu dem die Version erfasst wurde. |
last_known_plugin_ | object | Ja | Die neueste Copilot Erweiterung wurde beim Nutzer erkannt, und zwar als { plugin, plugin_version, sampled_at }. Wird für aggregierte Aufschlüsselungszeilen weggelassen. |
last_known_plugin_ | string | Nein | Erweiterungsname (z. B copilot . oder copilot-chat). Vorhanden, wenn last_known_plugin_ vorhanden ist. |
last_known_plugin_ | string | Nein | Versionszeichenfolge der Erweiterung Vorhanden, wenn last_known_plugin_ vorhanden ist. |
last_known_plugin_ | string | Ja | Zeitstempel (ISO 8601), zu dem die Version erfasst wurde. |
Copilot CLI Metrikfelder
Das totals_by_cli-Objekt enthält die folgenden verschachtelten Felder, wenn eine Copilot CLI-Verwendung vorliegt; das Objekt wird weggelassen, wenn keine CLI-Nutzung vorliegt. Die CLI-Nutzung ist unabhängig von IDE-Metriken – sie spiegelt sich nicht in Feldern wie totals_by_ide oder totals_by_feature wider. Das last_known_cli_version Objekt wird nur in Benutzerberichten angezeigt.
| Feld | Typ | Nullfähig | Description |
|---|---|---|---|
totals_by_cli.session_ | integer | Nein | Die Anzahl der verschiedenen CLI-Sitzungen, die an diesem Tag initiiert wurden. |
totals_by_cli.request_ | integer | Nein | Gesamtzahl der Anforderungen, die an diesem Tag über die CLI an Copilot gestellt wurden, einschließlich sowohl von Benutzern ausgelöster Prompts als auch automatisierter Folgeanrufe durch Agents. |
totals_by_cli.prompt_ | integer | Nein | Die Gesamtzahl der Benutzereingabeaufforderungen, Befehle oder Abfragen, die innerhalb einer Sitzung ausgeführt werden. |
totals_by_cli.token_ | integer | Nein | Die Gesamtzahl der Ausgabetoken, die an diesem Tag über alle CLI-Anforderungen generiert wurden. |
totals_by_cli.token_ | integer | Nein | Die Gesamtzahl der Aufforderungstoken, die an diesem Tag über alle CLI-Anforderungen gesendet wurden. |
totals_by_cli.token_ | number | Ja | Durchschnittliche Anzahl der Ausgabe- und Prompt-Token pro CLI-Anforderung, berechnet als (output_tokens_. Null, als an diesem Tag keine Anforderungen vorhanden waren. |
totals_by_cli.last_ | object | Nein | Die neueste Copilot CLI Version, die für den Benutzer an diesem Tag als { cli_version, sampled_at } erkannt wurde. Nur Berichte pro Benutzer. |
totals_by_cli.last_ | string | Nein | |
Copilot CLI Versionszeichenfolge. Standardmäßig wird unknown verwendet, wenn keine Version erkannt wurde. | |||
totals_by_cli.last_ | string | Ja | Zeitstempel (ISO 8601), zu dem die Version erfasst wurde. |
Aktivitätsfelder für Pull Requests
Wichtig
Berichte auf Organisations- und Unternehmensebene zeigen aufgrund von Unterschieden bei Benutzerdeduplizierung und Attributionstiming möglicherweise unterschiedliche Summen an. Anleitungen zum Interpretieren von Pullanforderungsmetriken in Bereichen finden Sie unter GitHub Copilot Nutzungsmetriken.
Das pull_requests Objekt wird in aggregierten Unternehmens- und Organisationsberichten sowie in Berichten auf Repositoryebene angezeigt. Es erfasst die tägliche Erstellung, Überprüfung und Zusammenführung von Pull Requests sowie Aktivitäten im Zusammenhang mit Vorschlägen, einschließlich der von Copilot-Cloud-Agent und Copilot Codeüberprüfung ausgeführten Aktivitäten.
| Feld | Typ | Nullfähig | Description |
|---|---|---|---|
pull_requests.total_ | integer | Nein | Die Gesamtzahl der Pullanforderungen, die an diesem bestimmten Tag erstellt wurden. Die Erstellung ist ein einmaliges Ereignis. Jede Pullanforderung wird nur am Tag gezählt, an dem sie erstellt wird. |
pull_requests.total_ | integer | Nein | Die Gesamtzahl der Pull-Requests, die an diesem bestimmten Tag überprüft wurden. Die gleiche Pullanforderung kann an mehreren Tagen gezählt werden, wenn sie Rezensionen an mehreren Tagen empfängt. Innerhalb eines einzelnen Tages wird jede Pullanforderung einmal gezählt, auch wenn mehrere Überprüfungsaktionen auftreten. |
pull_requests.total_ | integer | Nein | Die Gesamtzahl der Pull-Requests, die an diesem Tag zusammengeführt wurden. Das Zusammenführen ist ein einmaliges Ereignis. Jede Pullanforderung wird nur am Tag gezählt, an dem sie zusammengeführt wird. |
pull_requests.median_ | number | Ja | Medianzeit in Minuten zwischen der Erstellung der Pullanforderung und dem Zusammenführen für Pullanforderungen, die an diesem bestimmten Tag zusammengeführt werden. Median wird verwendet, um die Auswirkungen von Ausreißern bei ungewöhnlich lange laufenden Pull Requests zu reduzieren. Null, wenn an diesem Tag keine Pull Requests gemergt wurden. |
pull_requests.total_ | integer | Nein | Die Gesamtzahl der Pull-Request-Bewertungsvorschläge, die an diesem bestimmten Tag generiert wurden, unabhängig vom Autor. |
pull_requests.total_ | integer | Nein | Gesamtzahl der Vorschläge zur Pullanforderungsüberprüfung, die an diesem bestimmten Tag angewendet wurden, unabhängig vom Autor. |
pull_requests.total_ | integer | Nein | Die Anzahl der Pullanforderungen, die Copilot-Cloud-Agent an diesem bestimmten Tag erstellt wurden. |
pull_requests.total_ | integer | Nein | Anzahl der Pull-Requests, die Copilot Codeüberprüfung an diesem bestimmten Tag überprüft hat. Eine Pullanforderung kann an mehreren Tagen gezählt werden, wenn Copilot Codeüberprüfung sie an mehreren Tagen überprüft wird. |
pull_requests.total_ | integer | Nein | Die Anzahl der von Copilot-Cloud-Agent erstellten Pullanforderungen, die an diesem bestimmten Tag zusammengeführt wurden. Jede Pullanforderung wird nur am Tag gezählt, an dem sie zusammengeführt wird. |
pull_requests.total_ | integer | Nein | Anzahl der Pull Requests, die sowohl zusammengeführt als auch von Copilot Codeüberprüfung während des Berichtszeitraums überprüft wurden. |
pull_requests.median_ | number | Ja | Medianzeit in Minuten zwischen der Erstellung von Pullanforderungen und dem Zusammenführen für Pullanforderungen, die von Copilot-Cloud-Agent erstellt und an diesem bestimmten Tag zusammengeführt wurden. Null, wenn an diesem Tag keine solchen Pullanforderungen zusammengeführt wurden. |
pull_requests.median_ | number | Ja | Medianzeit, in Minuten, zwischen der Erstellung und dem Zusammenführen von Pull-Anforderungen, berechnet nur für die Pull-Anforderungen, die von Copilot Codeüberprüfung überprüft wurden. Null, wenn an diesem Tag keine solchen Pullanforderungen zusammengeführt wurden. |
pull_requests.total_ | integer | Nein | Die Anzahl der Vorschläge zur Überprüfung von Pull-Anfragen, die von Copilot Codeüberprüfung an diesem bestimmten Tag generiert wurden. |
pull_requests.total_ | integer | Nein | Anzahl der von Copilot Codeüberprüfung generierten Review-Vorschläge für Pull-Anfragen, die an diesem bestimmten Tag angewendet wurden. |
pull_requests.copilot_ | array | Nein | Aggregierte Anzahl von Copilot Codeüberprüfung Vorschlägen, aufgeschlüsselt nach dem zugewiesenen Kommentartyp (z. B. security oder bug_risk). Jeder Eintrag enthält comment_type, total_copilot_und total_copilot_. Immer vorhanden, kann aber leer sein. |
Ki-Einführungsphasenfelder
Copilot gruppiert Benutzer basierend auf ihrer Aktivität in KI-Einführungsphasen. Phaseninformationen werden an zwei Stellen angezeigt: das Benutzerobjekt ai_adoption_phase und das aggregierte totals_by_ai_adoption_phase Array. Die Phasenwerte finden Sie unter "Aufschlüsselungsdimensionswerte".
Klassifizierungslogik
Ein Benutzer wird anhand dessen, welche used_* benutzerspezifischen Felder (siehe Felder im Bericht pro Nutzer) an mindestens zwei aktiven Tagen innerhalb des rollierenden 28-Tage-Fensterstrue sind, in eine Phase eingeteilt:
| Phase | Oberflächenkriterien |
|---|---|
| Kein Kohort (im Auswirkungsdashboard als "Passive Benutzer" angezeigt) | Der Benutzer hat in keiner Phase innerhalb des Zeitfensters den Schwellenwert für eine zweitägige Interaktion erreicht. |
| Phase 1: Code zuerst | An mindestens zwei aktiven Tagen, an denen used_chat``true ist, code_acceptance_ größer als 0 ist oder used_agent``true ist. |
| Phase 2: Agent an erster Stelle | Mindestens zwei Aktive Tage, an denen eine einzelne GitHub-basierte Agentoberfläche verwendet wurde: used_cli ist true, used_copilot_ ist trueoder used_copilot_ ist true. Passive Copilot Codeüberprüfung Aktivität (used_copilot_) zählt nicht zur Phasenklassifizierung. |
| Phase 3: Multi-Agenten | Mindestens zwei Aktive Tage, an denen zwei oder mehr der unter Phase 2 aufgeführten GitHub-basierten Agentoberflächen verwendet wurden. |
Ein Nutzer benötigt nur zwei qualifizierte Tage gemäß den jeweiligen Kriterien einer Phase, um diese Phase zu erreichen. Ein Nutzer muss die Kriterien für Phase 1 nicht eigenständig erfüllen, um Phase 2 oder Phase 3 zu erreichen, obwohl in der Praxis die Nutzung von Agent-Oberflächen meist zusammen mit Abschlussvorgängen oder Chat-Aktivität auftritt.
Die Phasenzuweisung wird jeden Tag mithilfe des nachfolgenden 28-Tage-Fensters neu berechnet, sodass sich die Phase eines Benutzers von einem Tag zum nächsten ändern kann, während sich die Aktivität innerhalb des Fensters ändert. Dies ist ein erwartetes Verhalten und weist nicht auf einen Datenfehler hin.
Das Objekt pro Benutzer ai_adoption_phase enthält:
| Feld | Typ | Nullfähig | Description |
|---|---|---|---|
ai_adoption_phase.phase_ | integer | Nein | Numerischer Phasenbezeichner (zum Beispiel 0 für „Keine Kohorte“). |
ai_adoption_phase.phase | string | Nein | Menschenlesbarer Phasenname. |
ai_adoption_phase.version | string | Nein | Version des verwendeten Einführungsphasenmodells (z. B. v1). |
Jeder Eintrag im aggregierten totals_by_ai_adoption_phase Array enthält:
| Feld | Typ | Nullfähig | Description |
|---|---|---|---|
phase | string | Nein | Menschenlesbarer Phasenname. |
phase_number | integer | Nein | Numerischer Phasenbezeichner. |
total_engaged_ | integer | Nein | Anzahl der Nutzer, die in diesem Zeitraum dieser Phase zugeordnet wurden. |
avg_user_initiated_ | number | Nein | Durchschnittliche benutzerinitiierte Interaktionen pro Benutzer in dieser Phase. |
avg_code_generation_ | number | Nein | Durchschnittliche Codegenerierungsaktivitäten pro Benutzer in dieser Phase. |
avg_code_acceptance_ | number | Nein | Durchschnittliche Codeakzeptanzaktivitäten pro Benutzer in dieser Phase. |
avg_loc_added | number | Nein | Durchschnittliche Codezeilen, die pro Benutzer in dieser Phase hinzugefügt wurden. |
avg_loc_deleted | number | Nein | Durchschnittliche Codezeilen, die pro Benutzer in dieser Phase gelöscht wurden. |
avg_pull_requests_ | number | Nein | Durchschnittliche Pullanforderungen, die pro Benutzer in dieser Phase überprüft wurden. |
avg_pull_requests_ | number | Nein | Durchschnittliche Pullanforderungen, die pro Benutzer in dieser Phase erstellt wurden. |
avg_pull_requests_ | number | Nein | Durchschnittliche Pullanforderungen, die pro Benutzer in dieser Phase zusammengeführt werden. |
total_pull_requests_ | integer | Nein | Gesamtzahl der in dieser Phase durch Benutzer zusammengeführten Pull Requests. Gilt für aggregierte Berichte für den Organisationstag und den Unternehmenstag. |
avg_pull_requests_ | number | Nein | Durchschnitt des Medians der Minuten bis zur Zusammenführung pro Benutzer in dieser Phase. |
Werte der Aufschlüsselungsdimension
Die oben aufgeführten Aufschlüsselungsobjekte verwenden Dimensionsfelder, deren Werte aus festen Mengen stammen. Dies sind Feldwerte, keine separaten Felder. Beispielsweise sind agent_edit und die chat_panel_*_mode-Werte Werte des Feldes feature und keine Felder der obersten Ebene.
Die feature Dimension identifiziert das Feature oder den Copilot Modus, dem eine Aktivität zugeordnet wird:
| Wert | Description |
|---|---|
code_completion | Inline-Codevervollständigungen. |
chat_inline | Inlinechat im Editor. |
chat_panel_ask_ | Chatpanelinteraktionen mit ausgewähltem Ask-Modus. |
chat_panel_edit_ | Chatpanelinteraktionen mit ausgewähltem Bearbeitungsmodus. |
chat_panel_agent_ | Chatpanelinteraktionen mit ausgewähltem Agentmodus. |
chat_panel_plan_ | Interaktionen im Chat-Panel bei ausgewähltem Planmodus. |
chat_panel_custom_ | Chatpanelinteraktionen mit einem ausgewählten benutzerdefinierten Agent. |
chat_panel_unknown_ | Chatpanelinteraktionen, bei denen der Modus unbekannt ist. |
agent_edit | Zeilen, die hinzugefügt und gelöscht werden, wenn Copilot (im Agent- und Bearbeitungsmodus) Änderungen direkt in Ihre Dateien in der IDE schreiben. Zählt auch Bearbeitungen von benutzerdefinierten Agenten. |
agent_edit ist nicht in vorschlagsbasierten Metriken enthalten und befüllt möglicherweise keine vorschlagsbasierten Felder, wie z. B. user_initiated_. | |
copilot_cli | Aktivität zugeschrieben an Copilot CLI. |
others | Alle Features, die von den oben genannten Werten nicht abgedeckt werden. |
Die ide Dimension identifiziert die IDE, in der eine Aktivität aufgetreten ist. Dies ist keine vollständige Liste, aber Beispiele für beobachtete Werte sind vscode, visualstudio, intellij, eclipse, xcode, neovim, vim, emacs und zed.
Die model Dimension identifiziert das KI-Modell, das für Chataktivitäten verwendet wird. Die Werte umfassen bestimmte Modellbezeichner (z. B. gpt-5.4 oder claude-sonnet-4.6), auto, unknown und others. Der Wert auto steht für Aktivität, bei der Automatische Modellauswahl verwendet wurde und die Anfrage keinem bestimmten Modell zugeordnet wurde.
Die phase Dimension identifiziert die KI-Einführungsphase, in der ein Benutzer gruppiert wird: No Cohort, , Phase 1, , Phase 2oder Phase 3.