Rozšíření diagnostiky

Tento článek obsahuje seznam a vysvětluje všechna rozšíření Microsoft.Testing.Platform související s možnostmi diagnostiky.

Předdefinované možnosti

Následující možnosti platformy poskytují užitečné informace pro řešení potíží s testovacími aplikacemi:

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

Diagnostické protokoly můžete povolit také pomocí proměnných prostředí:

Název proměnné prostředí	Popis
TESTINGPLATFORM_DIAGNOSTIC	Pokud je nastavená hodnota 1, povolí protokolování diagnostiky.
TESTINGPLATFORM_DIAGNOSTIC_VERBOSITY	Definuje úroveň podrobností. Dostupné hodnoty jsou Trace, Debug, Information, Warning, Errornebo Critical.
TESTINGPLATFORM_DIAGNOSTIC_OUTPUT_DIRECTORY	Výstupní adresář protokolování diagnostiky, pokud není zadaný, soubor se vygeneruje ve výchozím adresáři TestResults.
TESTINGPLATFORM_DIAGNOSTIC_OUTPUT_FILEPREFIX	Předpona názvu souboru protokolu. Výchozí hodnota je "log_".
TESTINGPLATFORM_DIAGNOSTIC_FILELOGGER_SYNCHRONOUSWRITE	Vynutí integrovaný nástroj pro záznam souborů, aby synchronně zapisoval protokoly. Užitečné ve scénářích, kdy nechcete ztratit žádné položky protokolu (pokud se proces chybově ukončí). Tím se zpomalí spuštění testu.

Poznámka

Proměnné prostředí mají přednost před argumenty příkazového řádku.

Výpis stavu systému

Toto rozšíření umožňuje vytvořit soubor s výpisem stavu systému, pokud se proces chybově ukončí. Toto rozšíření se dodává jako součást balíčku NuGet Microsoft.Testing.Extensions.CrashDump.

Ke konfiguraci generování souboru s výpisem stavu systému použijte následující možnosti:

Možnost	Popis
--crashdump	Vygeneruje výpisový soubor při chybovém ukončení procesu testovacího hostitele. Podporováno v .NET 6.0 nebo novější.
⁠-⁠-⁠crashdump-⁠filename	Určuje název souboru s výpisem.
--crashdump-type	Určuje typ výpisu. Platné hodnoty jsou Mini, Heap, Triage, Full. Výchozí hodnota je Full. Další informace naleznete v tématu Typy minidumpů.

Opatrnost

Rozšíření není kompatibilní s rozhraním .NET Framework a bude bezobslužně ignorováno. Pro podporu rozhraní .NET Framework povolíte postmortem ladění pomocí nástroje Sysinternals ProcDump. Další informace naleznete v tématu Povolení postmortem ladění: Windows Sysinternals ProcDump. Řešení pro ladění postmortem také bude shromažďovat informace o chybách procesu pro .NET, abyste se vyhnuli použití rozšíření, pokud cílíte na testovací aplikace .NET i .NET Framework.

Zablokování výpisu paměti

Toto rozšíření umožňuje vytvořit soubor s výpisem paměti po daném časovém limitu. Toto rozšíření se dodává jako součást balíčku Microsoft.Testing.Extensions.HangDump.

K nastavení generování souboru záznamu zablokování použijte následující možnosti:

Možnost	Popis
--hangdump	Vygeneruje soubor s výpisem paměti pro případ, že proces testovacího hostitele přestane reagovat.
-⁠-hangdump-filename	Určuje název souboru s výpisem.
--hangdump-timeout	Určuje časový limit, po kterém se vygeneruje výpis paměti. Hodnota časového limitu je zadána v jednom z následujících formátů: 1.5h, , 1.5hour1.5hours 90m, 90min, , 90minute90minutes 5400s, 5400sec, 5400second. 5400seconds Výchozí hodnota je 30m (30 minut).
--hangdump-type	Určuje typ výpisu. Platné hodnoty jsou Mini, Heap, Triage, Full. Výchozí hodnota je Full. Další informace naleznete v tématu Typy minidumpů.