Aracılığıyla paylaş

Tanılama uzantıları

  • Makale

Bu makalede tanılama özelliğiyle ilgili tüm Microsoft Testing Platform uzantılar listelenip açıklanmaktadı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:

Environment variable name Açıklama
TESTINGPLATFORM_DIAGNOSTIC olarak ayarlanırsa 1, tanılama günlüğünü etkinleştirir.
TESTINGPLATFORM_DIAGNOSTIC_VERBOSITY Ayrıntı düzeyini tanımlar. Kullanılabilir değerler , , Debug, Information, Warning, Errorveya CriticaldeğerleridirTrace.
TESTINGPLATFORM_DIAGNOSTIC_OUTPUT_DIRECTORY Belirtilmezse, tanılama günlüğünün çıkış dizini, varsayılan TestResults dizininde oluşturulur.
TESTINGPLATFORM_DIAGNOSTIC_OUTPUT_FILEPREFIX Günlük dosyası adının ön eki. varsayılan değeridir "log_".
TESTINGPLATFORM_DIAGNOSTIC_FILELOGGER_SYNCHRONOUSWRITE Yerleşik dosya günlükçüsüsünü zaman uyumlu bir şekilde günlükleri yazmaya zorlar. Günlük girdilerini kaybetmek istemediğiniz senaryolar (işlem kilitleniyorsa) 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.

Kilitlenme bilgi dökümü

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

Önemli

Paket, lisanslama modelini kullanmak için Microsoft .NET kitaplığı kapalı kaynak ile birlikte gönderilir.

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

Seçenek Açıklama
--crashdump Test ana bilgisayarı işlemi kilitlendiğinde bir döküm dosyası oluşturur. .NET 6.0+ ile desteklenir.
⁠-⁠-⁠crashdump-⁠filename Döküm dosyasının adını belirtir.
--crashdump-type Döküm türünü belirtir. Geçerli değerler : Mini, Heap, Triage, Full. Varsayılan olarak Fullkullanır. Daha fazla bilgi için bkz . Mini döküm türleri.

Dikkat

Uzantı .NET Framework ile uyumlu değildir ve sessizce yoksayılır. .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: Window 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.

Önemli

Paket, lisanslama modelini kullanmak için Microsoft .NET kitaplığı kapalı kaynak ile birlikte gönderilir.

Kilitlenme dökümü dosyası oluşturmayı 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 Döküm dosyasının adını belirtir.
--hangdump-timeout Döküm oluşturulduğu 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 değeri 30m (30 dakika).
--hangdump-type Döküm türünü belirtir. Geçerli değerler : Mini, Heap, Triage, Full. Varsayılan olarak Fullkullanır. Daha fazla bilgi için bkz . Mini döküm türleri.