Skip to content

Conversation

Copilot
Copy link
Contributor

@Copilot Copilot AI commented Oct 20, 2025

Summary

This PR adds documentation for MSBuild TaskFactory telemetry data collection to the .NET SDK and .NET CLI telemetry page.

Changes

Added two new telemetry data points to the data collection table for SDK version >=10.0.100:

  1. Usage counts of MSBuild Task Factories - Tracks which Task Factories are used to load and run tasks, including:

    • Inline C# tasks
    • Multithreaded-aware tasks
    • Out-of-process tasks
  2. Number of MSBuild tasks executed in TaskHosts versus not in TaskHosts - Tracks task execution context metrics

Context

The .NET SDK now collects telemetry data related to how MSBuild runs Tasks, as implemented in dotnet/dotnet#2488. This telemetry helps the team:

  • Understand the usage of niche TaskHostFactory implementations
  • Measure the uptake and usage of two new and evolving features:
    • .NET TaskHost
    • Multithreaded MSBuild

Associated WorkItem: 498949

Original prompt

This section details on the original issue you should resolve

<issue_title>Add MSBuild TaskFactory Telemetry usage</issue_title>
<issue_description>### Type of issue

Typo

Description

In dotnet/dotnet#2488 we added collection of telemetry data related to how MSBuild runs Tasks. Specifically we're interested in

  • which Task Factories are used to load and run tasks and how many times they are used
    • the different TaskFactories support different MSBuild use cases, like inline C# Tasks, MultiThreaded-aware Tasks, Our-of-Process Tasks, and so on
  • How many Tasks overall are executed in TaskHosts vs not

This data will help us understand the usage of a few niche TaskHostFactory implementations, as well as help measure the uptake/usage of two new (and evolving/preview) features of MSBuild: the .NET TaskHost and Multithreaded MSBuild.

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

@ChetHusk

Metadata

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

Related Issues


Associated WorkItem - 498949</issue_description>

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

Fixes #48646


✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.


Internal previews

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

@Copilot Copilot AI changed the title [WIP] Add telemetry usage for MSBuild TaskFactory Add MSBuild TaskFactory telemetry documentation Oct 20, 2025
@Copilot Copilot AI requested a review from meaghanlewis October 20, 2025 23:03
Copilot finished work on behalf of meaghanlewis October 20, 2025 23:03
@meaghanlewis meaghanlewis marked this pull request as ready for review October 21, 2025 20:53
@meaghanlewis meaghanlewis requested a review from a team as a code owner October 21, 2025 20:53
@Copilot Copilot AI review requested due to automatic review settings October 21, 2025 20:53
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 documentation for MSBuild TaskFactory telemetry data collection to the .NET SDK and .NET CLI telemetry page. The documentation describes two new telemetry data points being collected starting from SDK version 10.0.100.

Key changes:

  • Added telemetry data point for MSBuild Task Factory usage tracking
  • Added telemetry data point for TaskHost execution metrics

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 MSBuild TaskFactory Telemetry usage

2 participants