diff --git a/docs/core/tools/telemetry.md b/docs/core/tools/telemetry.md index fcb4fbc10fdeb..6fdd8c5bc62a7 100644 --- a/docs/core/tools/telemetry.md +++ b/docs/core/tools/telemetry.md @@ -106,6 +106,17 @@ The telemetry feature collects the following data: | >=8.0.100 | Whether library mode for mobile is used. | | >=8.0.100 | Whether NativeAOT is used. | | >=8.0.100 | The Mono runtime pack version that was used. | +| >=10.0.100 | Hashed project identifier for `dotnet run`. | +| >=10.0.100 | Application type of either file-based app or project-based for `dotnet run`. | +| >=10.0.100 | The launch profile name if specified for `dotnet run`. | +| >=10.0.100 | Whether a launch profile was specified for `dotnet run`.| +| >=10.0.100 | The launch settings configuration model used (if any) for `dotnet run`. | +| >=10.0.100 | Number of SDKs used for `dotnet run`. | +| >=10.0.100 | Number of PackageReferences for `dotnet run`. | +| >=10.0.100 | Number of ProjectReferences for `dotnet run`. | +| >=10.0.100 | Number of additional properties for file-based apps with `dotnet run`. | +| >=10.0.100 | Whether MSBuild was used for file-based apps with `dotnet run`. | +| >=10.0.100 | Whether Roslyn compiler was used for file-based apps with `dotnet run`. | | >=10.0.100 | The detected LLM agent name if the CLI was invoked from an LLM agent. For more information, see [LLM detection](#llm-detection).| ### Collected options @@ -148,6 +159,27 @@ The `dotnet new` template instantiation command collects additional data for Mic * `--framework` * `--auth` +### dotnet run telemetry + +The `dotnet run` command collects feature-based telemetry to help drive development and usage of file-based apps, starting with .NET SDK 10.0.100: + +**Telemetry for all `dotnet run` executions:** + +- Application type (file-based or project-based) +- Hashed project or file identifier +- Number of SDKs used +- Number of PackageReferences +- Number of ProjectReferences +- Launch profile usage (whether `--launch-profile` or `--no-launch-profile` was used) +- Whether the launch profile is a default profile +- Launch settings model applied, if any + +**Telemetry for file-based apps only:** + +- Number of additional properties (for example, `#:property` directives) +- Whether MSBuild was used for building +- Whether the Roslyn compiler was used directly + ## Crash exception telemetry If the .NET CLI/SDK crashes, it collects the name of the exception and stack trace of the CLI/SDK code. This information is collected to assess problems and improve the quality of the .NET SDK and CLI. This article provides information about the data we collect. It also provides tips on how users building their own version of the .NET SDK can avoid inadvertent disclosure of personal or sensitive information.