Add documentation for DOTNET_HOST_TRACE environment variables (.NET 10+) #47603
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Co-authored-by: elinor-fung <[email protected]>
Copilot
AI
changed the title
[WIP] Add docs for
Add documentation for DOTNET_HOST_TRACE environment variables (.NET 10+)
Jul 28, 2025
DOTNET_HOST_TRACE environment variables.
It should indicate that it was added in .NET 10. The variables mean the same thing as the COREHOST_TRACE environment variables (COREHOST_ prefix is replaced with DOTNET_HOST_). The doc for `...
Copilot finished work on behalf of
elinor-fung
July 28, 2025 19:24
elinor-fung
reviewed
Jul 28, 2025
…COREHOST_TRACE duplication Co-authored-by: elinor-fung <[email protected]>
Copilot finished work on behalf of
elinor-fung
July 28, 2025 20:09
elinor-fung
reviewed
Jul 28, 2025
Co-authored-by: elinor-fung <[email protected]>
Copilot finished work on behalf of
elinor-fung
July 28, 2025 20:22
elinor-fung
reviewed
Jul 28, 2025
gewarren
approved these changes
Jul 28, 2025
Co-authored-by: Genevieve Warren <[email protected]>
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
This PR adds comprehensive documentation for the new
DOTNET_HOST_TRACEenvironment variables introduced in .NET 10, which replace the existingCOREHOST_TRACEvariables.cc @dotnet/appmodel @AaronRobinsonMSFT
Changes Made
New DOTNET_HOST_TRACE Documentation
Added a new section documenting the three
DOTNET_HOST_TRACEenvironment variables:DOTNET_HOST_TRACE=[0/1]- Controls diagnostics tracing enablementDOTNET_HOST_TRACEFILE=<file path>- Specifies trace output file locationDOTNET_HOST_TRACE_VERBOSITY=[1/2/3/4]- Sets trace verbosity levelThe documentation includes:
Updated COREHOST_TRACE Documentation
Modified the existing
COREHOST_TRACEsection to include a note directing users to prefer the newDOTNET_HOST_TRACEvariables for .NET 10+, while maintaining backward compatibility documentation. Simplified the variable descriptions to reference the equivalentDOTNET_HOST_*variables instead of duplicating detailed information.Enhanced Dependency Loading Documentation
Updated the environment variables table in the default probing documentation to focus on the new
DOTNET_HOST_TRACEvariables with a reference link to detailed documentation, removing duplication and version annotations from individual table cells.Impact
DOTNET_HOST_TRACEvariablesCOREHOST_TRACEdocumentation remains intact for backward compatibility with reduced duplicationThe
DOTNET_HOST_TRACEvariables work identically to theirCOREHOST_TRACEcounterparts, providing the same diagnostics tracing functionality with updated naming that aligns with theDOTNET_prefix convention.💡 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