Číst v angličtině

Sdílet prostřednictvím

Rozšíření diagnostiky

  • Článek

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

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.

Důležité

Balíček se dodává s uzavřenou knihovnou Microsoft .NET a modelem licencování zdarma k použití.

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ů.

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í 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.

Důležité

Balíček se dodává s uzavřenou zdrojovou knihovnou Microsoft .NET s licenčním modelem pro bezplatné použití.

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 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.5hour, 1.5hours
90m, 90min, 90minute, 90minutes
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í hodnota je Full. Další informace naleznete v tématu Typy minidumpů.