Extensions de diagnostic

Cet article répertorie et décrit toutes les extensions Microsoft.Testing.Platform liées à la fonctionnalité de diagnostic.

Options intégrées

Les options de plateforme suivantes fournissent des informations utiles pour résoudre les problèmes de vos applications de test :

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

Vous pouvez également activer les journaux de diagnostic à l’aide des variables d’environnement :

Nom de la variable d’environnement	Descriptif
TESTINGPLATFORM_DIAGNOSTIC	Si la valeur est définie 1, active la journalisation des diagnostics.
TESTINGPLATFORM_DIAGNOSTIC_VERBOSITY	Définit le niveau de verbosité. Les valeurs disponibles sont Trace, Debug, Information, Warning, Error ou Critical.
TESTINGPLATFORM_DIAGNOSTIC_OUTPUT_DIRECTORY	Le répertoire de sortie de la journalisation des diagnostics, s’il n’est pas spécifié, le fichier est généré dans le répertoire TestResults par défaut.
TESTINGPLATFORM_DIAGNOSTIC_OUTPUT_FILEPREFIX	Préfixe du nom de fichier journal. La valeur par défaut est "log_".
TESTINGPLATFORM_DIAGNOSTIC_FILELOGGER_SYNCHRONOUSWRITE	Permet d'imposer au journalisateur de fichiers intégré d'écrire les logs synchronement. Utile pour les scénarios où vous ne souhaitez perdre aucune entrée de journal (si le processus se bloque). Cela ralentit l’exécution de tests.

Remarque

Les variables d’environnement sont prioritaires sur les arguments de ligne de commande.

Vidage sur incident

Cette extension vous permet de créer un fichier de vidage sur incident en cas de blocage du processus. Cette extension est fournie dans le cadre du package NuGet Microsoft.Testing.Extensions.CrashDump .

Pour configurer la génération du fichier de vidage sur incident, utilisez les options suivantes :

Choix	Descriptif
--crashdump	Génère un fichier de vidage lorsque le processus hôte de test se bloque. Prise en charge dans .NET 6.0+.
⁠-⁠-⁠crashdump-⁠filename	Spécifie le nom du fichier de vidage.
--crashdump-type	Spécifie le type de vidage. Les valeurs valides sont Mini, , HeapTriage, Full. Défini par défaut comme Full. Pour plus d’informations, consultez Types de mini-images mémoire.

Avertissement

L’extension n’est pas compatible avec .NET Framework et est ignorée en mode silencieux. Pour la prise en charge de .NET Framework, vous activez le débogage post-mortem avec Sysinternals ProcDump. Pour plus d’informations, consultez Activation du débogage post-mortem : Windows Sysinternals ProcDump. La solution de débogage postmortem collecte également des informations sur les incidents de processus pour .NET afin de pouvoir éviter l’utilisation de l’extension si vous ciblez à la fois les applications de test .NET et .NET Framework.

Vidage sur blocage

Cette extension vous permet de créer un fichier de vidage après un délai d’attente donné. Cette extension est fournie dans le cadre du package Microsoft.Testing.Extensions.HangDump .

Pour configurer la génération du fichier de blocage sur incident, utilisez les options suivantes :

Choix	Descriptif
--hangdump	Génère un fichier de vidage au cas où le processus hôte de test se bloque.
-⁠-hangdump-filename	Spécifie le nom du fichier de vidage.
--hangdump-timeout	Spécifie le délai d’expiration après lequel le vidage est généré. La valeur du délai d’expiration est spécifiée dans l’un des formats suivants : 1.5h 1.5hour 1.5hours 90m, 90min, 90minute, 90minutes 5400s, 5400sec5400second, 5400seconds. La valeur par défaut est 30m (30 minutes).
--hangdump-type	Spécifie le type de vidage. Les valeurs valides sont Mini, , HeapTriage, Full. Défini par défaut comme Full. Pour plus d’informations, consultez Types de mini-images mémoire.