[Profiling .NET] Update the .NET profiling doc to support Single Step APM Instrumentation

[chrisnas]

What does this PR do? What is the motivation?

We faced customer cases where the profiling documentation could be misleading when APM is deployed with Single Step Instrumentation. So, the enabling and troubleshooting parts of the .NET profiling documentation are updated to be more explicit.

Merge instructions

Merge readiness:

• Ready for merge

Merge queue is enabled in this repo. To have it automatically merged after it receives the required reviews, create the PR (from a branch that follows the <yourname>/description naming convention) and then add the following PR comment:

/merge

Additional notes

[github-actions]

Preview links (active after the build_preview check completes)

Modified Files

• https://docs-staging.datadoghq.com/chrisnas/dotnet_update_for_ssi/profiler/enabling/dotnet
• https://docs-staging.datadoghq.com/chrisnas/dotnet_update_for_ssi/profiler/profiler_troubleshooting/dotnet

[andrewlock]

LGTM overall, just some general questions/suggestions, thanks!

[buraizu]

Hi team, just adding the work in progress label for now, as it appears there is some open feedback on the new content. Please feel free to remove the label when the content has been finalized and is ready for documentation team review.

[chrisnas]

Hi team, just adding the work in progress label for now, as it appears there is some open feedback on the new content. Please feel free to remove the label when the content has been finalized and is ready for documentation team review.

@buraizu: It should be fine to merge now

[buraizu]

Thanks for the PR, requesting some updates per the style guide and for clarity

[buraizu]

Suggested change

	2. Look for `CorProfiler::Initialize: Continuous Profiler initialized successfully.` near the end. If that message is not present, enable debug logs by setting the `DD_TRACE_DEBUG` environment variable for the application.
	2. Look for `CorProfiler::Initialize: Continuous Profiler initialized successfully` near the end. If that message is not present, enable debug logs by setting the `DD_TRACE_DEBUG` environment variable for the application.

[chrisnas]

This is a string that appears in the log file so I would not remove the .

[buraizu]

Suggested change

	- `Profiler signal handler was replaced again. It will not be restored: the profiler is disabled.`
	- `Fail to restore profiler signal handler.`
	- `Profiler signal handler was replaced again. It will not be restored: the profiler is disabled`
	- `Fail to restore profiler signal handler`

[chrisnas]

Since these strings appear as is in the log file, the . should not be removed.

[buraizu]

/merge

[dd-devflow]

Devflow running: /merge

View all feedbacks in Devflow UI.

---

2025-02-05 19:26:21 UTC ℹ️ MergeQueue: pull request added to the queue

The median merge time in master is 7m.

---

2025-02-05 19:36:17 UTC ℹ️ MergeQueue: This merge request was merged