Diagnostische extensies

In dit artikel vindt u een overzicht van alle Microsoft Testing Platform extensies met betrekking tot de diagnostische functie.

Ingebouwde opties

De volgende platformopties bieden nuttige informatie voor het oplossen van problemen met uw test-apps:

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

U kunt de diagnostische logboeken ook inschakelen met behulp van de omgevingsvariabelen:

Environment variable name	Beschrijving
TESTINGPLATFORM_DIAGNOSTIC	Als deze optie is ingesteld 1, schakelt u de diagnostische logboekregistratie in.
TESTINGPLATFORM_DIAGNOSTIC_VERBOSITY	Definieert het uitgebreidheidsniveau. De beschikbare waarden zijnTrace, Debug, Information, Warning, of ErrorCritical.
TESTINGPLATFORM_DIAGNOSTIC_OUTPUT_DIRECTORY	De uitvoermap van de diagnostische logboekregistratie, als het bestand niet is opgegeven, wordt gegenereerd in de standaardmap TestResults .
TESTINGPLATFORM_DIAGNOSTIC_OUTPUT_FILEPREFIX	Het voorvoegsel voor de naam van het logboekbestand. Standaard ingesteld op "log_".
TESTINGPLATFORM_DIAGNOSTIC_FILELOGGER_SYNCHRONOUSWRITE	Dwingt de ingebouwde logboekregistratie van bestanden om synchroon logboeken te schrijven. Handig voor scenario's waarin u geen logboekvermeldingen wilt verliezen (als het proces vastloopt). Dit vertraagt de uitvoering van de test.

Notitie

Omgevingsvariabelen hebben voorrang op de opdrachtregelargumenten.

Crashdump

Met deze extensie kunt u een crashdumpbestand maken als het proces vastloopt. Deze extensie wordt geleverd als onderdeel van het NuGet-pakket Microsoft.Testing.Extensions.CrashDump .

Belangrijk

Het pakket wordt geleverd met de gesloten bronbronbibliotheek van Microsoft .NET om het licentiemodel te gebruiken.

Gebruik de volgende opties om het genereren van crashdumpbestanden te configureren:

Optie	Omschrijving
--crashdump	Genereert een dumpbestand wanneer het testhostproces vastloopt. Ondersteund in .NET 6.0+.
⁠-⁠-⁠crashdump-⁠filename	Hiermee geeft u de bestandsnaam van de dump.
--crashdump-type	Hiermee geeft u het type van de dump. Geldige waarden zijn Mini, Heap, Triage, . Full Standaardwaarden als Full. Zie Typen minidumps voor meer informatie.

Let op

De extensie is niet compatibel met .NET Framework en wordt op de achtergrond genegeerd. Voor .NET Framework-ondersteuning schakelt u de postmortem-foutopsporing in met Sysinternals ProcDump. Zie Postmortem-foutopsporing inschakelen: Window Sysinternals ProcDump voor meer informatie. De postmortem-foutopsporingsoplossing verzamelt ook crashinformatie voor het proces voor .NET, zodat u het gebruik van de extensie kunt voorkomen als u zich richt op zowel .NET- als .NET Framework-testtoepassingen.

Vastlopen dump

Met deze extensie kunt u een dumpbestand maken na een bepaalde time-out. Deze extensie wordt geleverd als onderdeel van het pakket Microsoft.Testing.Extensions.HangDump .

Belangrijk

Het pakket wordt geleverd met de gesloten bronbronbibliotheek van Microsoft .NET om het licentiemodel te gebruiken.

Gebruik de volgende opties om het genereren van hangdumpbestanden te configureren:

Optie	Omschrijving
--hangdump	Genereert een dumpbestand voor het geval het testhostproces vastloopt.
-⁠-⁠hangdump-⁠filename	Hiermee geeft u de bestandsnaam van de dump.
--hangdump-timeout	Hiermee geeft u de time-out waarna de dump wordt gegenereerd. De time-outwaarde wordt opgegeven in een van de volgende indelingen: 1.5h, , 1.5hour1.5hours 90m, , , 90min90minute90minutes 5400s, , 5400sec5400second, . 5400seconds Standaard ingesteld op 30m (30 minuten).
--hangdump-type	Hiermee geeft u het type van de dump. Geldige waarden zijn Mini, Heap, Triage, . Full Standaardwaarden als Full. Zie Typen minidumps voor meer informatie.