Clarify .NET profiler overhead guidance by install method. by anandreshmi46 · Pull Request #39132 · DataDog/documentation

anandreshmi46 · 2026-08-12T12:43:19Z

Add platform tabs under machine-wide profiling so Linux SSI, manual Linux, and Windows each have scoped reduce-overhead steps without mixing IIS-only advice into SSI flows.

What does this PR do? What is the motivation?

Merge readiness

Ready for merge

For Datadog employees:

⚠️ Your branch name MUST follow the <name>/<description> convention and include the forward slash (/). If you've already created your PR with an incorrect branch name, please rename your branch and open a fresh PR.
🤖 New: Comment with /review to run an automated check that catches common issues before a Documentation team member reviews your PR.

AI assistance

Additional notes

Add platform tabs under machine-wide profiling so Linux SSI, manual Linux, and Windows each have scoped reduce-overhead steps without mixing IIS-only advice into SSI flows. Co-authored-by: Cursor <cursoragent@cursor.com>

github-actions · 2026-08-12T12:48:00Z

Preview links (active after the `build_preview` check completes)

Modified Files

https://docs-staging.datadoghq.com/reshmi/dotnet-profiler-reduce-overhead-troubleshooting/profiler/profiler_troubleshooting/dotnet

chrisnas

LGTM

rtrieu

some minor feedback for your consideration

Co-authored-by: Rosa Trieu <107086888+rtrieu@users.noreply.github.com>

…ubleshooting

rtrieu · 2026-08-13T16:57:05Z

+To reduce overhead:
+
+- Use `DD_PROFILING_ENABLED=auto` instead of `true` when enabling profiling host-wide. With `auto`, profiling starts only when the application has run for more than 30 seconds **and** at least one trace was created.
+- Use [instrumentation rules][6] to limit which processes receive SSI.


this link needs to be placed within the tab in order to render

Suggested change

- Use [instrumentation rules][6] to limit which processes receive SSI.

- Use [instrumentation rules][101] to limit which processes receive SSI.

rtrieu

hi @anandreshmi46 noticed a link isn't rendering, and added a few comments. please request a re-review when ready!

rtrieu · 2026-08-13T16:57:33Z

+- Use `DD_PROFILING_ENABLED=auto` instead of `true` when enabling profiling host-wide. With `auto`, profiling starts only when the application has run for more than 30 seconds **and** at least one trace was created.
+- Use [instrumentation rules][6] to limit which processes receive SSI.
+- Set `DD_PROFILING_ENABLED=false` in a specific process environment to opt that process out of profiling. Tracing is not affected.
+


Suggested change

[6]: /tracing/trace_collection/single-step-apm/linux/#define-instrumentation-rules

Co-authored-by: Rosa Trieu <107086888+rtrieu@users.noreply.github.com>

…ubleshooting

Move link definitions out of Hugo tabs to the page footer so instrumentation rules and enabling links render correctly. Co-authored-by: Cursor <cursoragent@cursor.com>

…ubleshooting

rtrieu

hi @anandreshmi46, the links must be within the tabs in order for them to work.

rtrieu · 2026-08-17T16:36:42Z

@@ -147,8 +145,6 @@ If it is set to another value or not set at all, the profiler is disabled.

   Note that the following message could appear, but it does not impact Datadog profiling: `Profiler signal handler has been replaced. Restoring it.` This indicates only that the Datadog signal handler is reinstalled when it was overwritten.



Suggested change

[4]: /profiler/enabling/dotnet/?tab=linux#configuration

rtrieu · 2026-08-17T16:37:06Z

@@ -85,8 +85,6 @@ If you've configured the profiler and don't see profiles in the profile search p
   - The application ran for more than 30 seconds
 If it is set to another value or not set at all, the profiler is disabled.



Suggested change

[4]: /profiler/enabling/dotnet/?tab=linux#configuration

rtrieu · 2026-08-17T17:13:36Z

@@ -147,8 +145,6 @@ If it is set to another value or not set at all, the profiler is disabled.

   Note that the following message could appear, but it does not impact Datadog profiling: `Profiler signal handler has been replaced. Restoring it.` This indicates only that the Datadog signal handler is reinstalled when it was overwritten.



No description provided.

rtrieu · 2026-08-17T17:14:52Z

