Partilhar via

Extensões de diagnóstico

  • Artigo

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

Opções incorporadas

As seguintes opções de plataforma fornecem as informações úteis para solucionar problemas das suas aplicações 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:

Nome da variável de ambiente Descrição
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, Errorou Critical.
TESTINGPLATFORM_DIAGNOSTIC_OUTPUT_DIRECTORY O diretório de saída do log de diagnóstico, se não for especificado, o arquivo é gerado no diretório TestResults padrão.
TESTINGPLATFORM_DIAGNOSTIC_OUTPUT_FILEPREFIX O prefixo do nome do ficheiro 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.

Observação

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

Relatório de falha

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 é disponibilizado com a biblioteca Microsoft .NET de código fechado num modelo de licenciamento gratuito para uso.

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

Opção Descrição
--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 despejo. Os valores válidos são Mini, Heap, Triage, Full. Padrão 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, ativa-se a depuração post-mortem com o Sysinternals ProcDump. Para obter mais informações, consulte Ativando a depuração postmortem: Windows Sysinternals ProcDump. A solução de depuração postmortem também recolherá informações sobre falha de processo para o .NET, para que possa evitar o uso da extensão se estiver a direcionar aplicativos de teste para .NET e .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 Descrição
--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 timeout após o qual o dump é 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. Por padrão, é 30m (30 minutos).
--hangdump-type Especifica o tipo de despejo. Os valores válidos são Mini, Heap, Triage, Full. Definições padrão como Full. Para obter mais informações, consulte Tipos de minidespejos.