Kilitlenmeyle ilgili dökümleri toplama

Uygulamanızı kilitlenmeyle ilgili dökümü toplayacak şekilde yapılandırma işlemi, belirli ortam değişkenleri ayarlanarak yapılır. Kilitlenmenin neden gerçekleştiğini anlamak istediğinizde bu yararlı olur. Örneğin, bir özel durum oluştuğunda dökümü yakalamak, uygulamanın kilitlenme durumunu inceleyerek sorunu belirlemenize yardımcı olur.

Aşağıdaki tabloda kilitlenmeyle ilgili dökümleri toplamak için yapılandırabileceğiniz ortam değişkenleri gösterilmektedir.

Ortam değişkeni	Açıklama	Default value
COMPlus_DbgEnableMiniDump veya DOTNET_DbgEnableMiniDump	1 olarak ayarlanırsa çekirdek dökümü oluşturmayı etkinleştirin.	0
COMPlus_DbgMiniDumpType veya DOTNET_DbgMiniDumpType	Toplanacak döküm türü. Daha fazla bilgi için bkz . Mini döküm türleri.	2 (Heap)
COMPlus_DbgMiniDumpName veya DOTNET_DbgMiniDumpName	Dökümü yazacak dosyanın yolu. dotnet işleminin çalıştığı kullanıcının belirtilen dizine yazma izinlerine sahip olduğundan emin olun.	/tmp/coredump.<pid>
COMPlus_CreateDumpDiagnostics veya DOTNET_CreateDumpDiagnostics	1 olarak ayarlanırsa döküm işleminin tanılama günlüğünü etkinleştirir.	0
COMPlus_EnableCrashReport veya DOTNET_EnableCrashReport	(.NET 6 veya üzeri gerektirir; Windows'da desteklenmez.) 1 olarak ayarlanırsa, çalışma zamanı kilitlenen uygulamanın iş parçacıkları ve yığın çerçeveleri hakkında bilgi içeren JSON biçimli bir kilitlenme raporu oluşturur. Kilitlenme raporu adı, .crashreport.json eklenmiş döküm yolu veya adıdır.
COMPlus_CreateDumpVerboseDiagnostics veya DOTNET_CreateDumpVerboseDiagnostics	(.NET 7 veya sonraki bir sürümü gerektirir.) 1 olarak ayarlanırsa döküm işleminin ayrıntılı tanılama günlüğünü etkinleştirir.	0
COMPlus_CreateDumpLogToFile veya DOTNET_CreateDumpLogToFile	(.NET 7 veya sonraki bir sürümü gerektirir.) Tanılama iletilerinin yazılması gereken dosyanın yolu.	Tanılama iletileri ayarlanmazsa, kilitlenen uygulamanın konsoluna yazılır.

Not

.NET 7, bu ortam değişkenleri yerine COMPlus_ ön eki DOTNET_ standartlaştırır. Ancak ön COMPlus_ ek çalışmaya devam eder. .NET çalışma zamanının önceki bir sürümünü kullanıyorsanız, ortam değişkenleri için ön eki kullanmaya COMPlus_ devam etmelisiniz.

Dosya yolu şablonları

.NET 5'den başlayarak, DOTNET_DbgMiniDumpName dinamik olarak doldurulacak biçimlendirme şablonu tanımlayıcılarını da içerebilir:

Belirleyici	Değer
%%	Tek bir % karakteri
%p	Döküm işleminin PID'i
%e	İşlem yürütülebilir dosya adı
%h	Ana bilgisayar adı döndüren gethostname()
%t	1970-01-01 00:00:00 +0000 (UTC) Dönem'den bu yana saniye olarak ifade edilen döküm süresi

Mini döküm türleri

Aşağıdaki tabloda için DOTNET_DbgMiniDumpTypekullanabileceğiniz tüm değerler gösterilmektedir. Örneğin, 1 olarak ayarlanması DOTNET_DbgMiniDumpType , kilitlenme durumunda tür dökümü toplanacağı anlamına gelir Mini .

Değer	Veri Akışı Adı	Açıklama
1	Mini	Modül listelerini, iş parçacığı listelerini, özel durum bilgilerini ve tüm yığınları içeren küçük bir döküm.
2	Heap	Modül listelerini, iş parçacığı listelerini, tüm yığınları, özel durum bilgilerini, işleme bilgilerini ve eşlenen görüntüler dışındaki tüm belleği içeren büyük ve nispeten kapsamlı bir döküm.
3	Triage	ile Miniaynıdır, ancak yollar ve parolalar gibi kişisel kullanıcı bilgilerini kaldırır.
4	Full	Modül görüntüleri dahil olmak üzere tüm belleği içeren en büyük döküm.

Tek dosyalı ve Yerel AOT uygulama modelleri yalnızca tam dökümleri destekler.