Partager via

Les extensions de diagnostic

  • Article

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 en utilisant les variables d’environnement :

Environment variable name Description
TESTINGPLATFORM_DIAGNOSTIC Permet la journalisation des diagnostics, si la valeur est définie sur 1.
TESTINGPLATFORM_DIAGNOSTIC_VERBOSITY Permet de définir 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 de forcer l’enregistreur d’événements de fichiers intégré à écrire des journaux de manière synchrone. 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.

Image mémoire après incident

Cette extension vous permet de créer un fichier d’image mémoire 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 le modèle gratuit de licence propriétaire de la bibliothèque Microsoft .NET.

Pour configurer la génération de fichiers d’image mémoire sur incident, utilisez les options suivantes :

Option Description
--crashdump Permet de générer un fichier d’image mémoire 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 l’image mémoire.
--crashdump-type Spécifie le type d’image mémoire. Les valeurs valides sont Mini, Heap, Triage, Full. A la valeur par défaut Full. Pour plus d’informations, consultez Types de mini-images mémoire.

Attention

L’extension n’est pas compatible avec .NET Framework et sera ignorée en silence. 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 : Window Sysinternals ProcDump. La solution de débogage post-mortem recueillera également des informations sur les plantages de processus pour .NET, ce qui vous permettra d'éviter l'utilisation de l'extension si vous ciblez à la fois des applications de test .NET et .NET Framework.

Image mémoire d’une application à l’arrêt

Cette extension vous permet de créer un fichier d’image mémoire 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 le modèle gratuit de licence propriétaire de la bibliothèque Microsoft .NET.

Pour configurer la génération de fichiers d’image mémoire sur blocage, utilisez les options suivantes :

Option Description
--hangdump Génère un fichier d’image mémoire au cas où le processus hôte de test se bloque.
-⁠-⁠hangdump-⁠filename Spécifie le nom du fichier de l’image mémoire.
--hangdump-timeout Spécifie le délai d’expiration après lequel l’image mémoire est générée. 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, 5400sec, 5400second, 5400seconds. La valeur par défaut est 30m (30 minutes).
--hangdump-type Spécifie le type d’image mémoire. Les valeurs valides sont Mini, Heap, Triage, Full. A la valeur par défaut Full. Pour plus d’informations, consultez Types de mini-images mémoire.