Delen via

Diagnostische extensies

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

Ingebouwde opties

De volgende platformopties nuttige informatie bieden 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:

Naam van omgevingsvariabele Beschrijving
TESTINGPLATFORM_DIAGNOSTIC Als deze optie is ingesteld op 1, schakelt u de diagnostische logboekregistratie in.
TESTINGPLATFORM_DIAGNOSTIC_VERBOSITY Definieert het uitgebreidheidsniveau. De beschikbare waarden zijn Trace, Debug, Information, Warning, Errorof Critical.
TESTINGPLATFORM_DIAGNOSTIC_OUTPUT_DIRECTORY De uitvoermap van de diagnostische logboekregistratie, indien niet opgegeven, wordt het bestand gegenereerd in de standaardmap TestResults map.
TESTINGPLATFORM_DIAGNOSTIC_OUTPUT_FILEPREFIX Het voorvoegsel voor de naam van het logboekbestand. Standaard ingesteld op "log_".
TESTINGPLATFORM_DIAGNOSTIC_FILELOGGER_SYNCHRONOUSWRITE Dwingt de ingebouwde bestandslogger om logboeken synchroon 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 Microsoft.Testing.Extensions.CrashDump NuGet-pakket.

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

Optie Beschrijving
--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 Geeft het type van de dump aan. Geldige waarden zijn Mini, Heap, Triage, Full. Standaard ingesteld op Full. Zie Typen minidumpsvoor meer informatie.

Voorzichtigheid

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: Windows Sysinternals ProcDumpvoor 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.

Hangdump

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

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

Optie Beschrijving
--hangdump Genereert een dumpbestand voor het geval het testhostproces vastloopt.
-⁠-hangdump-filename Hiermee geeft u de bestandsnaam van de dump.
--hangdump-timeout Hiermee specificeert 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,90min,90minute,90minutes
5400s, 5400sec, 5400second, 5400seconds Standaard ingesteld op 30m (30 minuten).
--hangdump-type Geeft het type van de dump aan. Geldige waarden zijn Mini, Heap, Triage, Full. Standaard ingesteld op Full. Zie Typen minidumpsvoor meer informatie.