Partilhar via

Extensões de diagnóstico

  • Artigo

Este artigo lista e explica todas as Microsoft Testing Platform extensões relacionadas ao recurso de diagnóstico.

Opções incorporadas

As seguintes opções de plataforma fornecem informações úteis para solucionar problemas de seus aplicativos de teste:

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

Você também pode habilitar os logs de diagnóstico usando as variáveis de ambiente:

Environment variable name Description
TESTINGPLATFORM_DIAGNOSTIC Se definido como 1, habilita o log de diagnóstico.
TESTINGPLATFORM_DIAGNOSTIC_VERBOSITY Define o nível de verbosidade. Os valores disponíveis são Trace, Debug, Information, Warning, Error, ou Critical.
TESTINGPLATFORM_DIAGNOSTIC_OUTPUT_DIRECTORY O diretório de saída do log de diagnóstico, se não especificado o arquivo é gerado no diretório TestResults padrão.
TESTINGPLATFORM_DIAGNOSTIC_OUTPUT_FILEPREFIX O prefixo do nome do arquivo de log. O padrão é "log_".
TESTINGPLATFORM_DIAGNOSTIC_FILELOGGER_SYNCHRONOUSWRITE Força o registrador de arquivos interno a gravar logs de forma síncrona. Útil para cenários em que você não deseja perder nenhuma entrada de log (se o processo falhar). Isso torna mais lenta a execução do teste.

Nota

As variáveis de ambiente têm precedência sobre os argumentos de linha de comando.

Despejo de memória

Esta extensão permite que você crie um arquivo de despejo de memória se o processo falhar. Esta extensão é fornecida como parte do pacote NuGet Microsoft.Testing.Extensions.CrashDump.

Importante

O pacote é fornecido com a biblioteca Microsoft .NET de código fechado livre para usar o modelo de licenciamento.

Para configurar a geração do arquivo de despejo de falha, use as seguintes opções:

Opção Description
--crashdump Gera um arquivo de despejo quando o processo do host de teste falha. Suportado no .NET 6.0+.
⁠-⁠-⁠crashdump-⁠filename Especifica o nome do arquivo do dump.
--crashdump-type Especifica o tipo de dump. Os valores válidos são Mini, Heap, Triage, Full. Padrões como Full. Para obter mais informações, consulte Tipos de mini dumps.

Atenção

A extensão não é compatível com o .NET Framework e será silenciosamente ignorada. Para suporte ao .NET Framework, você habilita a depuração postmortem com Sysinternals ProcDump. Para obter mais informações, consulte Ativando a depuração Postmortem: Window Sysinternals ProcDump. A solução de depuração postmortem também coletará informações de falha de processo para o .NET para que você possa evitar o uso da extensão se estiver direcionando aplicativos de teste do .NET e do .NET Framework.

Pendurar despejo

Esta extensão permite que você crie um arquivo de despejo após um determinado tempo limite. Esta extensão é fornecida como parte do pacote Microsoft.Testing.Extensions.HangDump .

Importante

O pacote é fornecido com a biblioteca Microsoft .NET de código fechado livre para usar o modelo de licenciamento.

Para configurar a geração do arquivo de despejo suspenso, use as seguintes opções:

Opção Description
--hangdump Gera um arquivo de despejo caso o processo do host de teste trave.
-⁠-⁠hangdump-⁠filename Especifica o nome do arquivo do dump.
--hangdump-timeout Especifica o tempo limite após o qual o despejo é gerado. O valor de tempo limite é especificado em um dos seguintes formatos:
1.5h, 1.5hour, 1.5hours
90m, 90min, 90minute, 90minutes
5400s, 5400sec, 5400second, 5400seconds. O padrão é ( 30m 30 minutos).
--hangdump-type Especifica o tipo de dump. Os valores válidos são Mini, Heap, Triage, Full. Padrões como Full. Para obter mais informações, consulte Tipos de mini dumps.