Skip to main content

In den Nutzungsmetriken von Copilot verfügbare Daten

Copilot Nutzungsmetrikendaten sind über das Dashboard und die APIs verfügbar, wobei eine konsistente Gruppe von Feldern verwendet wird, die die Akzeptanz, Verwendung und Codegenerierungsaktivität darstellen.

Wer kann dieses Feature verwenden?

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

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.

MetricDescription
AgenteneinführungProzentsatz der Copilotlizenzierten aktiven Benutzer, die einen Agent im aktuellen Kalendermonat ausprobiert haben.
Durchschnittliche Chatanfragen pro aktiver BenutzerDurchschnittliche Anzahl von Chatanfragen pro aktivem Benutzer.
Code-Vervollständigungen (vorgeschlagen/akzeptiert)Gesamtanzahl der angezeigten und akzeptierten Inlinecodevorschläge.
Akzeptanzrate der Code-VervollständigungProzentsatz der von Benutzern angenommenen Vorschläge.
Täglich aktive BenutzerAnzahl der eindeutigen Benutzer, die Copilot an einem bestimmten Tag verwendet haben.
Aktive Benutzer pro WocheAnzahl der eindeutigen Benutzer, die Copilot während eines siebentägigen Fensters verwendet haben.
Gesamtzahl der aktiven BenutzerLizenzierte Benutzer, die im aktuellen Kalendermonat aktiv sind.
SprachverwendungVerteilung der mit Copilot verwendeten Programmiersprachen.
Sprachnutzung pro TagTägliche Aufschlüsselung der verwendeten Sprachen.
ModellverwendungVerteilung von KI-Modellen, die für Chats verwendet werden.
Modellnutzung pro TagTägliche Aufschlüsselung der Chatmodellnutzung.
Modellnutzung pro ChatmodusModellnutzung nach Copilot Funktion (Fragen, Bearbeiten, Planen, Agent).
Modellverwendung pro SpracheVerteilung der Sprachen nach Modell aufgeschlüsselt.
Am häufigsten verwendete ChatmodellDas am häufigsten verwendete Chatmodell in den letzten 28 Tagen.
Anforderungen pro ChatmodusAnzahl 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.

MetricDescription
InteraktionstrendsWie 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ührungskohortenAnteil 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.
AkzeptanzmultiplikatorVergleicht 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.
RecommendationsVorgeschlagene 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.

MetricDescription
Codezeilen, die mit KI geändert wurdenGesamtanzahl der Codezeilen, die in allen Modi in den letzten 28 Tagen hinzugefügt und gelöscht wurden.
Agent-BeitragProzentsatz 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 wurdenDurchschnittliche 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 ZeilenDie Gesamtzahl der Zeilen, die in allen Modi pro Tag zur Codebasis hinzugefügt und gelöscht wurden.
Vom Benutzer initiierte CodeänderungenVon Benutzern vorgeschlagene oder manuell hinzugefügte Zeilen durch Codevervollständigen und Chatpanelaktionen (Einfügen, Kopieren oder Anwenden).
Vom Agent initiierte CodeänderungenZeilen, 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 ModellVom Benutzer initiierte Codezeilen, gruppiert nach Modell, das in der IDE verwendet wird.
Vom Agent initiierte Codeänderungen pro ModellVom Agenten initiierte Codezeilen, gruppiert nach Modellen, die die Aktionen der Agenten ausführen.
Vom Benutzer initiierte Codeänderungen pro SpracheVom Benutzer initiierte Codezeilen, gruppiert nach Programmiersprache.
Vom Agent initiierte Codeänderungen pro SpracheVom 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-day und *-users-28-day) enthalten einen Datensatz pro Benutzer, einschließlich user_id, user_login, ai_credits_useddie used_* Indikatoren und ai_adoption_phase. Sie enthalten keine Anzahl der aktiven Benutzer, pull_requests oder totals_by_ai_adoption_phase.
  • Aggregierte Berichte (enterprise-1-day und org-1-day) enthalten einen aggregierten Datensatz pro Unternehmen oder Organisation, einschließlich anzahl aktiver Benutzer, pull_requestsund totals_by_ai_adoption_phase. Sie enthalten weder user_id, user_login noch die used_*Indikatoren.
  • 28-Tage-Berichte (enterprise-28-day und org-28-day) umschließen ein Array täglich aggregierter Datensätze in einem day_totals Feld 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.

