Skip to content

Commit f9832a5

Browse files
noahfalkgewarren
andauthored
Update debugging and profiling documentation (#48796)
* Update debugging and profiling documentation Clarify performance impact of enabling perf maps or jit dumps. * Update docs/core/runtime-config/debugging-profiling.md Co-authored-by: Genevieve Warren <[email protected]> --------- Co-authored-by: Genevieve Warren <[email protected]>
1 parent 902fa19 commit f9832a5

File tree

1 file changed

+2
-2
lines changed

1 file changed

+2
-2
lines changed

docs/core/runtime-config/debugging-profiling.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -52,11 +52,11 @@ This article details the settings you can use to configure .NET debugging and pr
5252

5353
## Export perf maps and jit dumps
5454

55-
- Enables or disables selective enablement of perf maps or jit dumps. These files allow third party tools, such as the Linux `perf` tool, to identify call sites for dynamically generated code and precompiled ReadyToRun (R2R) modules.
55+
- Enables or disables perf maps or jit dumps. These files allow third party tools, such as the Linux `perf` tool, to provide human readable names for dynamically generated code and precompiled ReadyToRun (R2R) modules.
5656
- If you omit this setting, writing perf map and jit dump files are both disabled. This is equivalent to setting the value to `0`.
5757
- When perf maps are disabled, not all managed callsites will be properly resolved.
5858
- Depending on the Linux kernel version, both formats are supported by the `perf` tool.
59-
- Enabling perf maps or jit dumps causes a 10-20% overhead. To minimize performance impact, it's recommended to selectively enable either perf maps or jit dumps, but not both.
59+
- Enabling perf maps or jit dumps might cause up to a 20% overhead, though often it's much less. To minimize performance impact, it's recommended to selectively enable either perf maps or jit dumps, but not both. The impact only occurs while the application is JITing code. Often that occurs at startup, but it might occur later if the application is running a new code path for the first time.
6060

6161
The following table compares perf maps and jit maps.
6262

0 commit comments

Comments
 (0)