Telemetrie

Visual Studio Code sammelt Telemetriedaten, die verwendet werden, um zu verstehen, wie das Produkt verbessert werden kann. Diese Nutzungsdaten helfen beispielsweise bei der Fehlersuche, wie z. B. langsame Startzeiten, und bei der Priorisierung neuer Funktionen. Wir verwenden diese Daten auch, um neue Funktionen einer Teilmenge von Benutzern zur Verfügung zu stellen, bevor sie allgemein verfügbar sind.

Wir schätzen die Erkenntnisse, die diese Daten liefern, wissen aber auch, dass nicht jeder Nutzungsdaten senden möchte, und Sie können Telemetrie deaktivieren, wie in Telemetrieberichterstattung deaktivieren beschrieben. Sie können auch unsere Datenschutzerklärung lesen, um mehr zu erfahren.

Arten von Telemetriedaten

VS Code und diese Seite beziehen sich auf drei verschiedene Arten von Daten im Hinblick auf Telemetrie.

Absturzberichte – Absturzberichte sammeln Diagnoseinformationen, wenn VS Code abstürzt, und senden diese an Microsoft, um zu verstehen, warum der Absturz aufgetreten ist und welche Änderungen erforderlich sind, um den Absturz in Zukunft zu verhindern.

Fehlertelemetrie – Fehlertelemetrie sammelt Informationen über Fehler, die die Anwendung nicht zum Absturz bringen, aber unerwartet sind.

Nutzungsdaten – Nutzungsdaten sammeln Informationen darüber, wie Funktionen in VS Code verwendet und ausgeführt werden, was uns hilft, zukünftige Produktverbesserungen zu priorisieren.

Telemetrieberichterstattung deaktivieren

Mit der Benutzereinstellung telemetry.telemetryLevel können Sie die verschiedenen Arten von Telemetrie, die wir senden, mit einer einzigen Einstellung steuern. Hier ist eine Tabelle der verschiedenen Datentypen, die mit jedem Wert von telemetry.telemetryLevel gesendet werden

Wenn Sie beispielsweise keine Telemetriedaten an Microsoft senden möchten, können Sie die Benutzereinstellung telemetry.telemetryLevel auf off setzen. Dadurch werden alle Telemetrieereignisse von VS Code stummgeschaltet. Beachten Sie, dass bis zu dem Zeitpunkt, an dem Sie die Einstellung deaktivieren, möglicherweise Telemetrieinformationen gesammelt und gesendet wurden.

Wenn Sie den JSON-Editor für Ihre Einstellungen verwenden, fügen Sie die folgende Zeile hinzu

"telemetry.telemetryLevel": "off"

Funktionsverfügbarkeit und Telemetrie

VS Code verwendet ein A/B-Experimentiersystem, um neue Funktionen einer Teilmenge von Benutzern zur Verfügung zu stellen, bevor sie allgemein verfügbar sind. Dies hilft uns zu überprüfen, ob eine neue Funktion bei einer Vielzahl von Benutzern wie erwartet funktioniert, bevor sie für alle freigegeben wird. Durch die Teilnahme an der Experimentierung helfen Sie uns, die Qualität von VS Code zu verbessern und die Zukunft des Produkts durch frühes Feedback mitzugestalten.

Um dieses Experimentiersystem zu aktivieren, verwendet VS Code die Nutzungs-Telemetriedaten, um zu bestimmen, welche Benutzer die neue Funktion erhalten sollen, und um zu überprüfen, wie die Funktion verwendet wird. Wenn Sie die Telemetrie von Nutzungsdaten deaktivieren, indem Sie telemetry.telemetryLevel auf error, crash oder off setzen, können wir die Nutzung der Funktion nicht bewerten, und daher ist die Experimentierung für Sie deaktiviert. Infolgedessen kann die Einführung neuer Funktionen für Sie verzögert werden, bis die Funktion allgemein verfügbar ist.

Erweiterungen und Telemetrie

