Hinweis
GitHub Copilot Nutzungsstatistiken befinden sich derzeit in Öffentliche Vorschau mit Datenschutz und unterliegen Änderungen.
Das Nutzungsmetriken-Dashboard, die APIs und Exportdateien für Copilot verwenden alle dieselben zugrunde liegenden Telemetriedaten, aber sie aggregieren und präsentieren sie unterschiedlich. Wenn Sie diese Unterschiede verstehen, können Sie Zahlen über Quellen hinweg abgleichen und Ihre Analyse beim Vorbereiten interner Berichte als vertrauenswürdig einstufen.
- Das Copilot-Nutzungsmetriken-Dashboard berichtet Daten auf der **Unternehmensebene **.
- Die Copilot APIs für Nutzungsmetriken unterstützen Datensätze auf Unternehmens-, Organisations- und Benutzerebene.
Voraussetzung
Copilot Nutzungsmetriken sind von Telemetriedaten der Benutzer-IdEs abhängig. Wenn ein Entwickler die Telemetrie in seiner IDE deaktiviert hat, werden ihre Copilot Aktivität nicht im Dashboard, API-Berichten oder exportierten Daten angezeigt.
Wenn Sie feststellen, dass Benutzer fehlen oder unerwartet niedrige Einführungsnummern auftreten, überprüfen Sie die IDE-Telemetrieeinstellungen, bevor Sie andere Ursachen beheben.
Metrikausrichtung
Das Dashboard und die APIs verwenden freigegebene Definitionen für wichtige Metriken:
| Begriff | Dashboardmetrik | API- oder Exportfeld | Hinweise |
|---|---|---|---|
| Aktive Benutzer | Tägliche/wöchentliche/gesamt aktive Benutzer | user_initiated_interaction_count > 0 | Ein Benutzer wird als aktiv betrachtet, wenn er an diesem Tag mit Copilot in seiner IDE interagiert hat. |
| Akzeptanzrate | Akzeptanzrate der Code-Vervollständigung |
`code_acceptance_activity_count` ÷ `code_generation_activity_count` | Beide Quellen berechnen die Akzeptanzrate auf die gleiche Weise, obwohl die Rundung unterschiedlich sein kann. |
| Agenteneinführung | Agentakzeptanzdiagramm |
totals_by_feature wo Merkmal = "Agent" | Spiegelt Benutzer wider, die mit dem Copilot-Agent interagiert haben. |
| Sprachverwendung | Sprachverwendungsdiagramme |
totals_by_language_feature oder totals_by_language_model | Das Dashboard visualisiert diese aggregierten Felder. |
Vollständige Feldbeschreibungen finden Sie unter GitHub Copilot-Nutzungsmetriken.
Diskrepanzen zwischen Berichten
Es werden kleine Unterschiede zwischen Dashboarddaten, API-Berichten und Exporten erwartet. Diese Abweichungen werden in der Regel durch Unterschiede in Zeitfenstern, Umfang oder Datenfrischung verursacht.
Zeitfenster
Jede Datenquelle aggregiert Daten unterschiedlich.
| Quelle | Zeitfenster | Aggregationsmethode |
|---|---|---|
| Dashboard | 28-tägiges Rollfenster | Metriken werden in den letzten 28 Tagen kontinuierlich aggregiert, um reibungslose Schwankungen zu erhalten. |
| APIs | Täglich | Jeder Datensatz stellt einen einzelnen Tag pro Benutzer dar und ermöglicht die tägliche Trendanalyse. |
| NDJSON-Exporte | Täglich | Spiegelt die API-Ausgabe für BI-Tools und langfristige Berichte. |
Durch ausrichten des Berichtszeitraums mit dem 28-Tage-Fenster des Dashboards wird ein konsistenter Vergleich sichergestellt.
Verzögerte Telemetrie
Da die IDE-Telemetrie asynchron verarbeitet wird, werden Daten für die letzten Tage möglicherweise unvollständig oder fehlen. Daten werden in der Regel innerhalb von drei vollständigen UTC-Tagen abgeschlossen. Scheinbare Rückgänge in den jüngsten täglichen Metriken werden oft korrigiert, sobald die Telemetrie vollständig verarbeitet ist.
Exportzeitpunkt
NDJSON-Dateien spiegeln daten wider, die zum Zeitpunkt des Exports verfügbar sind. Wenn eine Datei heruntergeladen wird, bevor neue Telemetrie verarbeitet wird, liegen die Daten möglicherweise hinter dem Dashboard oder der API. Durch das erneute Exportieren der Datei nach dem dreitägigen Fenster wird die genaueste Ansicht bereitgestellt.
`Unknown` Werte
Der Wert Unknown erscheint in einigen API- oder Exportaufschlüsselungen, wenn von der Telemetrie des IDE-Clients nicht genügend Details vorhanden sind, um die Aktivität zu kategorisieren. Dies ist ein erwartetes Verhalten und gibt keine fehlenden Daten an.
| Aufschlüsselung | Explanation |
|---|---|
| Language | Wird angezeigt, als Unknown wenn die IDE die Programmiersprache der aktiven Datei nicht identifizieren kann. |
| Merkmal | Wird angezeigt, wenn ein älterer Client ein generisches Ereignis sendet, ohne einen Chatmodus anzugeben (z. B chat_panel_unknown_mode. ). |
| Model | Wird angezeigt, wenn das Ereignis keine Informationen zur Identifizierung des verwendeten Modells enthält. Einige interne Modelle (z. B. gpt-4o-mini) können Unknown zusammen angezeigt werden, wenn sie für nicht benutzerbezogene Vorgänge verwendet werden, z. B. für Zusammenfassungen oder die Absichtserkennung. |
`Unknown` Werte werden aus Dashboardvisualisierungen ausgeschlossen, werden jedoch in API- und NDJSON-Daten zur Vollständigkeit angezeigt. Die Datenmenge `Unknown` verringert sich, wenn Benutzer ein Upgrade auf neuere IDE- und Erweiterungsversionen durchführen, die eine umfangreichere Telemetrie senden.