Tanılama uzantıları

Bu makalede tanılama özelliğiyle ilgili tüm Microsoft.Testing.Platform uzantıları listelenir ve açıklanır.

Yerleşik seçenekler

Aşağıdaki platform seçenekleri test uygulamalarınızla ilgili sorunları gidermek için yararlı bilgiler sağlar:

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

Tanılama günlüklerini ortam değişkenlerini kullanarak da etkinleştirebilirsiniz:

Ortam değişkeni adı	Açıklama
TESTINGPLATFORM_DIAGNOSTIC	1olarak ayarlanırsa, tanılama günlüğünü etkinleştirir.
TESTINGPLATFORM_DIAGNOSTIC_VERBOSITY	Ayrıntı düzeyini tanımlar. Kullanılabilir değerler Trace, Debug, Information, Warning, Errorveya Critical' dır.
TESTINGPLATFORM_DIAGNOSTIC_OUTPUT_DIRECTORY	Tanılama günlüğünün çıkış dizini belirtilmezse, dosya varsayılan TestResults dizininde oluşturulur.
TESTINGPLATFORM_DIAGNOSTIC_OUTPUT_FILEPREFIX	Günlük dosyası adının ön eki. Varsayılan değer "log_"'dur.
TESTINGPLATFORM_DIAGNOSTIC_FILELOGGER_SYNCHRONOUSWRITE	Yerleşik dosya günlükçüsüsünü zaman uyumlu bir şekilde günlükleri yazmaya zorlar. İşlem çökerse günlük girdilerini kaybetmek istemediğiniz senaryolar için kullanışlıdır. Bu, test yürütmeyi yavaşlatır.

Not

Ortam değişkenleri, komut satırı bağımsız değişkenlerinden önceliklidir.

Çökme dökümü

Bu uzantı, işlem çökerse bir çökme dökümü dosyası oluşturmanıza olanak tanır. Bu uzantı, Microsoft.Testing.Extensions.CrashDump NuGet paketinin bir parçası olarak gönderilir.

Çökme dökümü dosyası oluşturmayı yapılandırmak için aşağıdaki seçenekleri kullanın:

Seçenek	Açıklama
--crashdump	Test barındırıcı süreci kilitlendiğinde bir döküm dosyası oluşturur. .NET 6.0+ ile desteklenir.
⁠-⁠-⁠crashdump-⁠filename	Hata dökümü dosyasının adını belirtir.
--crashdump-type	Döküm türünü belirtir. Geçerli değerler Mini, Heap, TriageFull. varsayılan olarak Full. Daha fazla bilgi için bkz. Mini Dumplar Türleri.

Dikkat

Uzantı .NET Framework ile uyumlu değildir ve fark edilmeyecek şekilde göz ardı edilir. .NET Framework desteği için Sysinternals ProcDump ile postmortem hata ayıklamasını etkinleştirirsiniz. Daha fazla bilgi için bkz. Postmortem Debugging'i Etkinleştirme: Windows Sysinternals ProcDump. Hem .NET hem de .NET Framework test uygulamalarını hedef alıyorsanız uzantının kullanımından kaçınabilmeniz için, otopsi sonrası hata ayıklama çözümü .NET için işlem kilitlenme bilgilerini de toplar.

Kilitlenme dökümü

Bu uzantı, belirli bir zaman aşımının ardından döküm dosyası oluşturmanıza olanak tanır. Bu uzantı, Microsoft.Testing.Extensions.HangDump paketinin bir parçası olarak gönderilir.

Askı dökümü dosyası üretimini yapılandırmak için aşağıdaki seçenekleri kullanın:

Seçenek	Açıklama
--hangdump	Test ana bilgisayar işleminin kilitlenmesi durumunda bir döküm dosyası oluşturur.
-⁠-hangdump-filename	Hata dökümü dosyasının adını belirtir.
--hangdump-timeout	Dökümün oluşturulmasına kadar geçen zaman aşımını belirtir. Zaman aşımı değeri aşağıdaki biçimlerden birinde belirtilir: 1.5h, 1.5hour, 1.5hours 90m, 90min, 90minute, 90minutes 5400s, 5400sec, 5400second, 5400seconds. Varsayılan olarak 30m (30 dakika).
--hangdump-type	Döküm türünü belirtir. Geçerli değerler Mini, Heap, TriageFull. varsayılan olarak Full. Daha fazla bilgi için bkz. Mini Dumplar Türleri.