Informationen zu Copilot-Nutzungsmetriken
Copilot-Nutzungsmetriken helfen wichtigen Stakeholdern und Entscheidungsträgern zu verstehen, wie ihre Teams Copilot akzeptieren und nutzen. Durch das Nachverfolgen von Nutzungsmustern im gesamten Unternehmen können Sie das Engagement messen, Möglichkeiten zum Steigern des Werts identifizieren und bewerten, wie KI-unterstützte Workflows den Pullanforderungsdurchsatz und die Zeit beeinflussen, um zusammenzuführen.
Metriken sind verfügbar durch:
- Die Copilot Usage Metrics APIs, die detaillierte, exportierbare Daten auf Unternehmens-, Organisations- und Benutzerebene bereitstellen.
- Das Dashboard für Copilot-Nutzungsmetriken, das die Nutzungstrends über 28 Tage in Ihrem Unternehmen und Ihren Organisationen visualisiert.
- Das Dashboard zur Codegenerierung, das aufschlüsselt, wie Code durch Benutzer und Agenten innerhalb Ihres Unternehmens und Ihrer Organisationen generiert wird.
- Der Copilot-Nutzungsmetriken-NDJSON-Export, der Rohdaten für benutzerdefinierte BI-Tools oder die langfristige Speicherung bietet.
Welche Verwendung ist enthalten?
Copilot Nutzungsmetriken werden aus Telemetrie über mehrere Copilot Oberflächen abgeleitet, einschließlich IDE und Copilot CLI Aktivität. Da viele Metriken aus der IDE-Telemetrie stammen, müssen Endbenutzer Telemetrie in ihrer IDE aktiviert haben, damit sie in diese Metriken einbezogen werden können.
Die Daten enthalten keine Aktivitäten aus anderen Copilot Oberflächen, z. B.:
- Copilot-Chat auf GitHub.com
- GitHub Mobile
Lizenz- und Sitzplatzverwaltungsdaten sind nicht in Copilot-Nutzungsmetrik-Berichten enthalten. Um Lizenzzuweisungen anzuzeigen oder zu verwalten, verwenden Sie die Copilot-Benutzerverwaltungs-API, die die Quelle der Wahrheit für Lizenz- und Arbeitsplatzinformationen ist. Weitere Informationen findest du unter REST-API-Endpunkte für Copilot Benutzerverwaltung.
Warum die Nutzungsmetriken von Copilot zwischen verschiedenen API-Ressourcen variieren können
Die folgenden API-Ressourcen stellen Copilot-bezogene Daten bereit, sind jedoch nicht austauschbar und sollten nicht direkt verglichen werden. Jede API-Ressource ist für einen bestimmten Anwendungsfall und Datenmodell konzipiert, und es werden Unterschiede bei Summen oder Abdeckungen erwartet. Verwenden Sie diese Tabelle, um zu verstehen, welche API-Ressource Ihren Berichtsanforderungen am besten entspricht.
Hinweis
Es wird dringend empfohlen, die Copilot-Nutzungsmetriken-API für neue Integrationen und Analysen zu verwenden, da sie die umfassendste und zukunftsgerichtete Perspektive der Nutzung von Copilot bietet.
| API-Ressource | Geltungsbereich | Wichtige Funktionen |
|---|
[AUTOTITLE](/rest/copilot/copilot-usage-metrics) | Erweiterte Ereignistelemetrie auf Unternehmens-, Organisations- und Benutzerebene | Bietet einheitliche Telemetrie über Abschluss-, Chat- und Agentmodi hinweg. Enthält Nutzungs- und Codezeilenmetriken in allen IDE-Modi, Sprachen und Modellen. Unterstützt detaillierte Aufschlüsselungen nach Feature, IDE, Sprache, Modell und Benutzer und ist die primäre API-Ressource, die aktiv entwickelt und verwaltet wird. |
|
REST-API-Endpunkte für Copilot Benutzerverwaltung | Lizenz- und Sitzzuweisung | Listet zugewiesene Copilot Arbeitsplätze für eine Organisation oder ein Unternehmen, einschließlich Lizenzstatus, Benutzerzuordnung und last_activity_at. Diese API-Ressource ist die Quelle der Wahrheit für Lizenz- und Sitzinformationen. |
|
REST-API-Endpunkte für Copilot Metriken | Die Metriken auf Unternehmens-, Organisations- und Teamebene | Stellt aggregierte Nutzungsdaten für Copilot Funktionen auf GitHub.com bereit (z. B. Zusammenfassungen von Pull-Anforderungen) sowie einige IDE-basierte Auto-Vervollständigungen und Chat-Funktionen. Enthält keine Agent- oder Bearbeitungsmodus-Telemetrie. Bietet unternehmensweite und funktionsbezogene Aufschlüsselungen nach IDE und Sprache. Enthält keine Daten auf einzelner Ebene. |
Wie werden Metriken organisationsübergreifend zugeordnet?
Hinweis
Sie können organisationsspezifische Einblicke in Copilot Nutzungsmetriken gewähren, ohne zugriff auf Unternehmensebene bereitzustellen.
Sie können dies tun, indem Sie eine benutzerdefinierte Organisationsrolle erstellen, die die Berechtigung "Organisation Copilot Metriken anzeigen" enthält, und benutzern, die Einblicke in Metriken für eine einzelne Organisation benötigen, diese Rolle zuweisen. Weitere Informationen findest du unter Berechtigungen von benutzerdefinierten Organisationsrollen.
Nutzungsmetriken auf Organisationsebene von Copilot basieren auf der Organisationsmitgliedschaft und nicht darauf, wo einzelne Aktionen stattfinden. Um in den Metriken eines Unternehmens angezeigt zu werden, muss ein Benutzer über einen aktiven Copilot Arbeitsplatz innerhalb dieses Unternehmens verfügen (in jeder Organisation, die zum Unternehmen gehört). Daher kann die Nutzung eines einzelnen Benutzers in mehreren Organisationsdashboards angezeigt werden, während derselbe Benutzer nur einmal in der Gesamtsumme auf Unternehmensebene gezählt wird. Analysen auf Organisationsebene sind für die Sichtbarkeit der Einführung und Nutzung innerhalb einer Organisation vorgesehen und sind nicht für den direkten Vergleich zu Gesamtergebnissen auf Unternehmensebene konzipiert.
Copilot-Analysen auf Organisationsebene sind ab dem 12. Dezember 2025 verfügbar. Dies ist das erste Datum, an dem Berichte auf Organisationsebene bereitgestellt werden.
Sobald ein Benutzer über einen Sitz im Unternehmen verfügt, wird seine Nutzung jeder Organisation zugeordnet, der sie angehören, unabhängig davon, wo der Arbeitsplatz zugewiesen ist.
Dies bedeutet:
- Wenn Lizenzen in einer dedizierten "Shell"-Organisation für administrative Zwecke innerhalb des Unternehmens zugewiesen werden, werden die Benutzer weiterhin in den Metriken für alle anderen Organisationen im Unternehmen angezeigt, denen sie angehören.
- Wenn ein Benutzer auch einen Copilot Arbeitsplatz in einer separaten Organisation außerhalb des Unternehmens hat, ist seine Aktivität weiterhin in den Metriken auf Organisationsebene des Unternehmens enthalten, solange sie mindestens einen Arbeitsplatz innerhalb des Unternehmens haben.
Kurz gesagt: Benutzer müssen irgendwo im Unternehmen lizenziert sein, damit sie in ihren Metriken angezeigt werden. Sobald sie aktiviert sind, geben Metriken an, wo sie arbeiten (ihre Mitgliedschaft in der Organisation), nicht welche Organisation den Copilot Sitz bietet oder woher die Aktivität stammt.
Unterstützte IDEs
Um in die Copilot Nutzungsmetriken aufgenommen zu werden, müssen Endbenutzer eine der folgenden IDEs und Copilot-Chat Erweiterungsversionen verwenden.
| IDE | Mindest-IDE-Version | Minimale Copilot-Chat Erweiterungsversion |
|---|---|---|
| Finsternis | 4.31 | 0.9.3.202507240902 |
| JetBrains / IntelliJ | 2024.2.6 | 1.5.52-241 |
| Visual Studio | 17.14.13 | 18.0.471.29466 |
| VS Code | 1.101 | 0.28.0 |
| Xcode | 13.2.1 | 0.40.0 |
Datenaktualität
Die Daten im Copilot-Dashboard für Nutzungsmetriken und in den API-Berichten werden in regelmäßigen Abständen aktualisiert.
Sie können davon ausgehen, dass Daten innerhalb von zwei vollständigen Tagen verfügbar sind. Dies bedeutet, dass Daten für einen bestimmten Tag verarbeitet und innerhalb von zwei vollständigen UTC-Tagen nach Abschluss dieses Tages zur Verfügung gestellt werden.
Was misst die Daten?
Copilot-Nutzungsmetriken können in einige wenige Hauptkategorien unterteilt werden: Einführung, Interaktionen, Akzeptanzrate, Codezeilen (LoC) und Metriken für den Pullanforderungslebenszyklus.
**Adoption** misst, wie viele lizenzierte Entwickler Copilot aktiv verwenden. Die täglich aktiven Benutzer (DAU) sagen Ihnen zum Beispiel, wie viele einzelne Benutzer an einem bestimmten Tag mit Copilot interagiert haben. Im Idealfall sehen Sie während des Rollouts einen konsistenten Aufwärtstrend in diesen Metriken.
**Engagement-Metriken** beschreiben, wie intensiv Entwickler Copilot verwenden, nachdem sie es übernommen haben. Wichtige Engagementmetriken zeigen nicht nur die Häufigkeit der Verwendung, sondern auch die Breite der Funktionen. Die durchschnittlichen Chatanfragen pro aktivem Benutzer messen beispielsweise, wie oft Benutzer Copilot-Chat öffnen und mit ihnen interagieren. Optimalerweise wird der Chat regelmäßig und zunehmend in allen Sprachen und IDEs verwendet.
**Akzeptanzrate** misst, wie oft Entwickler die Vorschläge von Copilot akzeptieren. Dies hilft Ihnen zu verstehen, ob Vorschläge relevant und vertrauenswürdig sind. Beispielsweise deutet eine hohe Akzeptanzrate von Inline-Vorschlägen darauf hin, dass die Vorschläge relevant und nützlich sind.
**Codezeilen (LoC)-Metriken** messen die Anzahl der Zeilen, die Copilot im Editor vorschlägt, hinzufügt oder löscht und bieten eine Überblick über die greifbare Ausgabe von Copilot. Beispielsweise zeigt "Hinzugefügte Zeilen" an, wie viel Code tatsächlich akzeptiert und in den Editor eingefügt wurde.
**Metriken zum Lebenszyklus von Pull-Anfragen** messen, wie sich die Aktivität von Copilot auf die Ergebnisse von Pull-Anfragen und den Übermittlungsfluss auswirkt. Dazu gehören Metriken zur Erstellung von Pullanforderungen, zur Zahl der Zusammenführungen, zur Medianzeit bis zur Zusammenführung und zu Vorschlägen für Überprüfungen. Wenn Sie die gesamte Pullanforderungsaktivität mit Pullanforderungen vergleichen, die von Copilot erstellt wurden, können Sie auswerten, wie KI-unterstützte Workflows den Durchsatz und die Zykluszeit auf Organisationsebene oder auf Unternehmensebene beeinflussen.
Interpretieren von Metriken des Pullanforderungslebenszyklus über Bereiche hinweg
Pull-Anforderungslebenszyklusmetriken sind sowohl auf Organisationsebene als auch auf Unternehmensebene verfügbar. Beachten Sie beim Vergleichen von Berichten Folgendes:
-
**Deduplizierung**: Berichte auf Unternehmensebene entfernen duplizierte Benutzer organisationenübergreifend. Berichte auf Organisationsebene gibt es nicht. -
**Nur Pull Request-Daten: Pull Request-Lebenszyklusmetriken** können auch dann angezeigt werden, wenn IDE-Nutzungsmetriken nicht vorhanden sind, da Pull Request-Daten von Repository-Aktivitäten abgeleitet werden. -
**Zuordnungszeitpunkt**: Wenn ein Repository oder eine Organisation zwischen Besitzern übertragen wird, können Ereignisse zur Erstellung, Überprüfung und Zusammenführung von Pull-Anforderungen verschiedenen Entitäten zugeordnet werden, je nachdem, wann jedes Ereignis aufgetreten ist.
Wie kann ich diese Metriken verwenden?
Diese Metriken können genutzt werden, um zusammen wichtige Fragen zur Nutzung von Copilot durch Ihre Teams zu beantworten.
| Frage | Verwenden Sie diese Metriken. |
|---|---|
| Verwenden meine Teams Copilot regelmäßig? | Tägliche und wöchentlich aktive Benutzer |
| Welche Features bieten den größten Nutzen? | Anforderungen pro Chatmodus, Agentakzeptanz |
| Vertrauen die Entwickler den Ausgaben von Copilot? | Akzeptanzrate-Trends |
| Funktionieren Die Aktivierungsbemühungen? | Wachstum der Akzeptanz und des Engagements nach Schulungen oder Kommunikationskampagnen |
| Beeinflusst Copilot die Liefergeschwindigkeit oder den Durchsatz von Pull-Anfragen? | Anzahl der Pull-Request-Zusammenführungen und Medianzeit bis zur Zusammenführung |
Suchen Sie bei diesen Signalen nach Mustern, anstatt sich auf eine einzelne Zahl zu konzentrieren. Ein stetiger DAU-Wert, der mit einer steigenden Akzeptanzrate gekoppelt ist, zeigt z. B. wachsendes Vertrauen und Wert an.
Nächste Schritte
Nachdem Sie nun verstehen, was die einzelnen Copilot Metriken messen und wie sie verwendet werden, können Sie die Dashboards erkunden, um diese Metriken in Aktion zu sehen.
- Informationen zum Anzeigen von Einführungs- und Nutzungstrends innerhalb Ihres Unternehmens und Ihrer Organisationen finden Sie unter Anzeigen des Dashboards für Copilot-Nutzungsmetriken.
- Informationen zum Analysieren, wie Code von Benutzern und Agents generiert wird, finden Sie unter Anzeigen des Dashboards zur Codegenerierung.
- Informationen zum programmgesteuerten Zugriff auf Copilot Nutzungsmetriken finden Sie unter REST-API-Endpunkte für Copilot Nutzungsmetriken.