Tanılama İzlemeleri

İzlemeler, uygulama yürütme sırasında oluşturulan belirli iletilerin yayımlanmasıdır. İzlemeyi kullanırken, gönderilen iletileri toplamak ve kaydetmek için bir mekanizmanız olmalıdır. İzleme iletileri dinleyiciler tarafından alınır. Dinleyicinin amacı, izleme iletilerini toplamak, depolamak ve yönlendirmektir. Dinleyiciler izleme çıkışını günlük, pencere veya metin dosyası gibi uygun bir hedefe yönlendirir.

bu tür dinleyicilerden biri olan DefaultTraceListener, izleme etkinleştirildiğinde otomatik olarak oluşturulur ve başlatılır. İzleme çıkışının ek kaynaklara yönlendirilmesi için ek izleme dinleyicileri oluşturup başlatmanız gerekir. Oluşturduğunuz dinleyicileri ihtiyaçlarınıza uygun olmalıdır. Örneğin, tüm izleme çıktılarının metin kaydını isteyebilirsiniz. Bu durumda, tüm çıktı yazdı etkinleştirildiğinde yeni bir metin dosyası için bir dinleyici oluşturun. Diğer yandan, yalnızca uygulama yürütme sırasında çıkış görüntülemek isteyebilirsiniz. Bu durumda, tüm çıkış için bir konsol penceresi yönlendirilmiş bir dinleyici oluşturabilirsiniz. izleme EventLogTraceListener çıkışını bir olay günlüğüne yönlendirebilir ve izleme çıkışını TextWriterTraceListener bir akışa yazabilir.

İzlemeyi Etkinleştirme

İşlem işleme sırasında izlemeleri etkinleştirmek için uygulamanızın yapılandırma dosyasını düzenlemeniz gerekir. Aşağıda bir örnek verilmiştir.

<configuration>  
<system.diagnostics>  
     <sources>  
          <source name="System.Transactions" switchValue="Warning">  
               <listeners>  
                    <add name="tx"
                     type="System.Diagnostics.XmlWriterTraceListener"
                     initializeData= "tx.log" />  
               </listeners>  
          </source>  
     </sources>  
</system.diagnostics>  
</configuration>  

System.Transactions izlemeleri "System.Transactions" adlı kaynağa yazılır. Kullanmak istediğiniz izleme dinleyicisinin adını ve türünü belirtmek için kullanabilirsiniz add . Örnek yapılandırmamızda Dinleyiciye "tx" adını verdik ve standart .NET Framework izleme dinleyicisini (XmlWriterTraceListener) kullanmak istediğimiz tür olarak ekledik. Kullanım initializeData günlük dosyasının adı için bu dinleyici ayarlamak için. Buna ek olarak, bir basit dosya adı için tam yol yerine kullanabilirsiniz.

Her izleme iletisi türüne, önem derecesini belirtmek için bir düzey atanır. Uygulama etki alanının izleme düzeyi bir olay türünün düzeyine eşit veya daha düşükse, bu ileti oluşturulur. İzleme düzeyi, yapılandırma dosyasındaki switchValue ayar tarafından denetlenmektedir. Tanılama izleme iletileriyle ilişkili düzeyler aşağıdaki tabloda tanımlanmıştır.

İzleme Düzeyi	Açıklama
Kritik	Aşağıdaki gibi önemli hataları oluştu: - Kullanıcı işlevselliğinde anında kayıplara neden olabilecek bir hata. - Bir yöneticinin işlev kaybını önlemek için eylem gerçekleştirmesini gerektiren bir olay. - Kod kilitleniyor. - Bu izleme düzeyi, diğer kritik izlemeleri yorumlamak için yeterli bağlam da sağlayabilir. Bu işlemleri için ciddi bir arıza öndeki dizisini tanımasına yardımcı olabilir.
Hata	Bir hata (örneğin, geçersiz yapılandırma veya ağ davranış gibi) kullanıcı işlevselliği kaybına neden.
Uyarı	Bir koşul bulunduğunu daha sonra bir hata veya kritik hatası (başarısız veya bir sınır yaklaştığı Örneğin, ayırma) neden olabilir. Kullanıcı kodundaki hataların normal işlenmesi (örneğin, işlem durduruldu, zaman aşımları, kimlik doğrulaması başarısız oldu) bir uyarı da oluşturabilir.
Bilgiler	İzleme ve tanılama sistem durumu, performans ölçüm veya profil oluşturma için faydalı iletileri üretilir. Bunlar, oluşturulan veya işlenen bir işlem, önemli bir sınırın aşılması veya önemli kaynakların ayrılması gibi işlem ve listeleme ömrü olaylarını içerebilir. Bir geliştirici sonra gibi bilgileri kapasite planlama ve performans yönetimi için kullanabilir.

İzleme Kodları

