診斷延伸模組

本文列出並說明與診斷功能相關的所有 Microsoft Testing Platform 延伸模組。

內建選項

下列平台選項提供適用於測試應用程式的疑難排解資訊：

• --info
• --diagnostic
• ⁠-⁠-⁠diagnostic-⁠filelogger-⁠synchronouswrite
• --diagnostic-verbosity
• --diagnostic-output-fileprefix
• --diagnostic-output-directory

您也可以使用環境變數來啟用診斷記錄：

Environment variable name	描述
TESTINGPLATFORM_DIAGNOSTIC	如果設定為 1，則啟用診斷記錄。
TESTINGPLATFORM_DIAGNOSTIC_VERBOSITY	定義詳細程度的層級。 可用的值為 Trace、Debug、Information、Warning、Error 或 Critical。
TESTINGPLATFORM_DIAGNOSTIC_OUTPUT_DIRECTORY	如果未指定檔案，則診斷記錄的輸出目錄會在預設 TestResults 目錄中產生。
TESTINGPLATFORM_DIAGNOSTIC_OUTPUT_FILEPREFIX	記錄檔名稱的首碼。 預設為 "log_"。
TESTINGPLATFORM_DIAGNOSTIC_FILELOGGER_SYNCHRONOUSWRITE	強制內建檔案記錄器同步寫入記錄。 適用於您不想遺失任何記錄項目的案例 (如果流程當機)。 這會讓測試執行變慢。

注意

環境變數的優先順序高於命令列引數。

損毀傾印

此延伸模組可讓您在處理程序損毀時建立損毀傾印檔案。 此延伸模組隨附於 Microsoft.Testing.Extensions.CrashDump NuGet 套件中。

重要

此套件隨附 Microsoft .NET 程式庫封閉原始碼免費使用授權模型。

若要設定損毀傾印檔案的產生，請使用下列選項：

選項	描述
--crashdump	當測試主機處理序損毀時產生傾印檔案。 .NET 6.0+ 支援此功能。
⁠-⁠-⁠crashdump-⁠filename	指定傾印的檔案名稱。
--crashdump-type	指定傾印的類型。 有效值為 Mini、Heap、Triage、Full。 預設值為 Full。 如需詳細資訊，請參閱迷你傾印的類型。

警告

此延伸模組與 .NET Framework 不相容，而且會以無訊息方式遭到忽略。 若要支援.NET Framework，您可以使用 Sysinternals ProcDump 啟用事後偵錯。 如需詳細資訊，請參閱啟用事後偵錯：Window Sysinternals ProcDump。 事後偵錯解決方案也會收集 .NET 的處理程序損毀資訊，因此如果您以 .NET 和 .NET Framework 測試應用程式為目標，則可以避免使用延伸模組。

停止回應傾印

此延伸模組可讓您在指定的逾時之後建立傾印檔案。 此延伸模組隨附於 Microsoft.Testing.Extensions.HangDump 套件中。

重要

此套件隨附 Microsoft .NET 程式庫封閉原始碼免費使用授權模型。

若要設定停止回應傾印檔案的產生，請使用下列選項：

選項	描述
--hangdump	如果測試主機處理序停止回應，則產生傾印檔案。
-⁠-⁠hangdump-⁠filename	指定傾印的檔案名稱。
--hangdump-timeout	指定逾時多久後產生傾印。 逾時值會以下列其中一種格式指定： 1.5h、1.5hour、1.5hours 90m, 90min, 90minute, 90minutes 5400s, 5400sec, 5400second, 5400seconds。 預設為 30m (30 分鐘)。
--hangdump-type	指定傾印的類型。 有效值為 Mini、Heap、Triage、Full。 預設值為 Full。 如需詳細資訊，請參閱迷你傾印的類型。