Extensiones de diagnóstico

En este artículo se enumeran y explican todas las extensiones Microsoft.Testing.Platform relacionadas con la funcionalidad de diagnóstico.

Opciones integradas

Las siguientes opciones de plataforma proporcionan información útil para solucionar problemas de las aplicaciones de prueba:

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

También puede habilitar los registros de diagnóstico mediante las variables de entorno:

Nombre de la variable de entorno	Descripción
TESTINGPLATFORM_DIAGNOSTIC	Si se establece en 1, habilita el registro de diagnóstico.
TESTINGPLATFORM_DIAGNOSTIC_VERBOSITY	Define el nivel de verbosidad. Los valores disponibles son Trace, Debug, Information, Warning, Erroro Critical.
TESTINGPLATFORM_DIAGNOSTIC_OUTPUT_DIRECTORY	Directorio de salida del registro de diagnóstico, si no se especifica que el archivo se genere en el directorio predeterminado TestResults.
TESTINGPLATFORM_DIAGNOSTIC_OUTPUT_FILEPREFIX	Prefijo del nombre del archivo de registro. Tiene como valor predeterminado "log_".
TESTINGPLATFORM_DIAGNOSTIC_FILELOGGER_SYNCHRONOUSWRITE	Obliga al registrador de archivos integrado a escribir registros de forma sincrónica. Resulta útil para escenarios en los que no desea perder ninguna entrada de registro (si el proceso se bloquea). Esto ralentiza la ejecución de la prueba.

Nota

Las variables de entorno tienen prioridad sobre los argumentos de la línea de comandos.

Volcado de memoria

Esta extensión permite crear un archivo de volcado de memoria si el proceso se bloquea. Esta extensión se incluye como parte del paquete NuGet Microsoft.Testing.Extensions.CrashDump.

Para configurar la generación de archivos de volcado de memoria, use las siguientes opciones:

Opción	Descripción
--crashdump	Genera un archivo de volcado cuando el proceso de host de prueba se bloquea. Compatible con .NET 6.0 y versiones posteriores.
⁠-⁠-⁠crashdump-⁠filename	Especifica el nombre de archivo del volcado de memoria.
--crashdump-type	Especifica el tipo del volcado de memoria. Los valores válidos son Mini, Heap, Triage, Full. El valor predeterminado es Full. Para obtener más información, consulte Tipos de minivolcados.

Cautela

La extensión no es compatible con .NET Framework y se omitirá silenciosamente. Para obtener compatibilidad con .NET Framework, habilite la depuración postmortem con ProcDump de Sysinternals. Para obtener más información, consulte Habilitación de la depuración postmortem: Ventana Sysinternals ProcDump. La solución de depuración postmortem también recopilará información de bloqueo de procesos para .NET para que pueda evitar el uso de la extensión si tiene como destino aplicaciones de prueba de .NET y .NET Framework.

Volcado de memoria de bloqueo

Esta extensión le permite crear un archivo de volcado después de un tiempo de espera determinado. Esta extensión se envía como parte del paquete de Microsoft.Testing.Extensions.HangDump.

Para configurar la generación de archivos de volcado de memoria, use las siguientes opciones:

Opción	Descripción
--hangdump	Genera un archivo de volcado en caso de que el proceso de host de prueba se bloquee.
-⁠-hangdump-filename	Especifica el nombre de archivo del volcado de memoria.
--hangdump-timeout	Especifica el tiempo de espera después del cual se genera el volcado de memoria. El valor de tiempo de espera se especifica en uno de los siguientes formatos: 1.5h, , 1.5hour, 1.5hours 90m, 90min, , 90minute, 90minutes 5400s, 5400sec, 5400second, 5400seconds. El valor predeterminado es 30m (30 minutos).
--hangdump-type	Especifica el tipo del volcado de memoria. Los valores válidos son Mini, Heap, Triage, Full. El valor predeterminado es Full. Para obtener más información, consulte Tipos de minivolcados.