Skip to content

Commit eac02df

Browse files
authored
Update debugging and profiling documentation
Clarify performance impact of enabling perf maps or jit dumps.
1 parent cdce86b commit eac02df

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 may cause up to a 20% overhead though often it is 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 may 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)