Diagnostiktillägg

I den här artikeln listas och förklaras alla Microsoft Testing Platform tillägg som rör diagnostikfunktionen.

Inbyggda alternativ

Följande plattformsalternativ ger användbar information för att felsöka dina 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öns variabelnamn	beskrivning
TESTINGPLATFORM_DIAGNOSTIC	Om värdet är 1inställt på aktiverar du diagnostikloggning.
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.

Kommentar

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.

Viktigt!

Paketet levereras med Microsoft .NET-biblioteket med stängd källkod utan kostnad för att använda licensieringsmodellen.

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

Alternativ	Description
--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ärdena är Full. Mer information finns i Typer av minidumpar.

Varning

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 Aktivera postmortem-felsökning: 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 Paketet Microsoft.Testing.Extensions.HangDump .

Viktigt!

Paketet levereras med Microsoft .NET-biblioteket med stängd källkod utan kostnad för att använda licensieringsmodellen.

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

Alternativ	Description
--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 Standardvärdet är 30m (30 minuter).
--hangdump-type	Anger typen av dump. Giltiga värden är Mini, Heap, Triage, Full. Standardvärdena är Full. Mer information finns i Typer av minidumpar.