FeldTypNullfähigDescription
daystringNeinKalendertag, 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_idstringNeinEindeutige ID des Unternehmens. In Unternehmens- und Organisationsbereichsberichten enthalten.
organization_idstringJaEindeutige ID der Organisation. Nur in Berichten auf Organisationsebene enthalten; in Berichten auf Unternehmensebene weggelassen.
etl_id / day_partitionstringNeinPartitionsfelder, die für die Haushaltung verwendet werden. In exportierten NDJSON-Dateien enthalten und von den APIs für Nutzungsmetriken zurückgegeben.
entity_id_partitionintegerNeinEntitä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.

FeldTypNullfähigDescription
user_idintegerNeinEin eindeutiger Bezeichner für den Benutzer.
user_loginstringNein
GitHub Benutzername für den Benutzer.
ai_credits_usednumberNeinDie 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_interaction_countintegerNeinAnzahl 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_activity_countintegerNeinAnzahl 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_interaction_count, da eine Eingabeaufforderung mehrere Generationen erzeugen kann.
code_acceptance_activity_countintegerNeinAnzahl 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_to_add_sumintegerNeinAnzahl der Codezeilen Copilot, deren Hinzufügung vorgeschlagen wird (Codevervollständigungen, Inline-Chat, Chatbereich usw.; schließt Agent-Bearbeitungen aus).
loc_suggested_to_delete_sumintegerNeinCodezeilen Copilot, die gelöscht werden sollen, und für die in Zukunft Unterstützung geplant ist.
loc_added_sumintegerNeinCodezeilen, die tatsächlich dem Editor hinzugefügt wurden (akzeptierte Fertigstellungen, angewendete Codeblöcke, Agent und Bearbeitungsmodus).
loc_deleted_sumintegerNeinZeilen von Code, die aus dem Editor gelöscht wurden (derzeit durch Änderungen von Agenten).
used_agentbooleanNeinGibt 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_code_review_active und used_copilot_code_review_passive erfasst.
used_chatbooleanNeinGibt an, ob der Benutzer den IDE-Chat an diesem Tag verwendet hat.
used_clibooleanNeinGibt an, ob der Benutzer an diesem Tag Copilot CLI verwendet hat.
used_copilot_coding_agentbooleanNeinOb der Benutzer Copilot-Cloud-Agent (früher Copilot-Coding-Agent) an diesem Tag verwendet hat.
used_copilot_cloud_agentbooleanNeinGibt an, ob der Benutzer an diesem Tag Copilot-Cloud-Agent verwendet hat. Trägt denselben Wert wie used_copilot_coding_agent; beide Namen werden aus Gründen der Abwärtskompatibilität beibehalten.
used_copilot_code_review_activebooleanJaOb 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_code_review_passivebooleanJaOb 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_phaseobjectNeinDie 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_cliobjectJaCLI-spezifische Metriken für den Benutzer. Wird ausgelassen, wenn der Benutzer diesen Tag keine Copilot CLI Verwendung hatte. Siehe Copilot CLI Metrikfelder.
totals_by_idearrayNeinAufschlüsselung der Benutzeraktivität nach IDE. Siehe Objekte der Aktivitätsaufschlüsselung.
totals_by_featurearrayNeinAufschlüsselung der Aktivität des Benutzers pro Feature. Siehe Objekte der Aktivitätsaufschlüsselung.
totals_by_language_featurearrayNeinAufschlüsselung, die Dimensionen Sprache und Funktion kombiniert. Siehe Objekte der Aktivitätsaufschlüsselung.
totals_by_language_modelarrayNeinAufschlüsselung nach Sprach- und Modelldimensionen der Chataktivität. Siehe Objekte der Aktivitätsaufschlüsselung.
totals_by_model_featurearrayNeinAufschlü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:

