Diagnoseerweiterungen

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

Integrierte Optionen

Die folgenden Plattformoptionen liefern nützliche Informationen zur Problembehandlung Ihrer Testanwendungen:

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

Sie können die Diagnoseprotokolle auch über die Umgebungsvariablen aktivieren:

Environment variable name	Beschreibung
TESTINGPLATFORM_DIAGNOSTIC	Wird diese Option auf 1 festgelegt, 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 die integrierte Dateiprotokollierung, 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 Microsoft.Testing.Extensions.CrashDump-NuGet-Pakets ausgeliefert.

Wichtig

Das Paket wird mit der geschlossenen Quelle von Microsoft .NET Library und dem kostenlosen Lizenzierungsmodell ausgeliefert.

Verwenden Sie die folgenden Optionen, um die Generierung der Absturzabbilddateien zu konfigurieren:

Option	Beschreibung
--crashdump	Generiert eine Absturzabbilddatei, wenn der Testhostprozess abstürzt. Unterstützt in .NET 6.0+.
⁠-⁠-⁠crashdump-⁠filename	Dient zum Angeben des Dateinamens des Absturzabbilds.
--crashdump-type	Gibt den Typ des Absturzabbilds an. Gültige Werte sind Mini, Heap, Triage, Full. Standardwert: Full. Weitere Informationen finden Sie unter Arten von Minidumps.

Achtung

Die Erweiterung ist nicht kompatibel mit .NET Framework und wird still 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-Debugging-Lö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 Microsoft.Testing.Extensions.HangDump-Pakets ausgeliefert.

Wichtig

Das Paket wird mit der geschlossenen Quelle von Microsoft .NET Library und dem kostenlosen Lizenzierungsmodell ausgeliefert.

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

Option	Beschreibung
--hangdump	Generiert eine Speicherabbilddatei, falls der Testhostprozess nicht mehr reagiert.
-⁠-⁠hangdump-⁠filename	Dient zum Angeben des Dateinamens des Absturzabbilds.
--hangdump-timeout	Gibt das Timeout an, nach dem das Absturzabbild generiert wird. Der Timeoutwert wird in einem der folgenden Formate angegeben: 1.5h, 1.5hour, 1.5hours 90m, 90min, 90minute, 90minutes 5400s, 5400sec, 5400second, 5400seconds. Standardwert: 30m (30 Minuten).
--hangdump-type	Gibt den Typ des Absturzabbilds an. Gültige Werte sind Mini, Heap, Triage, Full. Standardwert: Full. Weitere Informationen finden Sie unter Arten von Minidumps.