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 be van 1á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őkTrace: , Debug, InformationWarning, 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értelmezett érték: "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.

Feljegyzés

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 összeomlási memóriaképfá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.

Fontos

A csomagot a Microsoft .NET-kódtár zárt forráskódú, ingyenes licencelési modellel szállítja.

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

Lehetőség	Leírás
--crashdump	Memóriaképfájlt hoz létre, amikor a tesztgazdafolyamat összeomlik. A .NET 6.0+-ban támogatott.
⁠-⁠-⁠crashdump-⁠filename	Megadja a memóriakép fájlnevét.
--crashdump-type	Megadja a memóriakép típusát. Az érvényes értékek a következőkMini: , Heap, TriageFull. Alapértelmezett érték: Full. További információkért lásd a miniképek típusait.

Figyelemfelhívás

A bővítmény nem kompatibilis a .NET-keretrendszer, és a rendszer csendben figyelmen kívül hagyja. A .NET-keretrendszer támogatásához engedélyezze a postmortem hibakeresést a Sysinternals ProcDump használatával. További információ: Postmortem hibakeresés engedélyezése: Window 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-et és .NET-keretrendszer tesztalkalmazásokat is célozza.

Lefagyó memóriakép

Ez a bővítmény lehetővé teszi egy memóriaképfájl létrehozását egy adott időtúllépés után. Ezt a bővítményt a Microsoft.Testing.Extensions.HangDump csomag részeként szállítjuk.

Fontos

A csomagot a Microsoft .NET-kódtár zárt forráskódú, ingyenes licencelési modellel szállítja.

A lefagyó memóriaképfájl létrehozásának konfigurálásához használja az alábbi beállításokat:

Lehetőség	Leírás
--hangdump	Memóriaképfájlt hoz létre, ha a tesztgazdafolyamat lefagy.
-⁠-⁠hangdump-⁠filename	Megadja a memóriakép fájlnevét.
--hangdump-timeout	Azt az időtúllépést adja meg, amely után a memóriakép létre lesz hozva. Az időtúllépési érték az alábbi formátumok egyikében van megadva: 1.5h, , 1.5hour1.5hours 90m, 90min, 90minute90minutes 5400s, 5400sec, 5400second. 5400seconds Alapértelmezés szerint 30m (30 perc).
--hangdump-type	Megadja a memóriakép típusát. Az érvényes értékek a következőkMini: , Heap, TriageFull. Alapértelmezett érték: Full. További információkért lásd a miniképek típusait.