Aşağıdaki tabloda altyapı tarafından System.Transactions oluşturulan izleme kodları listelenmektedir. Tabloya izleme kodu tanımlayıcısı, EventType izlemenin numaralandırma düzeyi ve izleme için TraceRecord içinde yer alan ek veriler dahildir. Buna ek olarak, izlemenin ilgili izleme düzeyi de TraceRecord içinde depolanır.

TraceCode	EventType	TraceRecord'da ek veriler
TransactionCreated	Bilgi	TransactionTraceId
TransactionPromoted	Bilgi	Yerel TransactionTraceId, Dağıtılmış TransactionTraceId
EnlistmentCreated	Bilgi	TransactionTraceId, EnlistmentTraceId, EnlistmentType (dayanıklı/geçici), EnlistmentOptions
EnlistmentCallbackNegative	Uyarı	TransactionTraceId, EnlistmentTraceId, Geri çağırma (forcerollback/iptal/nin şüpheli işlemi olmadığından)
TransactionRollbackCalled	Uyarı	TransactionTraceId
TransactionAborted	Uyarı	TransactionTraceId
TransactionInDoubt	Uyarı	TransactionTraceId
TransactionScopeCreated	Bilgi	TransactionScopeResult, aşağıdakiler olabilir: - Yeni işlem. - İşlem geçirildi. - Bağımlı işlem geçirildi. - Geçerli işlemi kullanma. - İşlem yok. yeni geçerli TransactionTraceId
TransactionScopeDisposed	Bilgi	Kapsamın "beklenen" geçerli işleminin TransactionTraceId değeri.
TransactionScopeIncomplete	Uyarı	Kapsamın "beklenen" geçerli işleminin TransactionTraceId değeri.
TransactionScopeNestedIncorrectly	Uyarı	Kapsamın "beklenen" geçerli işleminin TransactionTraceId değeri.
TransactionScopeCurrentTransactionChanged	Uyarı	Eski geçerli TransactionTraceId, diğer TransactionTraceId
TransactionScopeTimeout	Uyarı	Kapsamın "beklenen" geçerli işleminin TransactionTraceId değeri.
DependentCloneCreated	Bilgi	TransactionTraceId, oluşturulan bağımlı işlemin türü (RollbackIfNotComplete/BlockCommitUntilComplete)
DependentCloneComplete	Bilgi	TransactionTraceId
RecoveryComplete'in	Bilgi	Kaynak Yöneticisi GUID (değerinden tabanı)
Reenlist	Bilgi	Kaynak Yöneticisi GUID (değerinden tabanı)
TransactionSerialized	Bilgi	TransactionTraceId.
Transactionexception	Hata	Özel durum iletisi
InvalidOperationException	Hata	Özel durum iletisi
InternalError	Kritik	Özel durum iletisi
TransferEvent		Bir işlem seri durumdan çıkarıldığında veya bir işlemden dağıtılmış bir System.Transactions işleme yükseltildiğinde, ExecutionContext'ten geçerli ActivityID ve dağıtılmış işlem kimliği yazılır. DTC yönetilen koda geri çağırdığında, dağıtılmış işlem kimliği geri çağırma süresi boyunca ExecutionContext içinde ActivityID olarak ayarlanır.
ConfiguredDefaultTimeoutAdjusted	Uyarı	Ek veri yok
TransactionTimeout	Uyarı	Zaman aşımına uğradıktan sonra işlemin TransactionTraceId değeri.

Yukarıdaki ek veri öğelerinin her biri için XML şeması aşağıdaki biçime sahiptir.

TransactionTraceIdentifier

<TransactionTraceIdentifier>

<TransactionIdentifier >

string representation of transaction id

</TransactionIdentifier>

< CloneIdentifier >

the clone id number

</CloneIdentifier>

</TransactionTraceIdentifier>

EnlistmentTraceIdentifier

<EnlistmentTraceIdentifier>

<ResourceManagerId>

string form of guid

</ResourceManagerId>

<TransactionTraceIdentifier>

<TransactionIdentifier >

string representation of transaction id

</TransactionIdentifier>

<CloneIdentifier >

the clone id number

</CloneIdentifier>

<TransactionTraceIdentifier>

<EnlistmentIdentifier>

the enlistment id number

</EnlistmentIdentifier>

</EnlistmentTraceIdentifier>

Kaynak Yöneticisi tanımlayıcısı

<ResourceManagerId>

string form of guid

</ResourceManagerId>

İzleme için Güvenlik Sorunları

Yönetici olarak izlemeyi açtığınızda, hassas bilgiler varsayılan olarak genel olarak görüntülenebilir bir izleme günlüğüne yazılabilir. Olası güvenlik tehditlerini azaltmak için, izleme günlüğünü paylaşım ve dosya sistemi erişim izinleri tarafından denetlenen güvenli bir konumda depolamayı düşünmelisiniz.