.NET Core Tools Telemetry
This topic applies to .NET Core Tools Preview 2. For the .NET Core Tools RC4 version, see the .NET Core Tools Telemetry (.NET Core Tools RC4) topic.
The .NET Core Tools include a telemetry feature that collects usage information. It’s important that the .NET Team understands how the tools are being used so that we can improve them.
The data collected is anonymous and will be published in an aggregated form for use by both Microsoft and community engineers under the Creative Commons Attribution License.
dotnet command is used to launch both apps and the .NET Core Tools. The
dotnet command itself does not collect telemetry. It is the .NET Core Tools that are run via the
dotnet command that collect telemetry.
.NET Core commands (telemetry is not enabled):
.NET Core Tools commands (telemetry is enabled), such as:
The .NET Core Tools telemetry feature is enabled by default. You can opt-out of the telemetry feature by setting an environment variable DOTNET_CLI_TELEMETRY_OPTOUT (for example,
export on macOS/Linux,
set on Windows) to true (for example, “true”, 1).
The feature collects the following pieces of data:
- The command being used (for example, “build”, “restore”)
- The ExitCode of the command
- For test projects, the test runner being used
- The timestamp of invocation
- The framework used
- Whether runtime IDs are present in the “runtimes” node
- The CLI version being used
The feature will not collect any personal data, such as usernames or emails. It will not scan your code and not extract any project-level data that can be considered sensitive, such as name, repo or author (if you set those in your project.json). We want to know how the tools are used, not what you are building with the tools. If you find sensitive data being collected, that’s a bug. Please file an issue and it will be fixed.
The Microsoft distribution of .NET Core is licensed with the MICROSOFT .NET LIBRARY EULA. This includes the “DATA” section re-printed below, to enable telemetry.
2. DATA. The software may collect information about you and your use of the software, and send that to Microsoft. Microsoft may use this information to improve our products and services. 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 . Your use of the software operates as your consent to these practices.
The .NET Core Tools display the following text when you first run one of the commands (for example,
dotnet restore). This "first run" experience is how Microsoft notifies you about data collection. This same experience also initially populates your NuGet cache with the libraries in the .NET Core SDK, avoiding requests to NuGet.org (or other NuGet feed) for these libraries.
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 commandline 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. Configuring... -------------- A command is running to initially populate your local package cache, to improve restore speed and enable offline access. This command will take up to a minute to complete and will only happen once.