Ekstensi diagnostik

Artikel ini mencantumkan dan menjelaskan semua ekstensi Microsoft.Testing.Platform yang terkait dengan kemampuan diagnostik.

Opsi bawaan

Opsi platform berikut memberikan informasi yang berguna untuk memecahkan masalah aplikasi pengujian Anda:

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

Anda juga dapat mengaktifkan log diagnostik menggunakan variabel lingkungan:

Nama variabel lingkungan	Deskripsi
TESTINGPLATFORM_DIAGNOSTIC	Jika diatur ke 1, mengaktifkan pembuatan log diagnostik.
TESTINGPLATFORM_DIAGNOSTIC_VERBOSITY	Menentukan tingkat verbositas. Nilai yang tersedia adalah Trace, Debug, Information, Warning, Error, atau Critical.
TESTINGPLATFORM_DIAGNOSTIC_OUTPUT_DIRECTORY	Direktori output pencatatan log diagnostik, jika tidak ditentukan, file dihasilkan dalam direktori default TestResults.
TESTINGPLATFORM_DIAGNOSTIC_OUTPUT_FILEPREFIX	Awalan untuk nama file log. Mengatur default ke "log_".
TESTINGPLATFORM_DIAGNOSTIC_FILELOGGER_SYNCHRONOUSWRITE	Memaksa pencatat file bawaan untuk menulis log secara sinkron. Berguna untuk skenario di mana Anda tidak ingin kehilangan entri log apa pun (jika proses crash). Ini memperlambat eksekusi pengujian.

Nota

Variabel lingkungan lebih diutamakan daripada argumen baris perintah.

File hasil pembuangan

Ekstensi ini memungkinkan Anda membuat file crash dump jika proses mengalami crash. Ekstensi ini dikirim sebagai bagian dari paket Microsoft.Testing.Extensions.CrashDump NuGet.

Untuk mengonfigurasi pembuatan file crash dump, gunakan opsi berikut:

Pilihan	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 dump 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 pasca kejadian juga akan mengumpulkan informasi tentang kegagalan proses untuk .NET sehingga Anda dapat menghindari penggunaan ekstensi jika Anda menargetkan aplikasi uji .NET maupun .NET Framework.

Pembuangan memori saat hang

Ekstensi ini memungkinkan Anda membuat file cadangan setelah batas waktu tertentu. Ekstensi ini dikirim sebagai bagian dari paket Microsoft.Testing.Extensions.HangDump.

Untuk mengonfigurasi pembuatan file hang dump, gunakan opsi berikut:

Pilihan	Deskripsi
--hangdump	Menghasilkan file cadangan jika proses host pengujian macet.
-⁠-hangdump-filename	Menentukan nama file cadangan.
--hangdump-timeout	Menentukan batas waktu setelah dump dihasilkan. Nilai batas waktu ditentukan dalam salah satu format berikut: 1.5h, , 1.5hour1.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 dump mini.