.NET Core-CLI-Tools-Telemetrie.NET Core CLI Tools telemetry

Das .NET Core-SDK beinhaltet eine Telemetriefunktion, die Benutzerinformationen sammelt.The .NET Core SDK includes a telemetry feature that collects usage information. Es ist wichtig, dass das .NET-Team versteht, wie die Tools verwendet werden, damit sie verbessert werden können.It's important that the .NET Team understands how the tools are used so that we can improve them. Weitere Informationen finden Sie unter What we've learned from .NET Core SDK Telemetry (Was wir von der .NET Core SDK Telemetrie gelernt haben).For more information, see What we've learned from .NET Core SDK Telemetry.

Die gesammelten Daten sind anonym und werden unter der Creative Commons Attribution-Lizenz in aggregierter Form für die Verwendung sowohl von Microsoft als auch von der Community veröffentlicht.The collected data is anonymous and published in an aggregated form for use by both Microsoft and the community under the Creative Commons Attribution License.

BereichScope

Der dotnet-Befehl wird zum Starten von sowohl Apps als auch .NET Core-CLI verwendet.The dotnet command is used to launch both apps and the .NET Core CLI. Der dotnet-Befehl selbst sammelt keine Telemetrie.The dotnet command itself doesn't collect telemetry. Die .NET Core-CLI-Befehle, die vom Befehl dotnet ausgeführt werden, sammeln die Telemetrie.The .NET Core CLI commands run by the dotnet command collect the telemetry.

Die Telemetrie wird durch die Verwendung des Befehls dotnet allein nicht aktiviert, wenn kein Befehl angefügt ist:Telemetry isn't enabled when using the dotnet command itself, with no command attached:

  • dotnet
  • dotnet [path-to-app]

Die Telemetrie wird aktiviert, wenn Sie die .NET Core-CLI-Befehle verwenden, zum Beispiel:Telemetry is enabled when using the .NET Core CLI commands, such as:

  • dotnet build
  • dotnet pack
  • dotnet restore
  • dotnet run

VerhaltenBehavior

Die Telemetriefunktion der .NET Core-CLI ist standardmäßig aktiviert.The .NET Core CLI Tools telemetry feature is enabled by default. Deaktivieren Sie die Telemetriefunktion, indem Sie die Umgebungsvariable DOTNET_CLI_TELEMETRY_OPTOUT auf 1 oder true festlegen.Opt-out of the telemetry feature by setting the DOTNET_CLI_TELEMETRY_OPTOUT environment variable to 1 or true.

DatenpunkteData points

Die Funktion sammelt die folgenden Daten:The feature collects the following data:

  • Den Zeitstempel des Aufrufs†Timestamp of invocation†
  • Den aufgerufenen Befehl (zum Beispiel „build“)†Command invoked (for example, "build")†
  • Die aus drei Oktetten bestehende IP-Adresse, die zur Bestimmung des geografischen Standorts verwendet wirdThree octet IP address used to determine geographical location†
  • ExitCode des BefehlsExitCode of the command
  • Test Runner (für Testprojekte)Test runner (for test projects)
  • Betriebssystem und Version†Operating system and version†
  • Ob Runtime-IDs im Knoten „Laufzeiten“ vorhanden sindWhether runtime IDs are present in the runtimes node
  • Die .NET Core SDK-Version†.NET Core SDK version†

†Diese Metrik wird veröffentlicht.†This metric is published.

Ab dem .NET Core SDK 2.0 werden neue Datenpunkte gesammelt:Starting with .NET Core SDK 2.0, new data points are collected:

  • Argumente und Optionen des Befehls dotnet: nur bekannte Argumente und Optionen werden gesammelt (keine beliebigen Zeichenfolgen).dotnet command arguments and options: only known arguments and options are collected (not arbitrary strings).
  • Ob das SDK in einem Container ausgeführt wird.Whether the SDK is running in a container.
  • Zielframeworks.Target frameworks.
  • MAC-Adresse mit Hash: eine kryptografisch (SHA256) anonyme und eindeutige ID für einen Computer.Hashed MAC address: a cryptographically (SHA256) anonymous and unique ID for a machine. Diese Metrik wird nicht veröffentlicht.This metric is not published.
  • Das derzeitige Arbeitsverzeichnis mit Hash.Hashed current working directory.

