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 détail. 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 si le processus se bloque. Cette extension est fournie dans le cadre du package NuGet Microsoft.Testing.Extensions.CrashDump .

Important

Le package est fourni avec la bibliothèque Microsoft .NET sous un modèle de licence gratuit à utiliser et à source fermée.

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 de fichier du vidage.
--crashdump-type	Spécifie le type du vidage. Les valeurs valides sont Mini, , HeapTriage, Full. Valeurs par défaut en tant que 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 postmortem avec Sysinternals ProcDump. Pour plus d’informations, consultez Activation du débogage postmortem : Window 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.

Vider le vidage

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

Important

Le package est fourni avec la bibliothèque Microsoft .NET sous un modèle de licence gratuit à utiliser et à source fermée.

Pour configurer la génération de fichiers de vidage de blocage, 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 de fichier du 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, , 90min90minute, ,90minutes 5400s, 5400sec, 5400second, 5400seconds. La valeur par défaut est 30m (30 minutes).
--hangdump-type	Spécifie le type du vidage. Les valeurs valides sont Mini, , HeapTriage, Full. Valeurs par défaut en tant que Full. Pour plus d’informations, consultez Types de mini-images mémoire.