FeldTypNullfähigDescription
daily_active_usersintegerNeinAnzahl der eindeutigen Benutzer, die Copilot an einem bestimmten Tag verwendet haben.
weekly_active_usersintegerNeinAnzahl der eindeutigen Nutzer, die Copilot innerhalb eines gleitenden Sieben-Tage-Zeitraums verwendet haben.
monthly_active_usersintegerNeinAnzahl der einzelnen Nutzer, die Copilot innerhalb eines rollierenden 28-Tage-Zeitraums verwendet haben.
monthly_active_chat_usersintegerNeinAnzahl der einzelnen Nutzer, die den Chat innerhalb eines rollierenden 28-Tage-Zeitraums genutzt haben.
monthly_active_agent_usersintegerNeinAnzahl der einzelnen Nutzer, die den Agentmodus in einem rollierenden 28-Tage-Zeitraum verwendet haben.
daily_active_copilot_cloud_agent_usersintegerNeinAnzahl der eindeutigen Benutzer, die Copilot-Cloud-Agent an einem bestimmten Tag verwendet haben.
weekly_active_copilot_cloud_agent_usersintegerNeinAnzahl der eindeutigen Nutzer, die Copilot-Cloud-Agent innerhalb eines gleitenden Sieben-Tage-Zeitraums verwendet haben.
monthly_active_copilot_cloud_agent_usersintegerNeinAnzahl der einzelnen Nutzer, die Copilot-Cloud-Agent innerhalb eines rollierenden 28-Tage-Zeitraums verwendet haben.
daily_active_copilot_code_review_usersintegerNeinAnzahl 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_copilot_code_review_usersintegerNeinDie 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_copilot_code_review_usersintegerNeinDie 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_copilot_code_review_usersintegerNeinAnzahl 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_copilot_code_review_usersintegerNeinAnzahl 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_copilot_code_review_usersintegerNeinAnzahl 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_cli_usersintegerJaAnzahl 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:

FeldTypNullfähigDescription
user_initiated_interaction_countintegerNeinGesamtzahl der expliziten Prompts, die an Copilot über alle Benutzer hinweg für den Tag gesendet wurden.
code_generation_activity_countintegerNeinGesamtzahl der eindeutigen Copilot Ausgabeereignisse, die für den betreffenden Tag über alle Benutzer hinweg generiert wurden.
code_acceptance_activity_countintegerNeinDie Gesamtzahl der Vorschläge oder Codeblöcke, die für alle Benutzer für den Tag akzeptiert werden.
loc_suggested_to_add_sumintegerNeinSummierte Anzahl der Codezeilen, deren Hinzufügen für den Tag vorgeschlagen wurde. Dieselbe Definition wie das Feld pro Benutzer.
loc_suggested_to_delete_sumintegerNeinAggregierte Codezeilen, die für den Tag gelöscht werden sollen. Dieselbe Definition wie das Feld pro Benutzer.
loc_added_sumintegerNeinAggregierte Codezeilen, die für den Tag hinzugefügt wurden. Dieselbe Definition wie das Feld pro Benutzer.
loc_deleted_sumintegerNeinAggregierte Codezeilen, die für den Tag gelöscht wurden. Dieselbe Definition wie das Feld pro Benutzer.
totals_by_idearrayNeinAggregierte Aufschlüsselung pro IDE-Aktivität. Siehe Objekte der Aktivitätsaufschlüsselung.
totals_by_featurearrayNeinAggregierte Aufschlüsselung der Aktivität nach Feature. Siehe Objekte der Aktivitätsaufschlüsselung.
totals_by_language_featurearrayNeinAggregierte Sprach- und Featureaktivitätsaufschlüsselung. Siehe Objekte der Aktivitätsaufschlüsselung.
totals_by_language_modelarrayNeinAggregierte Sprach- und Modellaktivitätsaufschlüsselung. Siehe Objekte der Aktivitätsaufschlüsselung.
totals_by_model_featurearrayNeinAggregierte Modell- und Featureaktivitätsaufschlüsselung. Siehe Objekte der Aktivitätsaufschlüsselung.
totals_by_cliobjectJaAggregierte 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_version. Siehe Copilot CLI Metrikfelder.
totals_by_ai_adoption_phasearrayJaAggregierte 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_requestsobjectNeinTä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.

FeldTypNullfähigDescription
report_start_daystringNeinErster Kalendertag des 28-tägigen Berichtsfensters im YYYY-MM-DD Format.
report_end_daystringNeinLetzter Kalendertag des 28-tägigen Berichtsfensters im YYYY-MM-DD Format.
created_atstringNeinZeitstempel (ISO 8601), als der Bericht generiert wurde.
day_totalsarrayNeinSammlung 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.

FeldTypNullfähigDescription
user_idintegerNeinEin eindeutiger Bezeichner für den Benutzer.
user_loginstringNein
GitHub Benutzername für den Benutzer.
daystringNeinDer Kalendertag, den dieser Datensatz darstellt.
organization_idstringNeinEindeutige ID der Organisation, zu der das Team gehört. Nur Organisationsbereich.
enterprise_idstringNeinEindeutige 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_idintegerNeinEindeutige ID des Teams, zu dem der Benutzer gehört.
slugstringNeinURL-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.