Die Funktion sammelt keine Daten wie z.B. Benutzernamen oder E-Mail-Adressen.The feature doesn't collect personal data, such as usernames or email addresses. Es scannt Ihren Code nicht und extrahiert keine vertraulichen Daten auf Projektebene, zum Beispiel Name, Repository oder Autor.It doesn't scan your code and doesn't extract sensitive project-level data, such as name, repo, or author. Die Daten werden mithilfe der Technologie Microsoft Azure Application Insights sicher an die Microsoft-Server gesendet, unter eingeschränktem Zugriff gespeichert und unter strikter Sicherheitskontrolle durch die Systeme von Azure Storage veröffentlicht.The data is sent securely to Microsoft servers using Microsoft Azure Application Insights technology, held under restricted access, and published under strict security controls from secure Azure Storage systems.

Wir würden gern wissen, wie die Tools verwendet werden und ob sie gut funktionieren, nicht was Sie mit den Tools erstellen.We want to know how the tools are used and if they're working well, not what you're building with the tools. Wenn Sie vermuten, dass durch die Telemetrie vertrauliche Daten gesammelt werden oder wir die Daten nicht sicher oder ordnungsgemäß behandeln, file an issue in the dotnet/cli repo issues (melden Sie ein Problem in den dotnet- oder CLI-Repository-Problemen) zur Überprüfung.If you suspect that the telemetry is collecting sensitive data or that we're insecurely or inappropriately handling data, file an issue in the dotnet/cli repo issues for investigation.

Veröffentlichte DatenPublished data

Veröffentlichte Daten sind vierteljährlich verfügbar und werden unter .NET Core SDK Usage Data (.NET Core SDK Nutzungsdaten) aufgelistet.Published data is available quarterly and are listed at .NET Core SDK Usage Data. Die Spalten der Datendatei sind:The columns of a data file are:

  • ZeitstempelTimestamp
  • Occurrences†Occurrences†
  • BefehlCommand
  • Geography‡Geography‡
  • OSFamilyOSFamily
  • RuntimeIDRuntimeID
  • OSVersionOSVersion
  • SDKVersionSDKVersion

Die Spalte Occurences zeigt die Gesamtanzahl der Verwendung dieses Befehls für die Metriken dieser Reihe an diesem Tag an.†The Occurrences column displays the aggregate count of that command's use for that row's metrics that day.

Die Spalte Geography zeigt normalerweise den Namen eines Landes an.‡Typically, the Geography column displays the name of a country. In einigen Fällen wird der Kontinent Antarktis in dieser Spalte angezeigt. Dies geschieht entweder, weil Experten .NET Core in der Antarktis verwenden oder wegen falschen Standortdaten.In some cases, the continent of Antarctica appears in this column, either due to researchers using .NET Core in Antarctica or incorrect location data.

BeispielExample

ZeitstempelTimestamp OccurrencesOccurrences BefehlCommand GeographyGeography OSFamilyOSFamily RuntimeIDRuntimeID OSVersionOSVersion SDKVersionSDKVersion
4/16/2017 0:004/16/2017 0:00 88 Ausführungrun UgandaUganda DarwinDarwin osx.10.12-x64osx.10.12-x64 10.1210.12 1.0.11.0.1

DatasetsDatasets

2016 - Q32016 - Q3
2016 - Q42016 - Q4
2017 - Q12017 - Q1
2017 - Q22017 - Q2

