Diagnoseerweiterungen

In diesem Artikel werden alle Microsoft.Testing.Platform-Erweiterungen aufgeführt und erläutert, die sich auf die Diagnosefunktion beziehen.

Integrierte Optionen

Die folgenden Plattformoptionen bieten nützliche Informationen zur Problembehandlung für Ihre Test-Apps:

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

Sie können die Diagnoseprotokolle auch mithilfe der Umgebungsvariablen aktivieren:

Name der Umgebungsvariable	BESCHREIBUNG
TESTINGPLATFORM_DIAGNOSTIC	Wenn auf 1 eingestellt, wird die Diagnoseprotokollierung aktiviert.
TESTINGPLATFORM_DIAGNOSTIC_VERBOSITY	Definiert den Ausführlichkeitsgrad. Verfügbare Werte sind Trace, Debug, Information, Warning, Error oder Critical.
TESTINGPLATFORM_DIAGNOSTIC_OUTPUT_DIRECTORY	Das Ausgabeverzeichnis der Diagnoseprotokollierung. Wird es nicht angegeben, wird die Datei im Standardverzeichnis TestResults generiert.
TESTINGPLATFORM_DIAGNOSTIC_OUTPUT_FILEPREFIX	Das Präfix für den Namen der Protokolldatei. Wird standardmäßig auf "log_" festgelegt.
TESTINGPLATFORM_DIAGNOSTIC_FILELOGGER_SYNCHRONOUSWRITE	Zwingt den integrierten Dateilogger, Protokolle synchron zu schreiben. Nützlich für Szenarien, in denen keine Protokolleinträge verloren gehen sollen (bei Prozessabsturz). Dadurch wird die Testausführung verlangsamt.

Hinweis

Umgebungsvariablen haben Vorrang vor den Befehlszeilenargumenten.

Absturzabbild

Mit dieser Erweiterung können Sie eine Absturzabbilddatei erstellen, wenn der Prozess abstürzt. Diese Erweiterung wird als Teil des Pakets "Microsoft.Testing.Extensions.CrashDump NuGet" ausgeliefert.

Verwenden Sie die folgenden Optionen, um die Absturzabbilddateigenerierung zu konfigurieren:

Auswahlmöglichkeit	BESCHREIBUNG
--crashdump	Generiert eine Speicherabbilddatei, wenn der Testhostprozess abstürzt. Wird in .NET 6.0+ unterstützt.
⁠-⁠-⁠crashdump-⁠filename	Gibt den Dateinamen des Dumps an.
--crashdump-type	Gibt den Typ des Dumps an. Gültige Werte sind Mini, Heap, Triage, Full. Standardwert: Full. Weitere Informationen finden Sie unter Arten von Minidumps.

Vorsicht

Die Erweiterung ist nicht kompatibel mit .NET Framework und wird automatisch ignoriert. Für .NET Framework-Unterstützung aktivieren Sie das Postmortem-Debugging mit Sysinternals ProcDump. Weitere Informationen finden Sie unter Aktivieren des Postmortem-Debuggings: Window Sysinternals ProcDump. Die Postmortem-Debuglösung sammelt auch Prozessabsturzinformationen für .NET, sodass Sie die Verwendung der Erweiterung vermeiden können, wenn Sie sowohl auf .NET- als auch .NET Framework-Testanwendungen abzielen.

Absturzabbild

Mit dieser Erweiterung können Sie nach einem bestimmten Timeout eine Abbilddatei erstellen. Diese Erweiterung wird als Teil des Pakets "Microsoft.Testing.Extensions.HangDump " ausgeliefert.

Verwenden Sie die folgenden Optionen, um die Generierung der Abbilddatei bei Nichtreagieren zu konfigurieren:

Auswahlmöglichkeit	BESCHREIBUNG
--hangdump	Generiert eine Speicherabbilddatei, falls der Testhostprozess hängen bleibt.
-⁠-hangdump-filename	Gibt den Dateinamen des Dumps an.
--hangdump-timeout	Gibt das Timeout an, nach dem das Absturzabbild generiert wird. Der Timeoutwert wird in einem der folgenden Formate angegeben: 1.5h, 1.5hour1.5hours 90m 90min 90minute 90minutes 5400s, 5400sec, , 5400second5400seconds. Standardwert: 30m (30 Minuten).
--hangdump-type	Gibt den Typ des Dumps an. Gültige Werte sind Mini, Heap, Triage, Full. Standardwert: Full. Weitere Informationen finden Sie unter Arten von Minidumps.