VS Code ermöglicht es Ihnen, dem Produkt Funktionen durch die Installation von Microsoft- und Drittanbietererweiterungen hinzuzufügen. Diese Erweiterungen sammeln möglicherweise ihre eigenen Nutzungsdaten und werden nicht von der Einstellung telemetry.telemetryLevel gesteuert. Konsultieren Sie die Dokumentation der jeweiligen Erweiterung, um mehr über deren Telemetrieberichterstattung zu erfahren und ob sie deaktiviert werden kann.

Erweiterungsautoren können im Abschnitt "Für Erweiterungsautoren" Anleitungen zur Implementierung von Telemetrie-Best Practices innerhalb ihrer Erweiterung finden.

Ausgabekanal für Telemetrieereignisse

Um die Telemetrieereignisse in VS Code zu überprüfen, während sie gesendet werden, führen Sie den Befehl Developer: Show Telemetry aus der Befehlspalette () aus. Dieser Befehl aktiviert die Nachverfolgung für Telemetrieereignisse und öffnet den Telemetry-Ausgabekanal im Ausgabebereich (⇧⌘U (Windows Ctrl+Shift+U, Linux Ctrl+K Ctrl+H)). Während Telemetrieereignisse gesendet werden, zeigt der Ausgabekanal die Ereignisdetails an.

Wenn Telemetrieereignisse nachverfolgt werden, werden die Ereignisse auch in eine lokale Datei telemetry.log protokolliert, die Sie mit dem Befehl Developer: Open Log... und der Auswahl von Telemetry aus der Dropdownliste anzeigen können.

Um die Nachverfolgung von Telemetrieereignissen zu deaktivieren, laden Sie das VS Code-Fenster neu (Befehl Developer: Reload Window).

Alle Telemetrieereignisse anzeigen

Wenn Sie alle möglichen Telemetrieereignisse anzeigen möchten, die VS Code senden könnte, können Sie das Flag --telemetry in der CLI verwenden. Dies generiert einen JSON-Bericht, den Sie dann innerhalb von VS Code anzeigen können. Diese Berichte werden pro Build generiert und enthalten keine Erweiterungs-Telemetrie, es sei denn, der Erweiterungsautor fügt eine Datei telemetry.json zu seinem Stammbuild-Verzeichnis hinzu.

Zum Beispiel wird durch Ausführen von code --telemetry > telemetry.json && code telemetry.json eine Datei telemetry.json in Ihrem aktuellen Arbeitsverzeichnis erstellt und dann in VS Code geöffnet. Sie können die Ausgabe nicht auf diese Weise weiterleiten, code --telemetry | code -, aufgrund der Länge des Telemetrieberichts.

Die folgenden Abschnitte beschreiben die Metadaten des Ereignisses, die zur Klassifizierung der Telemetrie verwendet werden, ihren Zweck und besondere Handhabungen.

Ereignisklassifizierung

Das Feld classification beschreibt die Art der Daten.

• SystemMetaData – Von VS Code generierte Werte, die nicht persönlich identifizierbar sind.
• CallstackOrException – Durch Programmfehler verursachte Fehler. Diese enthalten Stapelverfolgungen, bei denen Benutzerpfade bereinigt wurden.
• PublicNonPersonalData – Vom Benutzer generierte Daten, die öffentlich zugänglich sind, z. B. veröffentlichte Erweiterungs-IDs.
• EndUserPseudonymizedInformation – Hashes, die verwendet werden, um einen einzelnen Benutzer zu identifizieren, ohne ihn identifizieren zu können. Zum Beispiel eine gehashte MAC-Adresse.

Zweck des Ereignisses

Das Feld purpose beschreibt, warum die Daten gesammelt werden.

• PerformanceAndHealth – Um sicherzustellen, dass die Produkte und Dienste von VS Code gesund und schnell sind.
• FeatureInsight – Um die Funktionsnutzung zu verstehen und wo die Entwicklungsinvestitionen fortgesetzt werden sollen.
• BusinessInsight – Um Entscheidungen im Zusammenhang mit dem Geschäft von VS Code, Microsoft und GitHub zu treffen.

Ereignisendpunkt

Das Feld endpoint beschreibt, an welchen Datenhandler die Daten gesendet werden. Dies wird normalerweise auf spezielle Daten angewendet, die zusätzliche Bereinigung und Sicherheit erfordern, um die Privatsphäre der Benutzer zu schützen.

