Document .NET Containers telemetry for SDK 8.0.400

[Copilot]

SDK 8.0.400 introduced telemetry collection for container build/publish operations. This documents the data points collected for base image inference and container creation.

Changes

Base image inference telemetry (lines 83-91):

• Inference decision (manual vs. automatic)
• Target framework, project type (ASP.NET Core/Console), publish mode (AOT/Trimmed/Self-Contained/Framework-Dependent)
• Base image/tag and container family (Microsoft images only, to avoid leaking customer data)
• Invariant globalization flag and target RIDs

Container creation and publishing telemetry (lines 92-99):

• Registry types for pull/push operations (Azure, AWS, Google, GitHub, Docker Hub, MCR, Other)
• Local sources/destinations (Docker, Podman, Tarball)
• Error diagnostics: type (unknown repository, credential failure, RID mismatch, local load), direction (push/pull for credential failures), and available RIDs for mismatches

Data collection respects existing DOTNET_CLI_TELEMETRY_OPTOUT controls.

Sources

• ComputeDotnetBaseImageAndTag.cs
• CreateNewImage.cs
• Container telemetry docs

Original prompt

---

This section details on the original issue you should resolve

<issue_title>Add documentation for new .NET Containers telemetry in 8.0.400</issue_title>
<issue_description>### Type of issue

Missing information

Description

In dotnet/sdk#41747 we added new telemetry collection for the Containers feature that is collected during build/publish. We need to log this new collection before the 8.0.400 release.

• base image inference telemetry data
• image publishing telemetry data

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

Article author

@KathleenDollard

Metadata

• ID: c136055b-bb04-17b6-19b2-42d4610c1a70
• Service: dotnet-fundamentals

---

Associated WorkItem - 429415</issue_description>

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

@baronfel I added some in-repo documentation for the containers telemetry to use as a source of data for this documentation: https://github.com/dotnet/sdk-container-builds/pull/586 @gewarren @CamSoper Do you want to take this one since it's related to containers?

• Fixes Add documentation for new .NET Containers telemetry in 8.0.400 #41546

---

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

---

Internal previews

📄 File	🔗 Preview link
docs/core/tools/telemetry.md	docs/core/tools/telemetry

[Copilot]

Pull request overview

This PR adds documentation for .NET Containers telemetry collection introduced in SDK 8.0.400. The documentation is placed in the telemetry.md file under the .NET 8 tab, following the pattern used for version-specific telemetry data points. The changes document what data is collected during container build/publish operations, including base image inference and container creation/publishing details, with appropriate privacy protections (only Microsoft images logged).

Changes:

• Added comprehensive telemetry documentation for SDK 8.0.400+ container features under the .NET 8 tab
• Documented base image inference telemetry (framework, image names, project type, publish mode, etc.)
• Documented container creation and publishing telemetry (registry types, local sources/destinations, error handling)

[Copilot]

Missing Oxford comma before "local load". According to the documentation style guide, all lists must use the Oxford comma. Change to "unknown repository, credential failure, RID mismatch, and local load".

[meaghanlewis]

@copilot apply changes based on this feedback

[Copilot]

Fixed in commit e4dab8d. Added the Oxford comma before "local load" and improved clarity of error details with "Additional details for..." phrasing.