@@ -200,8 +196,6 @@ The default profiler log directory is `%ProgramData%\Datadog .NET Tracer\logs\`.

   5. Check the other HTTP codes for possible errors such as 403 for invalid API key.



No description provided.

Reference links inside tabs must be defined within the same tab to render correctly in the docs site. Co-authored-by: Cursor <cursoragent@cursor.com>

…ubleshooting

Clarify .NET profiler overhead guidance by install method.

befa868

Add platform tabs under machine-wide profiling so Linux SSI, manual Linux, and Windows each have scoped reduce-overhead steps without mixing IIS-only advice into SSI flows. Co-authored-by: Cursor <cursoragent@cursor.com>

anandreshmi46 requested a review from a team as a code owner August 12, 2026 12:43

anandreshmi46 requested review from chrisnas and r1viollet August 12, 2026 12:53

chrisnas approved these changes Aug 12, 2026

View reviewed changes

jhgilbert added the astro-reorg-no-conflicts Needs manual conflict resolution after replatforming reorg label Aug 12, 2026

rtrieu requested changes Aug 12, 2026

View reviewed changes

anandreshmi46 requested a review from rtrieu August 13, 2026 10:17

Update hugo/content/en/profiler/profiler_troubleshooting/dotnet.md

a2d3103

Co-authored-by: Rosa Trieu <107086888+rtrieu@users.noreply.github.com>

This comment has been minimized.

Sign in to view

Merge branch 'master' into reshmi/dotnet-profiler-reduce-overhead-tro…

be59ae5

…ubleshooting

rtrieu reviewed Aug 13, 2026

View reviewed changes

Comment thread hugo/content/en/profiler/profiler_troubleshooting/dotnet.md Outdated

rtrieu reviewed Aug 13, 2026

View reviewed changes

rtrieu requested changes Aug 13, 2026

View reviewed changes

anandreshmi46 and others added 7 commits August 14, 2026 11:15

Update hugo/content/en/profiler/profiler_troubleshooting/dotnet.md

bd20dc1

Co-authored-by: Rosa Trieu <107086888+rtrieu@users.noreply.github.com>

Update hugo/content/en/profiler/profiler_troubleshooting/dotnet.md

2f74a97

Co-authored-by: Rosa Trieu <107086888+rtrieu@users.noreply.github.com>

Update hugo/content/en/profiler/profiler_troubleshooting/dotnet.md

6f87788

Co-authored-by: Rosa Trieu <107086888+rtrieu@users.noreply.github.com>

Update hugo/content/en/profiler/profiler_troubleshooting/dotnet.md

c921339

Co-authored-by: Rosa Trieu <107086888+rtrieu@users.noreply.github.com>

Update hugo/content/en/profiler/profiler_troubleshooting/dotnet.md

7fa4133

Co-authored-by: Rosa Trieu <107086888+rtrieu@users.noreply.github.com>

Update hugo/content/en/profiler/profiler_troubleshooting/dotnet.md

fc8b00d

Co-authored-by: Rosa Trieu <107086888+rtrieu@users.noreply.github.com>

Merge branch 'master' into reshmi/dotnet-profiler-reduce-overhead-tro…

338762d

…ubleshooting

anandreshmi46 requested a review from rtrieu August 17, 2026 09:08

anandreshmi46 and others added 2 commits August 17, 2026 11:13

Fix broken reference links in .NET profiler troubleshooting doc.

933e51f

Move link definitions out of Hugo tabs to the page footer so instrumentation rules and enabling links render correctly. Co-authored-by: Cursor <cursoragent@cursor.com>

Merge branch 'master' into reshmi/dotnet-profiler-reduce-overhead-tro…

8eb859d

…ubleshooting

rtrieu requested changes Aug 17, 2026

View reviewed changes

anandreshmi46 and others added 2 commits August 17, 2026 19:50

Move tab-scoped link definitions inside Hugo tabs.

47d97fc

Reference links inside tabs must be defined within the same tab to render correctly in the docs site. Co-authored-by: Cursor <cursoragent@cursor.com>

Merge branch 'master' into reshmi/dotnet-profiler-reduce-overhead-tro…

97beddf

…ubleshooting

rtrieu approved these changes Aug 17, 2026

View reviewed changes

anandreshmi46 merged commit 3952e9e into master Aug 19, 2026
24 checks passed

anandreshmi46 deleted the reshmi/dotnet-profiler-reduce-overhead-troubleshooting branch August 19, 2026 16:45

	- Use [instrumentation rules][6] to limit which processes receive SSI.
	- Use [instrumentation rules][101] to limit which processes receive SSI.


	[6]: /tracing/trace_collection/single-step-apm/linux/#define-instrumentation-rules

		@@ -147,8 +145,6 @@ If it is set to another value or not set at all, the profiler is disabled.

		Note that the following message could appear, but it does not impact Datadog profiling: `Profiler signal handler has been replaced. Restoring it.` This indicates only that the Datadog signal handler is reinstalled when it was overwritten.

		@@ -85,8 +85,6 @@ If you've configured the profiler and don't see profiles in the profile search p
		- The application ran for more than 30 seconds
		If it is set to another value or not set at all, the profiler is disabled.

		@@ -200,8 +196,6 @@ The default profiler log directory is `%ProgramData%\Datadog .NET Tracer\logs\`.

		5. Check the other HTTP codes for possible errors such as 403 for invalid API key.

Uh oh!

Conversation

anandreshmi46 commented Aug 12, 2026

What does this PR do? What is the motivation?

Merge readiness

For Datadog employees:

AI assistance

Additional notes

Uh oh!

github-actions Bot commented Aug 12, 2026

Preview links (active after the build_preview check completes)

Modified Files

Uh oh!

chrisnas left a comment

Choose a reason for hiding this comment

Uh oh!

rtrieu left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

This comment has been minimized.

Uh oh!

rtrieu Aug 13, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

rtrieu left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

rtrieu Aug 13, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

rtrieu left a comment

Choose a reason for hiding this comment

Uh oh!

rtrieu Aug 17, 2026

Choose a reason for hiding this comment

Uh oh!

rtrieu Aug 17, 2026

Choose a reason for hiding this comment

Uh oh!

rtrieu Aug 17, 2026

Choose a reason for hiding this comment

Uh oh!

rtrieu Aug 17, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

Preview links (active after the `build_preview` check completes)

rtrieu Aug 13, 2026 •

edited

Loading

rtrieu Aug 13, 2026 •

edited

Loading