Compartir a través de

Extensión Diagnostics

  • Artículo

En esta lista de artículos se explican todas las extensiones de 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:

Environment variable name Descripción
TESTINGPLATFORM_DIAGNOSTIC Si se establece en 1, habilita el registro de diagnóstico.
TESTINGPLATFORM_DIAGNOSTIC_VERBOSITY Define el nivel de detalle. Los valores disponibles son Trace, Debug, Information, Warning, Error o Critical.
TESTINGPLATFORM_DIAGNOSTIC_OUTPUT_DIRECTORY El directorio de salida del registro de diagnóstico; si no se especifica, el archivo se genera 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.

Importante

El paquete se incluye con la biblioteca de Microsoft .NET de código cerrado gratuito para usar el modelo de licencias.

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.

Precaución

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 Microsoft.Testing.Extensions.HangDump.

Importante

El paquete se incluye con la biblioteca de Microsoft .NET de código cerrado gratuito para usar el modelo de licencias.

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.