通过

用于调试和分析的运行时配置选项

  • 项目

本文详细介绍可用于配置 .NET 调试和分析的设置。

注意

.NET 6 为用于配置 .NET 运行时行为的环境变量标准化前缀 DOTNET_ 而不是 COMPlus_。 但是，COMPlus_ 前缀仍将继续正常工作。 如果使用的是早期版本的 .NET 运行时，则环境变量仍应该使用 COMPlus_ 前缀。

启用诊断

  • 配置是启用还是禁用调试器、探查器和 EventPipe 诊断。
  • 如果省略此设置，则会启用诊断。 它等效于将值设置为 1。
设置名 值
runtimeconfig.json 不可用 不可用
环境变量 COMPlus_EnableDiagnostics 或 DOTNET_EnableDiagnostics 1 - 启用
0 - 禁用

启用分析

  • 配置是否为当前正在运行的进程启用分析。
  • 如果省略此设置，则会禁用分析。 它等效于将值设置为 0。
设置名 值
runtimeconfig.json 不可用 不可用
环境变量 CORECLR_ENABLE_PROFILING 0 - 禁用
1 - 启用

探查器 GUID

  • 指定要加载到当前正在运行的进程中的探查器 GUID。
设置名 值
runtimeconfig.json 不可用 不可用
环境变量 CORECLR_PROFILER string-guid

探查器位置

  • 指定要加载到当前正在运行的进程（或 32 位/64 位进程）的探查器 DLL 路径。
  • 如果设置了多个变量，则优先使用指定位数的变量。 它们指定要加载的探查器的位数。
  • 有关详细信息，请参阅 Finding the profiler library（查找探查器库）。
设置名 值
环境变量 CORECLR_PROFILER_PATH string-path
环境变量 CORECLR_PROFILER_PATH_32 string-path
环境变量 CORECLR_PROFILER_PATH_64 string-path

导出 perf 映射和 jit 转储

  • 启用或禁用 perf 映射或 jit 转储的选择性启用。 这些文件允许第三方工具（如 Linux perf 工具）标识动态生成的代码和预编译的 ReadyToRun (R2R) 模块的调用位置。
  • 如果省略此设置，则会禁用写入 perf 映射和 jit 转储文件。 它等效于将值设置为 0。
  • 禁用 perf 映射时，并非所有托管的调用站点都将正确解析。
  • perf 工具支持这两种格式，具体取决于 Linux 内核版本。
  • 启用 perf 映射或 jit 转储会导致 10-20% 的开销。 为了最大程度地降低性能影响，建议有选择地启用 perf 映射或 jit 转储，但不要同时启用这两者。

下表比较了 perf 映射和 jit 映射。

格式 说明 支持平台
perf 映射 发出 /tmp/perf-<pid>.map，其中包含动态生成的代码的符号信息。
发出 /tmp/perfinfo-<pid>.map，其中包括 ReadyToRun (R2R) 模块符号信息，并由 PerfCollect 使用。		 所有 Linux 内核版本都支持 perf 映射。
jit 转储 jit 转储格式取代了 perf 映射，并包含更详细的符号信息。 启用后，jit 转储会输出到 /tmp/jit-<pid>.dump 文件。 Linux 内核版本 5.4 或更高。
设置名 值
runtimeconfig.json 不可用 不可用
环境变量 COMPlus_PerfMapEnabled 或 DOTNET_PerfMapEnabled 0 - 禁用
1 - 同时启用了 perf 映射和 jit 转储
2 - 启用了 jit 转储
3 - 启用了 perf 映射

性能日志标记

  • 允许或禁止在性能日志中将指定信号作为标记予以接受和忽略。
  • 如果省略此设置，则不会忽略指定的信号。 它等效于将值设置为 0。
设置名 值
runtimeconfig.json 不可用 不可用
环境变量 COMPlus_PerfMapIgnoreSignal 或 DOTNET_PerfMapIgnoreSignal 0 - 禁用
1 - 启用

注意

如果省略 DOTNET_PerfMapEnabled 或将其设置为 0（即禁用），则将忽略此设置。