Skip to content
Open
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 20 additions & 0 deletions content/en/profiler/profiler_troubleshooting/nodejs.md
Original file line number Diff line number Diff line change
Expand Up @@ -56,6 +56,26 @@
When the Datadog profiler is enabled, it periodically sends a small signal to collect profiling data. If the application is idle (waiting for I/O or timers), this signal briefly wakes the event loop to take a sample, even though there's no real work to do. As a result, ELU appears higher because the loop wakes up more often, but CPU usage stays low, and no latency or extra workload is introduced.
In a busy application, these same signals occur while the loop is already active, so the effect on ELU is negligible.

## Disabling Advanced Profiling Features

Check warning on line 59 in content/en/profiler/profiler_troubleshooting/nodejs.md

View workflow job for this annotation

GitHub Actions / vale

Datadog.headings

'Disabling Advanced Profiling Features' should use sentence-style capitalization.

Advanced profiling capabilities in Datadog provide rich context—such as endpoint-level visibility, timeline correlations, and code hotspot linking—that significantly improve analysis quality.
Under normal circumstances, these should remain enabled. However, when diagnosing performance issues or overhead, temporarily disabling specific components can help isolate the source of additional load.
The goal is to narrow down which feature contributes to CPU, memory, or latency changes during profiling.

1. Disable Code Hotspots

`DD_PROFILING_CODEHOTSPOTS_ENABLED=false` Disables trace-to-profile linking in Datadog UI.

2. Disable Timeline View

`DD_PROFILING_TIMELINE_ENABLED=false` Disables timeline view in the Datadog UI.

3. Disable Endpoint Collection

`DD_PROFILING_ENDPOINT_COLLECTION_ENABLED=false` Disables per-endpoint aggregation of profiling data, this prevents grouping samples by HTTP endpoints or routes

Once you identify that disabling a specific profiling feature reduces overhead, please report your findings so we can investigate further. You can contact [Datadog support][5]

Check warning on line 77 in content/en/profiler/profiler_troubleshooting/nodejs.md

View workflow job for this annotation

GitHub Actions / vale

Datadog.pronouns

Avoid first-person pronouns such as 'we'.

Check warning on line 77 in content/en/profiler/profiler_troubleshooting/nodejs.md

View workflow job for this annotation

GitHub Actions / vale

Datadog.words

Use '' instead of 'please'.

Check warning on line 77 in content/en/profiler/profiler_troubleshooting/nodejs.md

View workflow job for this annotation

GitHub Actions / vale

Datadog.words

Use 'After' instead of 'Once'.

## Further Reading

{{< partial name="whats-next/whats-next.html" >}}
Expand Down
Loading