Rozšíření diagnostiky

Tento článek obsahuje seznam všech Microsoft Testing Platform rozšíření souvisejících 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í:

Environment variable name	Popis
TESTINGPLATFORM_DIAGNOSTIC	Pokud je 1tato možnost nastavená, povolí protokolování diagnostiky.
TESTINGPLATFORM_DIAGNOSTIC_VERBOSITY	Definuje úroveň podrobností. Dostupné hodnoty jsou Trace, WarningErrorDebugInformationnebo .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 "log_"je .
TESTINGPLATFORM_DIAGNOSTIC_FILELOGGER_SYNCHRONOUSWRITE	Vynutí integrovaný protokolovací nástroj pro zápis protokolů synchronně. 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 .

Důležité

Balíček se dodává s knihovnou Microsoft .NET uzavřenou zdrojovou knihovnou microsoftu zdarma pro použití licenčního modelu.

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

Možnost	Popis
--crashdump	Vygeneruje soubor s výpisem paměti 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 výpisu paměti.
--crashdump-type	Určuje typ výpisu paměti. Platné hodnoty jsou Mini, Heap, Triage, Full. Výchozí hodnoty jako Full. Další informace naleznete v tématu Typy mini výpisů paměti.

Upozornění

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í ladění Postmortem: Window 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 .

Důležité

Balíček se dodává s knihovnou Microsoft .NET uzavřenou zdrojovou knihovnou microsoftu zdarma pro použití licenčního modelu.

Ke konfiguraci generování souboru s výpisem stavu systému 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 výpisu paměti.
--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 paměti. Platné hodnoty jsou Mini, Heap, Triage, Full. Výchozí hodnoty jako Full. Další informace naleznete v tématu Typy mini výpisů paměti.