Crash dan hang pembuangan

Fitur-fitur ini memerlukan penginstalan paket NuGet tambahan, seperti yang dijelaskan di setiap bagian.

Petunjuk / Saran

Saat menggunakan Microsoft.Testing.Platform.MSBuild (disertakan secara transitif oleh runner MSTest, NUnit, dan xUnit), ekstensi ini didaftarkan secara otomatis saat Anda menginstal paket NuGet mereka — tidak ada perubahan kode yang diperlukan. Pendaftaran manual yang ditentukan dalam artikel ini hanya diperlukan jika Anda menonaktifkan titik masuk yang dihasilkan secara otomatis dengan mengatur <GenerateTestingPlatformEntryPoint>false</GenerateTestingPlatformEntryPoint>.

File hasil pembuangan

Ekstensi ini memungkinkan Anda membuat file crash dump jika proses mengalami crash. Ekstensi ini memerlukan paket NuGet Microsoft.Testing.Extensions.CrashDump .

Pendaftaran manual

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

Opsi

Option	Deskripsi
--crashdump	Menghasilkan file cadangan saat proses host pengujian mengalami crash. Didukung di .NET 6.0+.
⁠-⁠-⁠crashdump-⁠filename	Menentukan nama file cadangan.
--crashdump-type	Menentukan jenis luwapan. Nilai yang valid adalah Mini, Heap, Triage, Full. Default adalah Full. Untuk informasi selengkapnya, lihat Jenis pembuangan mini.

Perhatian

Ekstensi tidak kompatibel dengan .NET Framework dan akan diabaikan secara diam-diam. Untuk dukungan .NET Framework, Anda mengaktifkan debugging postmortem dengan Sysinternals ProcDump. Untuk informasi selengkapnya, lihat Mengaktifkan Debugging Postmortem: Window Sysinternals ProcDump. Solusi penelusuran kesalahan postmortem juga akan mengumpulkan informasi crash proses untuk .NET sehingga Anda dapat menghindari penggunaan ekstensi jika Anda menargetkan aplikasi pengujian .NET dan .NET Framework.

Pembuangan memori saat hang

Ekstensi ini memungkinkan Anda membuat file cadangan setelah batas waktu tertentu. Ekstensi ini memerlukan paket NuGet Microsoft.Testing.Extensions.HangDump .

Pendaftaran manual

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

Opsi

Option	Deskripsi
--hangdump	Menghasilkan file cadangan jika proses host pengujian macet.
-⁠-hangdump-filename	Menentukan nama file cadangan.
--hangdump-timeout	Menentukan durasi tidak ada aktivitas setelah pembuangan dihasilkan. Nilai batas waktu ditentukan dalam salah satu format berikut: 1.5h, 1.5hour, 1.5hours 90m,90min,90minute,90minutes 5400s, 5400sec, 5400second, 5400seconds Secara default disetel ke 30m (30 menit).
--hangdump-type	Menentukan jenis luwapan. Nilai yang valid adalah Mini, Heap, Triage, Full. Default adalah Full. Untuk informasi selengkapnya, lihat Jenis pembuangan mini.