FeldTypNullfähigDescription
daystringNeinKalendertag, den dieser Datensatz im YYYY-MM-DD Format darstellt.
enterprise_idstringNeinEindeutige 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_idstringNeinEindeutige ID der Organisation, die das Repository besitzt. Sowohl in Berichten auf Unternehmens- als auch auf Organisationsebene enthalten.
repo_idintegerNeinEindeutige ID des Repositorys.
repo_owner_namestringNeinAnmeldung des Repositorybesitzers.
repo_namestringNeinRepositoryname.
repo_visibilitystringNeinSichtbarkeit des Repositorys. Mögliche Werte sind PRIVATE, INTERNAL und PUBLIC.
pull_requestsobjectNeinTä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.

ObjektDimensionsfelderDescription
totals_by_ide[]ideAufschlüsselung nach IDE. In Berichten pro Benutzer enthält jeder Eintrag auch last_known_ide_version und last_known_plugin_version.
totals_by_feature[]featureAufschlüsselung nach Copilot Feature (z. B. Inlinechat oder Chatpanel).
totals_by_language_feature[]
language, featureAufschlüsselung nach Sprache und Funktion. Enthält nicht user_initiated_interaction_count.
totals_by_language_model[]
language, modelAufschlüsselung nach Sprache und Modell für Chat-Aktivitäten (nicht Vervollständigungen).
totals_by_model_feature[]
model, featureAufschlü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.