Zusätzliche Datasets werden mithilfe des Standardformat für URLs bereitgestellt.Additional datasets are posted using a standard URL format. Ersetzen Sie <YEAR> durch das Jahr und <QUARTER> durch das Quartal des Jahrs (verwenden Sie 1, 2, 3 oder 4).Replace <YEAR> with the year and replace <QUARTER> with the quarter of the year (use 1, 2, 3, or 4). Die Dateien befinden sich im Format einer durch Tabstopp getrennten Datei (TSV).The files are in tab-separated values (TSV) format.

https://dotnetcli.blob.core.windows.net/usagedata/dotnet-cli-usage-<YEAR>-q<QUARTER>.tsv

LizenzLicense

Die Microsoft-Verteilung von .NET Core ist lizenziert mit den Lizenzbedingungen der Microsoft .NET-Bibliothek.The Microsoft distribution of .NET Core is licensed with the MICROSOFT .NET LIBRARY EULA. Diese Lizenz enthält den Abschnitt „DATA“ (Daten) zum Aktivieren von Telemetrie (siehe unten).This license includes the "DATA" section to enable telemetry (shown below).

.NET NuGet-Pakete verwenden die gleiche Lizenz, aktivieren die Telemetrie jedoch nicht (siehe Bereich)..NET NuGet packages use the same license but don't enable telemetry (see Scope).

  1. DatenDATA. Die Software sammelt möglicherweise Daten zum Benutzer und zur Nutzung der Software und übermittelt diese an Microsoft.The software may collect information about you and your use of the software, and send that to Microsoft. Microsoft kann diese Informationen verwenden, um seine Produkte und -Dienste zu verbessern.Microsoft may use this information to improve our products and services. Weitere Informationen zur Datenerfassung und -verwendung finden Sie in der Hilfedokumentation und in den Datenschutzbestimmungen unter http://go.microsoft.com/fwlink/?LinkId=528096.You can learn more about data collection and use in the help documentation and the privacy statement at http://go.microsoft.com/fwlink/?LinkId=528096. Ihre Verwendung der Software gilt als Zustimmung zu diesen Verfahren.Your use of the software operates as your consent to these practices.

OffenlegungDisclosure

In den .NET Core-CLI-Tools wird beim ersten Ausführen einer der Befehle (z.B. dotnet restore) der folgende Text angezeigt.The .NET Core CLI Tools display the following text when you first run one of the commands (for example, dotnet restore). Der Text kann abhängig von der von Ihnen ausgeführten Version des SDK leicht variieren.Text may vary slightly depending on the version of the SDK you're running. Über diese erste Ausführung benachrichtigt Microsoft Sie über die Datensammlung.This "first run" experience is how Microsoft notifies you about data collection.

Welcome to .NET Core!
---------------------
Learn more about .NET Core @ https://aka.ms/dotnet-docs. Use dotnet --help to see available commands or go to https://aka.ms/dotnet-cli-docs.

Telemetry
--------------
The .NET Core tools collect usage data in order to improve your experience. The data is anonymous and does not include command-line arguments. The data is collected by Microsoft and shared with the community.
You can opt out of telemetry by setting a DOTNET_CLI_TELEMETRY_OPTOUT environment variable to 1 using your favorite shell.
You can read more about .NET Core tools telemetry @ https://aka.ms/dotnet-cli-telemetry.

Siehe auchSee also

What we've learned from .NET Core SDK Telemetry (Was wir von der .NET Core-SDK-Telemetrie gelernt haben)What we've learned from .NET Core SDK Telemetry
Telemetry reference source (dotnet/cli repo; release/2.0.0 branch) (Verweisquelle der Telemetrie (dotnet-/CLI-Repository, Version 2.0.0 Branch) Telemetry reference source (dotnet/cli repo; release/2.0.0 branch)
.NET Core SDK Usage Data (.NET Core SDK-Nutzungsdaten).NET Core SDK Usage Data