• GoogleAnalyticsId – Wird auf unserer Website für Google Analytics und die Verfolgung von Seitenaufrufen verwendet. Diese werden sensibler behandelt als unsere normalen Daten.
• MacAddressHash – Wird verwendet, um einen Benutzer von VS Code zu identifizieren. Dies wird einmal auf der Clientseite gehasht und dann erneut auf der Pipeline-Seite, um die Identifizierung eines bestimmten Benutzers unmöglich zu machen. Auf VS Code für das Web wird in diesem Fall eine UUID generiert.
• none – Daten erfordern keine besondere Behandlung.

DSGVO und VS Code

Zusätzlich zur Unterstützung der Datenschutz-Grundverordnung (DSGVO) nimmt das VS Code-Team den Schutz der Privatsphäre sehr ernst. Dies gilt sowohl für Microsoft als Unternehmen als auch speziell für das VS Code-Team.

Um die Einhaltung der DSGVO zu gewährleisten, haben wir mehrere Updates an VS Code vorgenommen, darunter:

• Erleichterung der Abmeldung von der Telemetriesammlung durch Platzierung einer Benachrichtigung im Produkt für alle bestehenden und neuen Benutzer.
• Überprüfung und Klassifizierung der von uns gesendeten Telemetrie (dokumentiert in unserem OSS-Code).
• Sicherstellung, dass wir über gültige Datenspeicherungsrichtlinien für alle von uns gesammelten Daten verfügen, z. B. Absturzabbilder.

Kurz gesagt, wir haben hart daran gearbeitet, das Richtige für alle Benutzer zu tun, da diese Praktiken für alle Geografien gelten, nicht nur für Europa.

Eine Frage, die wir erwarten, ist, die gesammelten Daten sehen zu können. Wir haben jedoch keine zuverlässige Möglichkeit dazu, da VS Code keine "Anmeldefunktion" hat, die einen Benutzer eindeutig identifizieren würde. Wir senden zwar Informationen, die uns helfen, einen einzelnen Benutzer zu diagnostischen Zwecken zu approximieren (basierend auf einem Hash der Netzwerkkarten-NIC auf dem Desktop und einer zufällig zugewiesenen UUID im Web), aber dies ist nicht garantiert eindeutig. Virtuelle Maschinen (VMs) wechseln beispielsweise häufig die NIC-IDs oder weisen aus einem Pool zu. Diese Technik reicht aus, um uns bei der Lösung von Problemen zu helfen, ist aber nicht zuverlässig genug, um "Ihre Daten bereitzustellen".

Wir erwarten, dass sich unser Ansatz weiterentwickelt, wenn wir mehr über die DSGVO und die Erwartungen unserer Benutzer erfahren. Wir schätzen die Daten, die uns Benutzer senden, sehr, da sie sehr wertvoll sind und VS Code dadurch ein besseres Produkt für alle ist. Und nochmals, wenn Sie sich Sorgen um den Datenschutz machen, bieten wir die Möglichkeit, das Senden von Telemetrie zu deaktivieren, wie in Telemetrieberichterstattung deaktivieren beschrieben.

Weitere Informationen darüber, wie die Visual Studio-Familie mit der DSGVO umgeht, finden Sie unter Data Subject Requests für die DSGVO für die Visual Studio Family.

Online-Dienste verwalten

Neben Absturzberichten und Telemetrie verwendet VS Code Online-Dienste für verschiedene andere Zwecke, wie z. B. das Herunterladen von Produktupdates, das Finden, Installieren und Aktualisieren von Erweiterungen, Einstellungen synchronisieren oder die Bereitstellung von natürlicher Sprachsuche im Einstellungen-Editor. Sie können Funktionen, die diese Dienste nutzen, ein- oder ausschalten.

Bitte beachten Sie, dass das Ausschalten dieser Funktionen VS Code nicht in den Offline-Modus versetzt. Wenn Sie beispielsweise im Erweiterungen-Tab nach Erweiterungen suchen, durchsucht VS Code immer noch den Online-VS Code-Marktplatz. Die Einstellungen stellen sicher, dass VS Code nicht ohne Ihre Aufforderung mit Online-Diensten kommuniziert.

