Skip to content
Open
Changes from all commits
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.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
## Disabling Advanced Profiling Features
## Disable advanced profiling features


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.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
The goal is to narrow down which feature contributes to CPU, memory, or latency changes during profiling.
You can do so 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
Comment on lines +65 to +75
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
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
- **Disable code hotspots**
Disable trace-to-profile linking in the Datadog UI:
```
DD_PROFILING_CODEHOTSPOTS_ENABLED=false
```
- **Disable timeline view**
Disable timeline view in the Datadog UI:
```
DD_PROFILING_TIMELINE_ENABLED=false
```
- **Disable endpoint collection**
Disable per-endpoint aggregation of profiling data, which groups samples by HTTP endpoints or routes:
```
DD_PROFILING_ENDPOINT_COLLECTION_ENABLED=false
```

Some minor formatting changes to create some indentation so it's easier to read, and make the code samples easier to see 🙂


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'.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
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]
After you identify that disabling a specific profiling feature reduces overhead, report your findings so Datadog can investigate further. You can do so by contacting [Datadog support][5].


## Further Reading

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