Skip to content

Conversation

Copilot
Copy link
Contributor

@Copilot Copilot AI commented Oct 7, 2025

Fixes #48775

Summary

This PR adds comprehensive documentation for the new dotnet run telemetry feature introduced in .NET SDK 10.0.100 via dotnet/sdk#50793. The telemetry helps drive development and understand usage of file-based apps.

Changes

Data Points Table

Added 10 new telemetry data points to the main table documenting what dotnet run collects:

  • Hashed project/file identifier (SHA256)
  • Application type (file-based or project-based)
  • Number of SDKs, PackageReferences, and ProjectReferences
  • Launch profile usage and configuration
  • File-based app specific metrics (additional properties, build method used)

New Section: "dotnet run telemetry"

Created a dedicated subsection explaining:

Common telemetry for all dotnet run executions:

  • Application type classification
  • Hashed identifiers for privacy
  • Dependency counts
  • Launch profile usage patterns

Additional telemetry for file-based apps only:

  • Number of #:property directives
  • Build method (MSBuild vs Roslyn compiler)

The documentation clarifies that all identifiers are hashed using SHA256, with file-based apps using the entry point file path and project-based apps using the project file path (or relative path from repository root when available).

Documentation Guidelines

  • Updated ms.date to reflect current date
  • Followed Microsoft Writing Style Guide conventions
  • Used "for example" instead of "e.g."
  • Applied proper formatting for code elements and UI text
Original prompt

This section details on the original issue you should resolve

<issue_title>Add docs for new dotnet run telemetry</issue_title>
<issue_description>### Type of issue

Missing information

Description

In dotnet/sdk#50793 we added feature-based telemetry for dotnet run to help drive development and usage of the file-based apps feature.

We need to document the data we'll be collecting and when it's collected.

[Enter feedback here]

Page URL

https://learn.microsoft.com/en-us/dotnet/core/tools/telemetry

Content source URL

https://github.com/dotnet/docs/blob/main/docs/core/tools/telemetry.md

Document Version Independent Id

50433ae5-4687-fe5f-75ab-a47e1a706777

Platform Id

315d25b4-0ae6-3fff-2eac-19afec16d9c7

Article author

@baronfel

Metadata

  • ID: c136055b-bb04-17b6-19b2-42d4610c1a70
  • PlatformId: 315d25b4-0ae6-3fff-2eac-19afec16d9c7
  • Service: dotnet-fundamentals

Related Issues


Associated WorkItem - 493975</issue_description>

Comments on the Issue (you are @copilot in this section)

Fixes #48775

💬 Share your feedback on Copilot coding agent for the chance to win a $200 gift card! Click here to start the survey.


Internal previews

📄 File 🔗 Preview link
docs/core/tools/telemetry.md .NET SDK and .NET CLI telemetry

@Copilot Copilot AI changed the title [WIP] Add documentation for dotnet run telemetry feature Add documentation for dotnet run telemetry in .NET SDK 10.0.100 Oct 7, 2025
@Copilot Copilot AI requested a review from meaghanlewis October 7, 2025 22:17
Copilot finished work on behalf of meaghanlewis October 7, 2025 22:17
@meaghanlewis meaghanlewis changed the title Add documentation for dotnet run telemetry in .NET SDK 10.0.100 Add documentation for dotnet run telemetry in .NET SDK 10 Oct 8, 2025
@meaghanlewis meaghanlewis marked this pull request as ready for review October 8, 2025 21:19
@meaghanlewis meaghanlewis requested a review from a team as a code owner October 8, 2025 21:19
Copy link
Contributor

@Copilot Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull Request Overview

This PR adds comprehensive documentation for the new dotnet run telemetry feature introduced in .NET SDK 10.0.100. The telemetry helps Microsoft understand usage patterns of file-based applications and drives future development decisions.

  • Added 10 new telemetry data points to the main telemetry data table
  • Created a dedicated subsection explaining dotnet run telemetry collection
  • Updated documentation date to reflect current changes

@meaghanlewis meaghanlewis merged commit 833966b into main Oct 10, 2025
10 checks passed
@meaghanlewis meaghanlewis deleted the copilot/add-dotnet-run-telemetry-docs branch October 10, 2025 19:41
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add docs for new dotnet run telemetry

3 participants