Von Datei > Einstellungen > Einstellungen, und geben Sie den Tag @tag:usesOnlineServices ein. Dies zeigt alle Einstellungen an, die die Nutzung von Online-Diensten steuern, und Sie können sie einzeln ein- oder ausschalten.

Hinweis: VS Code-Erweiterungen können auch Online-Dienste nutzen und bieten möglicherweise keine Einstellungen zur Konfiguration der Nutzung dieser Online-Dienste an oder registrieren ihre Einstellungen möglicherweise nicht, um bei der Suche nach @tag:usesOnlineServices angezeigt zu werden. Konsultieren Sie die Dokumentation der jeweiligen Erweiterung, um Informationen über deren Nutzung von Online-Diensten zu erhalten.

Von VS Code verwendete Nicht-Microsoft-Online-Dienste

Die integrierte Erweiterung npm-Unterstützung für VS Code sendet Anfragen an https://registry.npmjs.org und https://registry.bower.io.

Die integrierte Erweiterung TypeScript- und JavaScript-Sprachfunktionen fragt die Domäne @types unter https://registry.npmjs.org ab.

Wenn Sie Developer: Toggle Developer Tools oder Developer: Open Webview Developer Tools verwenden, kann VS Code mit Google-Servern kommunizieren, um Daten abzurufen, die zum Starten der Entwicklertools benötigt werden.

Erweiterungsempfehlungen

VS Code bietet Erweiterungsempfehlungen basierend auf Ihren Dateitypen, Ihrem Arbeitsbereich und Ihrer Umgebung. Dateityp-Empfehlungen sind entweder vorkompiliert oder dynamisch. Arbeitsbereichs- und Umgebungsempfehlungen sind immer vorkompiliert.

Wenn Sie wissen möchten, warum eine Erweiterung empfohlen wird, öffnen Sie die Detailseite der Erweiterung. Den Grund für die Empfehlung finden Sie in der Kopfzeile der Seite.

Vorkompilierte Empfehlungen

VS Code sammelt Telemetrie darüber, welche Erweiterungen für welche Dateitypen und welche Arbeitsbereiche/Ordner aktiviert werden. Bestimmte Ordner werden identifiziert, indem ein Hash jedes Git-Remotes des Ordners berechnet wird.

Wir verwenden diese Informationen, um anonyme Empfehlungen vorab zu berechnen. Vorkompilierte Empfehlungen sind Anweisungen, die festlegen, unter welchen Bedingungen eine Erweiterung empfohlen werden sollte. Wenn wir beispielsweise eine interessante Korrelation zwischen zwei Erweiterungen A und B sehen, könnte eine Anweisung lauten: Empfehlen Sie Erweiterung B, wenn der Benutzer Erweiterung A, aber nicht B installiert hat.

Einige vorkompilierte Empfehlungen werden als Teil des Produkts ausgeliefert, während zusätzliche vorkompilierte Empfehlungen zur Laufzeit von einem Online-Microsoft-Dienst abgerufen werden. VS Code wertet vorkompilierte Empfehlungen unabhängig aus und führt sie aus, ohne Benutzerinformationen an einen Online-Dienst zu senden.

Dynamische Empfehlungen

Wenn Sie einen Dateityp öffnen, für den VS Code keine vorkompilierte Empfehlung hat, fragt es den Erweiterungsmarktplatz nach Erweiterungen ab, die deklarieren, dass sie diesen Dateityp unterstützen. Wenn die Abfrage Erweiterungen zurückgibt, die Sie nicht installiert haben, wird VS Code eine Benachrichtigung anzeigen.

Für Erweiterungsautoren

Bitte lesen Sie das Dokument zur Telemetrie für Erweiterungsleitfäden.

Verwandte Ressourcen

• Verwalten Sie die Telemetrieprotokollebene zentral – Erfahren Sie, wie Sie die Telemetrieprotokollebene für Ihre Organisation festlegen.
• Häufig gestellte Fragen zu Visual Studio Code – Konsultieren Sie die häufig gestellten Fragen, um mehr zu erfahren.
• Benutzer- und Arbeitsbereichseinstellungen – Lesen Sie die verfügbaren Optionen zur Anpassung von VS Code.