Compartilhar via


Despejos de travamento e travamento

Esses recursos exigem a instalação de pacotes NuGet adicionais, conforme descrito em cada seção.

Dica

Ao usar o Microsoft.Testing.Platform.MSBuild (incluído transitivamente por MSTest, NUnit e xUnit runners), essas extensões são registradas automaticamente quando você instala seus pacotes NuGet , sem necessidade de alterações de código. O registro manual especificado neste artigo só será necessário se você desabilitar o ponto de entrada gerado automaticamente definindo <GenerateTestingPlatformEntryPoint>false</GenerateTestingPlatformEntryPoint>.

Despejo de memória

Essa extensão permite que você crie um arquivo de despejo de memória se o processo falhar. Essa extensão requer o pacote NuGet Microsoft.Testing.Extensions.CrashDump .

Registro manual

var builder = await TestApplication.CreateBuilderAsync(args);
builder.TestHostControllers.AddCrashDumpProvider();

Opções

Opção DESCRIÇÃO
--crashdump Gera um arquivo de despejo quando o processo de host de teste falha. Com suporte no .NET 6.0+.
⁠-⁠-⁠crashdump-⁠filename Especifica o nome do arquivo do despejo.
--crashdump-type Especifica o tipo do despejo. Os valores válidos são Mini, Heap, Triage, Full. O padrão é Full. Para obter mais informações, confira Tipos de mini despejos.

Cuidado

A extensão não é compatível com .NET Framework e será ignorada silenciosamente. Para suporte ao .NET Framework, habilite a depuração post mortem com o Sysinternals ProcDump. Para obter mais informações, consulte Ativando a Depuração Post-mortem: Window Sysinternals ProcDump. A solução de depuração pós-morte também coletará informações sobre falhas de processo para .NET, permitindo que você evite o uso da extensão ao direcionar aplicativos de teste para ambos .NET e .NET Framework.

Despejo de travamento

Essa extensão permite que você crie um arquivo de despejo após um determinado tempo limite. Essa extensão requer o pacote NuGet Microsoft.Testing.Extensions.HangDump .

Registro manual

var builder = await TestApplication.CreateBuilderAsync(args);
builder.TestHostControllers.AddHangDumpProvider();

Opções

Opção DESCRIÇÃO
--hangdump Gera um arquivo de despejo caso o processo de host de teste se encontre travado.
-⁠-hangdump-filename Especifica o nome do arquivo do despejo.
--hangdump-timeout Especifica a duração de inatividade após a qual o despejo é gerado. O valor do tempo limite é especificado em um dos seguintes formatos:
1.5h, 1.5hour, 1.5hours
90m, 90min, , 90minute90minutes
5400s, 5400sec, 5400second. 5400seconds O padrão é 30m (30 minutos).
--hangdump-type Especifica o tipo do despejo. Os valores válidos são Mini, Heap, Triage, Full. O padrão é Full. Para obter mais informações, confira Tipos de mini despejos.