FeldTypNullfähigDescription
last_known_ide_versionobjectJaNeueste 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_version.ide_versionstringNeinIDE-Versionszeichenfolge. Vorhanden, wenn last_known_ide_version vorhanden ist.
last_known_ide_version.sampled_atstringJaZeitstempel (ISO 8601), zu dem die Version erfasst wurde.
last_known_plugin_versionobjectJaDie 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_version.pluginstringNeinErweiterungsname (z. B copilot . oder copilot-chat). Vorhanden, wenn last_known_plugin_version vorhanden ist.
last_known_plugin_version.plugin_versionstringNeinVersionszeichenfolge der Erweiterung Vorhanden, wenn last_known_plugin_version vorhanden ist.
last_known_plugin_version.sampled_atstringJaZeitstempel (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.

FeldTypNullfähigDescription
totals_by_cli.session_countintegerNeinDie Anzahl der verschiedenen CLI-Sitzungen, die an diesem Tag initiiert wurden.
totals_by_cli.request_countintegerNeinGesamtzahl 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_countintegerNeinDie Gesamtzahl der Benutzereingabeaufforderungen, Befehle oder Abfragen, die innerhalb einer Sitzung ausgeführt werden.
totals_by_cli.token_usage.output_tokens_sumintegerNeinDie Gesamtzahl der Ausgabetoken, die an diesem Tag über alle CLI-Anforderungen generiert wurden.
totals_by_cli.token_usage.prompt_tokens_sumintegerNeinDie Gesamtzahl der Aufforderungstoken, die an diesem Tag über alle CLI-Anforderungen gesendet wurden.
totals_by_cli.token_usage.avg_tokens_per_requestnumberJaDurchschnittliche Anzahl der Ausgabe- und Prompt-Token pro CLI-Anforderung, berechnet als (output_tokens_sum + prompt_tokens_sum) ÷ request_count. Null, als an diesem Tag keine Anforderungen vorhanden waren.
totals_by_cli.last_known_cli_versionobjectNeinDie 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_known_cli_version.cli_versionstringNein
Copilot CLI Versionszeichenfolge. Standardmäßig wird unknown verwendet, wenn keine Version erkannt wurde.
totals_by_cli.last_known_cli_version.sampled_atstringJaZeitstempel (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.

FeldTypNullfähigDescription
pull_requests.total_createdintegerNeinDie 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_reviewedintegerNeinDie 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_mergedintegerNeinDie 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_minutes_to_mergenumberJaMedianzeit 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_suggestionsintegerNeinDie Gesamtzahl der Pull-Request-Bewertungsvorschläge, die an diesem bestimmten Tag generiert wurden, unabhängig vom Autor.
pull_requests.total_applied_suggestionsintegerNeinGesamtzahl der Vorschläge zur Pullanforderungsüberprüfung, die an diesem bestimmten Tag angewendet wurden, unabhängig vom Autor.
pull_requests.total_created_by_copilotintegerNeinDie Anzahl der Pullanforderungen, die Copilot-Cloud-Agent an diesem bestimmten Tag erstellt wurden.
pull_requests.total_reviewed_by_copilotintegerNeinAnzahl 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_merged_created_by_copilotintegerNeinDie 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_merged_reviewed_by_copilotintegerNeinAnzahl der Pull Requests, die sowohl zusammengeführt als auch von Copilot Codeüberprüfung während des Berichtszeitraums überprüft wurden.
pull_requests.median_minutes_to_merge_copilot_authorednumberJaMedianzeit 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_minutes_to_merge_copilot_reviewednumberJaMedianzeit, 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_copilot_suggestionsintegerNeinDie 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_copilot_applied_suggestionsintegerNeinAnzahl der von Copilot Codeüberprüfung generierten Review-Vorschläge für Pull-Anfragen, die an diesem bestimmten Tag angewendet wurden.
pull_requests.copilot_suggestions_by_comment_typearrayNeinAggregierte 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_suggestionsund total_copilot_applied_suggestions. 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:

PhaseOberflä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 zuerstAn mindestens zwei aktiven Tagen, an denen used_chat``true ist, code_acceptance_activity_count größer als 0 ist oder used_agent``true ist.
Phase 2: Agent an erster StelleMindestens zwei Aktive Tage, an denen eine einzelne GitHub-basierte Agentoberfläche verwendet wurde: used_cli ist true, used_copilot_cloud_agent ist trueoder used_copilot_code_review_active ist true. Passive Copilot Codeüberprüfung Aktivität (used_copilot_code_review_passive) zählt nicht zur Phasenklassifizierung.
Phase 3: Multi-AgentenMindestens 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:

FeldTypNullfähigDescription
ai_adoption_phase.phase_numberintegerNeinNumerischer Phasenbezeichner (zum Beispiel 0 für „Keine Kohorte“).
ai_adoption_phase.phasestringNeinMenschenlesbarer Phasenname.
ai_adoption_phase.versionstringNeinVersion des verwendeten Einführungsphasenmodells (z. B. v1).

Jeder Eintrag im aggregierten totals_by_ai_adoption_phase Array enthält:

FeldTypNullfähigDescription
phasestringNeinMenschenlesbarer Phasenname.
phase_numberintegerNeinNumerischer Phasenbezeichner.
total_engaged_usersintegerNeinAnzahl der Nutzer, die in diesem Zeitraum dieser Phase zugeordnet wurden.
avg_user_initiated_interactionsnumberNeinDurchschnittliche benutzerinitiierte Interaktionen pro Benutzer in dieser Phase.
avg_code_generation_activitiesnumberNeinDurchschnittliche Codegenerierungsaktivitäten pro Benutzer in dieser Phase.
avg_code_acceptance_activitiesnumberNeinDurchschnittliche Codeakzeptanzaktivitäten pro Benutzer in dieser Phase.
avg_loc_addednumberNeinDurchschnittliche Codezeilen, die pro Benutzer in dieser Phase hinzugefügt wurden.
avg_loc_deletednumberNeinDurchschnittliche Codezeilen, die pro Benutzer in dieser Phase gelöscht wurden.
avg_pull_requests_reviewednumberNeinDurchschnittliche Pullanforderungen, die pro Benutzer in dieser Phase überprüft wurden.
avg_pull_requests_creatednumberNeinDurchschnittliche Pullanforderungen, die pro Benutzer in dieser Phase erstellt wurden.
avg_pull_requests_mergednumberNeinDurchschnittliche Pullanforderungen, die pro Benutzer in dieser Phase zusammengeführt werden.
total_pull_requests_mergedintegerNeinGesamtzahl 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_median_minutes_to_mergenumberNeinDurchschnitt 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:

WertDescription
code_completionInline-Codevervollständigungen.
chat_inlineInlinechat im Editor.
chat_panel_ask_modeChatpanelinteraktionen mit ausgewähltem Ask-Modus.
chat_panel_edit_modeChatpanelinteraktionen mit ausgewähltem Bearbeitungsmodus.
chat_panel_agent_modeChatpanelinteraktionen mit ausgewähltem Agentmodus.
chat_panel_plan_modeInteraktionen im Chat-Panel bei ausgewähltem Planmodus.
chat_panel_custom_modeChatpanelinteraktionen mit einem ausgewählten benutzerdefinierten Agent.
chat_panel_unknown_modeChatpanelinteraktionen, bei denen der Modus unbekannt ist.
agent_editZeilen, 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_interaction_count.
copilot_cliAktivität zugeschrieben an Copilot CLI.
othersAlle 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.