Condividi tramite

Estensioni di diagnostica

  • Articolo

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:

Environment variable name Descrizione
TESTINGPLATFORM_DIAGNOSTIC Se impostato su 1, abilita la registrazione diagnostica.
TESTINGPLATFORM_DIAGNOSTIC_VERBOSITY Definisce il livello di dettaglio. I valori disponibili sono Trace, Debug, Information, Warning, Erroro Critical.
TESTINGPLATFORM_DIAGNOSTIC_OUTPUT_DIRECTORY La directory di output della registrazione diagnostica. Se non specificato, il file viene generato nella directory predefinita TestResults.
TESTINGPLATFORM_DIAGNOSTIC_OUTPUT_FILEPREFIX Il prefisso del nome del file di log. Il valore predefinito è "log_".
TESTINGPLATFORM_DIAGNOSTIC_FILELOGGER_SYNCHRONOUSWRITE Forza il logger di file integrato a scrivere i log in modo sincrono. Utile per gli scenari in cui non si vuole perdere nessuna voce di registro (se il processo si arresta in modo anomalo). In questo modo viene rallentata l'esecuzione dei 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 di arresto anomalo in caso di arresto anomalo del processo. Questa estensione viene fornita come parte del pacchetto NuGet Microsoft.Testing.Extensions.CrashDump.

Importante

Il pacchetto viene fornito gratuitamente con la libreria Microsoft .NET free per l'uso del modello di licenza.

Per configurare la generazione del file di dump di arresto anomalo del sistema, usare le opzioni seguenti:

Opzione Descrizione
--crashdump Genera un file dump quando il processo host del 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 dump. I valori validi sono Mini, Heap, Triage, Full. Il valore predefinito è Full. Per altre informazioni, vedere Tipi di mini dump.

Attenzione

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 altre informazioni, vedere Abilitazione del debug postmortem: Finestra 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 blocco

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

Importante

Il pacchetto viene fornito gratuitamente con la libreria Microsoft .NET free per l'uso del modello di licenza.

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, 90minute, 90minutes
5400s, 5400sec, 5400second, 5400seconds. Il valore predefinito è 30m (30 minuti).
--hangdump-type Specifica il tipo di dump. I valori validi sono Mini, Heap, Triage, Full. Il valore predefinito è Full. Per altre informazioni, vedere Tipi di mini dump.