Diagnostiktillägg

I den här artikeln visas och förklaras alla Microsoft.Testing.Platform-tillägg relaterade till diagnostikfunktionen.

Inbyggda alternativ

Följande plattformsalternativ ge användbar information för felsökning av testappar:

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

Du kan också aktivera diagnostikloggarna med hjälp av miljövariablerna:

Miljövariabelnamn	Beskrivning
TESTINGPLATFORM_DIAGNOSTIC	Om värdet är inställt på 1aktiverar du diagnostikloggningen.
TESTINGPLATFORM_DIAGNOSTIC_VERBOSITY	Definierar verbositetsnivån. De tillgängliga värdena är Trace, Debug, Information, Warning, Erroreller Critical.
TESTINGPLATFORM_DIAGNOSTIC_OUTPUT_DIRECTORY	Utdatakatalogen för diagnostikloggningen, om den inte anges, genereras filen i standardkatalogen TestResults.
TESTINGPLATFORM_DIAGNOSTIC_OUTPUT_FILEPREFIX	Prefixet för loggfilens namn. Standardvärdet är "log_".
TESTINGPLATFORM_DIAGNOSTIC_FILELOGGER_SYNCHRONOUSWRITE	Tvingar den inbyggda filloggaren att synkront skriva loggar. Användbart för scenarier där du inte vill förlora några loggposter (om processen kraschar). Detta gör testkörningen långsammare.

Not

Miljövariabler har företräde framför kommandoradsargumenten.

Kraschdump

Med det här tillägget kan du skapa en kraschdumpfil om processen kraschar. Det här tillägget levereras som en del av Microsoft.Testing.Extensions.CrashDump NuGet-paketet.

Använd följande alternativ för att konfigurera genereringen av kraschdumpfilen:

Alternativ	Beskrivning
--crashdump	Genererar en dumpfil när testvärdprocessen kraschar. Stöds i .NET 6.0+.
⁠-⁠-⁠crashdump-⁠filename	Anger dumpens filnamn.
--crashdump-type	Anger typen av dump. Giltiga värden är Mini, Heap, Triage, Full. Standardvärden är Full. För mer information, se typer av minidumpar.

Försiktighet

Tillägget är inte kompatibelt med .NET Framework och ignoreras tyst. För .NET Framework-stöd aktiverar du postmortem-felsökning med Sysinternals ProcDump. Mer information finns i Enabling Postmortem Debugging: Window Sysinternals ProcDump. Postmortem-felsökningslösningen samlar också in processkraschinformation för .NET så att du kan undvika att använda tillägget om du riktar in dig på både .NET- och .NET Framework-testprogram.

Hängdump

Med det här tillägget kan du skapa en dumpfil efter en viss tidsgräns. Det här tillägget levereras som en del av Microsoft.Testing.Extensions.HangDump-paketet.

Använd följande alternativ för att konfigurera genereringen av hang dump-filen:

Alternativ	Beskrivning
--hangdump	Genererar en dumpfil om testvärdprocessen låser sig.
-⁠-hangdump-filename	Anger dumpens filnamn.
--hangdump-timeout	Anger tidsgränsen efter vilken dumpen genereras. Tidsgränsvärdet anges i något av följande format: 1.5h, , 1.5hour1.5hours 90m, 90min, , 90minute90minutes 5400s, 5400sec, 5400second, . 5400seconds Standardinställningen är 30m (30 minuter).
--hangdump-type	Anger typen av dump. Giltiga värden är Mini, Heap, Triage, Full. Standardvärden är Full. För mer information, se typer av minidumpar.