Diagnosztikai bővítmények

Ez a cikk felsorolja és ismerteti a Diagnosztikai képességhez kapcsolódó összes Microsoft.Testing.Platform-bővítményt.

Beépített beállítások

A következő platformbeállítások hasznos információkat nyújtanak a tesztalkalmazások hibaelhárításához:

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

A diagnosztikai naplókat a környezeti változók használatával is engedélyezheti:

Környezeti változó neve	Leírás
TESTINGPLATFORM_DIAGNOSTIC	Ha 1értékre van állítva, engedélyezi a diagnosztikai naplózást.
TESTINGPLATFORM_DIAGNOSTIC_VERBOSITY	Meghatározza a részletességi szintet. Az elérhető értékek a következők: Trace, Debug, Information, Warning, Errorvagy Critical.
TESTINGPLATFORM_DIAGNOSTIC_OUTPUT_DIRECTORY	A diagnosztikai naplózás kimeneti könyvtára, ha nincs megadva, a fájl az alapértelmezett TestResults könyvtárban jön létre.
TESTINGPLATFORM_DIAGNOSTIC_OUTPUT_FILEPREFIX	A naplófájl nevének előtagja. Alapértelmezés szerint "log_".
TESTINGPLATFORM_DIAGNOSTIC_FILELOGGER_SYNCHRONOUSWRITE	A beépített fájlnaplózót kényszeríti a naplók szinkronizálására. Olyan helyzetekben hasznos, amikor nem szeretné elveszíteni a naplóbejegyzéseket (ha a folyamat összeomlik). Ez lelassítja a teszt végrehajtását.

Jegyzet

A környezeti változók elsőbbséget élveznek a parancssori argumentumokkal szemben.

Összeomlási memóriakép

Ez a bővítmény lehetővé teszi hibaelhárítási memóriafájl létrehozását, ha a folyamat összeomlik. Ezt a bővítményt a Microsoft.Testing.Extensions.CrashDump NuGet-csomag részeként szállítjuk.

A rendszerösszeomlási memóriaképfájl-létrehozás konfigurálásához használja az alábbi beállításokat:

Opció	Leírás
--crashdump	Kivonatfájlt hoz létre, amikor a teszt hosztfolyamat összeomlik. A .NET 6.0+-ban támogatott.
⁠-⁠-⁠crashdump-⁠filename	Megadja a kiíratási fájl fájlnevét.
--crashdump-type	Meghatározza a dump típusát. Az érvényes értékek a következők: Mini, Heap, Triage, Full. Alapértelmezés szerint Full. További információkért lásd: Mini memóriaképek típusai.

Figyelem

A bővítmény nem kompatibilis a .NET-keretrendszerrel, ezért csendben figyelmen kívül lesz hagyva. A .NET-keretrendszer támogatásához engedélyeznie kell a postmortem hibakeresést a Sysinternals ProcDump használatával. További információért lásd: A postmortem hibakeresés engedélyezése: Windows Sysinternals ProcDump. A postmortem hibakeresési megoldás a folyamat összeomlási adatait is összegyűjti a .NET-hez, így elkerülheti a bővítmény használatát, ha a .NET és a .NET-keretrendszer tesztalkalmazásait is célozza.

Memóriakép készítés

Ez a bővítmény lehetővé teszi egy mentési fájl létrehozását egy adott időkorlát után. Ezt a bővítményt a Microsoft.Testing.Extensions.HangDump csomag részeként szállítjuk.

A dumpfájl létrehozásának konfigurálásához használja az alábbi beállításokat:

Opció	Leírás
--hangdump	Memóriaképfájlt hoz létre, ha a tesztgazdafolyamat lefagy.
-⁠-hangdump-filename	Megadja a kiíratási fájl fájlnevét.
--hangdump-timeout	Megadja azt az időkorlátot, amely után a memóriakép létrejön. Az időtúllépési érték az alábbi formátumok egyikében van megadva: \, \, \ 90m, 90min, 90minute90minutes 5400s, 5400sec, 5400second. 5400seconds Alapértelmezés szerint 30m (30 perc).
--hangdump-type	Meghatározza a dump típusát. Az érvényes értékek a következők: Mini, Heap, Triage, Full. Alapértelmezés szerint Full. További információkért lásd: Mini memóriaképek típusai.