共用方式為

偵錯和分析的執行階段設定選項

  • 發行項

本文詳細說明可用來設定 .NET 偵錯和分析的設定。

注意

.NET 6 會針對設定 .NET Runtime 行為的環境變數，透過前置詞 DOTNET_ (而非 COMPlus_) 進行標準化。 不過，COMPlus_ 前置詞將繼續運作。 如果使用舊版的 .NET 執行階段，則您仍應對環境變數使用 COMPlus_ 前置詞。

啟用診斷

  • 設定啟用還是停用偵錯工具、分析工具和 EventPipe 診斷。
  • 如果您省略此設定，則會啟用診斷。 這相當於設定 1 值。
設定名稱 值
runtimeconfig.json N/A N/A
環境變數 COMPlus_EnableDiagnostics 或 DOTNET_EnableDiagnostics 1 - 已啟用
0 - 已停用

啟用分析

  • 設定目前執行中處理序是否啟用分析。
  • 如果您省略此設定，則會停用分析。 這相當於設定 0 值。
設定名稱 值
runtimeconfig.json N/A N/A
環境變數 CORECLR_ENABLE_PROFILING 0 - 已停用
1 - 已啟用

分析工具 GUID

  • 指定要載入至目前執行中處理程的分析工具 GUID。
設定名稱 值
runtimeconfig.json N/A N/A
環境變數 CORECLR_PROFILER string-guid

分析工具位置

  • 指定要載入至目前執行中處理序 (或 32 位元或 64 位元處理序) 的分析工具 DLL 路徑。
  • 如果設定多個變數，則會優先使用位元特定變數。 其會指定要載入的分析工具位元。
  • 如需詳細資訊，請參閱尋找分析工具程式庫。
設定名稱 值
環境變數 CORECLR_PROFILER_PATH string-path
環境變數 CORECLR_PROFILER_PATH_32 string-path
環境變數 CORECLR_PROFILER_PATH_64 string-path

匯出效能地圖和 jit 傾印

  • 啟用或停用效能地圖或 jit 傾印的選擇性啟用。 這些檔案允許第三方工具，例如 Linux perf 工具，識別動態產生的程式碼和先行編譯 ReadyToRun (R2R) 模組的呼叫網站。
  • 如果您省略此設定，則會停用寫入效能地圖和 jit 傾印檔案。 這相當於設定 0 值。
  • 停用效能地圖時，將不會正確解析所有受控呼叫網站。
  • 根據 Linux 核心版本，perf 工具支援這兩種格式。
  • 啟用效能地圖或 jit 傾印會造成 10-20% 的額外負荷。 若要將效能影響降到最低，建議您選擇性地啟用效能地圖或 jit 傾印，但不要同時啟用兩者。

下表比較效能地圖和 jit 地圖。

格式 描述 支援的項目
效能地圖 發出 /tmp/perf-<pid>.map，其中包含動態產生程式碼的符號資訊。
發出 /tmp/perfinfo-<pid>.map，其中包含 ReadyToRun (R2R) 模組符號資訊，並由 PerfCollect使用。		 所有 Linux 核心版本都支援效能地圖。
Jit 傾印 jit 傾印格式會取代效能地圖，並包含更詳細的符號資訊。 啟用時，jit 傾印會輸出至 /tmp/jit-<pid>.dump 檔案。 Linux 核心 5.4 版或更高版本。
設定名稱 值
runtimeconfig.json N/A N/A
環境變數 COMPlus_PerfMapEnabled 或 DOTNET_PerfMapEnabled 0 - 已停用
1 - 已啟用效能地圖和 jit 傾印
2 - 已啟用 jit 傾印
3 - 已啟用效能地圖

效能記錄標記

  • 啟用或停用要接受並忽略為效能記錄中標記的指定訊號。
  • 如果您省略此設定，則不會忽略指定的訊號。 這相當於設定 0 值。
設定名稱 值
runtimeconfig.json N/A N/A
環境變數 COMPlus_PerfMapIgnoreSignal 或 DOTNET_PerfMapIgnoreSignal 0 - 已停用
1 - 已啟用

注意

如果省略 DOTNET_PerfMapEnabled，或設定為 0 (即已停用)，則會忽略此設定。