Estensioni di diagnostica

Questo articolo elenca e illustra tutte le estensioni Microsoft.Testing.Platform correlate alla funzionalità di diagnostica.

Opzioni predefinite

Le opzioni della piattaforma seguenti forniscono informazioni utili per la risoluzione dei problemi delle app di test:

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

È anche possibile abilitare i log di diagnostica usando le variabili di ambiente:

Nome variabile di ambiente	Descrizione
TESTINGPLATFORM_DIAGNOSTIC	Se impostato su 1, abilita la registrazione diagnostica.
TESTINGPLATFORM_DIAGNOSTIC_VERBOSITY	Definisce il livello di verbosità. I valori disponibili sono Trace, Debug, Information, Warning, Erroro Critical.
TESTINGPLATFORM_DIAGNOSTIC_OUTPUT_DIRECTORY	La directory di output per la registrazione diagnostica, se non specificata, è generata nella directory predefinita TestResults.
TESTINGPLATFORM_DIAGNOSTIC_OUTPUT_FILEPREFIX	Prefisso per il nome del file di log. Il valore predefinito è "log_".
TESTINGPLATFORM_DIAGNOSTIC_FILELOGGER_SYNCHRONOUSWRITE	Forza il logger di file predefinito a scrivere i log in modo sincrono. Utile per le situazioni in cui non si vogliono perdere registrazioni di log (se il processo si arresta in modo anomalo). Ciò rallenta l'esecuzione del test.

Nota

Le variabili di ambiente hanno la precedenza sugli argomenti della riga di comando.

Dump di arresto anomalo del sistema

Questa estensione consente di creare un file di dump in caso di arresto anomalo del processo. Questa estensione viene fornita come parte del pacchetto NuGet Microsoft.Testing.Extensions.CrashDump.

Per configurare la generazione del file dump, usare le opzioni seguenti:

Opzione	Descrizione
--crashdump	Genera un file dump quando il processo host di test si arresta in modo anomalo. Supportato in .NET 6.0+.
⁠-⁠-⁠crashdump-⁠filename	Specifica il nome file del dump.
--crashdump-type	Specifica il tipo di scarico. I valori validi sono Mini, Heap, Triage, Full. Il valore predefinito è Full. Per maggiori dettagli, vedere Tipi di mini dump.

Cautela

L'estensione non è compatibile con .NET Framework e verrà ignorata automaticamente. Per il supporto di .NET Framework, è possibile abilitare il debug postmortem con Sysinternals ProcDump. Per ulteriori informazioni, vedere Abilitazione del debug postmortem con Windows Sysinternals ProcDump. La soluzione di debug postmortem raccoglierà anche informazioni sull'arresto anomalo del processo per .NET, in modo da evitare l'uso dell'estensione se si usano applicazioni di test .NET e .NET Framework.

Dump di sistema bloccato

Questa estensione consente di creare un file di dump dopo un determinato timeout. Questa estensione viene fornita come parte di pacchetto Microsoft.Testing.Extensions.HangDump.

Per configurare la generazione del file hang dump, usare le opzioni seguenti:

Opzione	Descrizione
--hangdump	Genera un file di dump nel caso in cui il processo host di test si blocchi.
-⁠-hangdump-filename	Specifica il nome file del dump.
--hangdump-timeout	Specifica il timeout dopo il quale viene generato il dump. Il valore di timeout viene specificato in uno dei formati seguenti: 1.5h, 1.5hour, 1.5hours 90m, 90min, 90minute90minutes 5400s, 5400sec, 5400second5400seconds. Il valore predefinito è 30m (30 minuti).
--hangdump-type	Specifica il tipo di scarico. I valori validi sono Mini, Heap, Triage, Full. Il valore predefinito è Full. Per maggiori dettagli, vedere Tipi di mini dump.