Diagnostiktillägg

Den här artikeln innehåller en lista över och förklarar alla Microsoft Testing Platform tillägg som rör 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.

Viktig

Paketet levereras med Microsoft .NET-biblioteket med stängd källkod och en gratis att använda-licensmodell.

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.

Viktig

Paketet levereras med Microsoft .NET-biblioteket, som har en licensieringsmodell för stängd källkod och är gratis att använda.

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.5hour, 1.5hours 90m, 90min, 90minute, 90minutes 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 Full. Mer information finns i typer av minidumpar.