Aracılığıyla paylaş


Hizmet İzleme Görüntüleyicisi Aracı (SvcTraceViewer.exe)

Windows Communication Foundation (WCF) Hizmet İzleme Görüntüleyicisi Aracı, WCF tarafından oluşturulan tanılama izlemelerini çözümlemenize yardımcı olur. Hizmet İzleme Görüntüleyicisi, WCF hizmeti sorunlarını tanılamak, onarmak ve doğrulamak için günlükteki izleme iletilerini kolayca birleştirmek, görüntülemek ve filtrelemek için bir yol sağlar.

İzlemeyi Yapılandırma

Tanılama izlemeleri, uygulamanızın işlemi boyunca neler olduğunu gösteren bilgiler sağlar. Adından da anlaşılacağı gibi, işlemleri kaynaktan hedefe ve ara noktalar aracılığıyla da takip edebilirsiniz.

uygulamanın yapılandırma dosyasını kullanarak izlemeyi yapılandırabilirsiniz: Web'de barındırılan uygulamalar için Web.config veya şirket içinde barındırılan uygulamalar için Appname.config. Aşağıda bir örnek verilmiştir:

<system.diagnostics>
    <trace autoflush="true" />
    <sources>
            <source name="System.ServiceModel"
                    switchValue="Information, ActivityTracing"
                    propagateActivity="true">
            <listeners>
               <add name="sdt"
                   type="System.Diagnostics.XmlWriterTraceListener"
                   initializeData= "SdrConfigExample.e2e" />
            </listeners>
         </source>
    </sources>
</system.diagnostics>

Bu örnekte, izleme dinleyicisinin adı ve türü belirtilir. Dinleyici adlandırılır sdt ve tür olarak standart .NET Framework izleme dinleyicisi (System.Diagnostics.XmlWriterTraceListener) eklenir. initializeData özniteliği, söz konusu Dinleyici için günlük dosyasının adını olarak SdrConfigExample.e2eayarlamak için kullanılır. Günlük dosyası için, basit bir dosya adı için tam yolu değiştirebilirsiniz.

Örnek, kök dizinde SdrConfigExample.e2e adlı bir dosya oluşturur. "WCF İzleme Dosyalarını Açma ve Görüntüleme" bölümünde açıklandığı gibi dosyayı açmak için İzleme Görüntüleyicisi'ni kullandığınızda, gönderilen tüm iletileri görebilirsiniz.

İzleme düzeyi ayarı tarafından switchValue denetlenmektedir. Kullanılabilir izleme düzeyleri aşağıdaki tabloda açıklanmıştır.

İzleme Düzeyi Açıklama
Kritik - Hızlı Başarısız ve Olay Günlüğü girdilerini günlüğe kaydeder ve bağıntı bilgilerini izler. Aşağıda, Kritik düzeyini ne zaman kullanabileceğinize ilişkin bazı örnekler verilmiştir:
- İşlenmeyen bir özel durum nedeniyle AppDomain'iniz devre dışı kaldı.
- Uygulamanız başlatılamıyor.
- Hataya neden olan ileti, işlem MyApp.exe kaynaklanır.
Hata - Tüm özel durumları günlüğe kaydeder. Aşağıdaki durumlarda Hata düzeyini kullanabilirsiniz:
- Geçersiz Atama Özel Durumu nedeniyle kodunuz kilitlendi.
- "Uç nokta oluşturulamadı" özel durumu uygulamanızın başlangıçta başarısız olmasına neden oluyor.
Uyarı - Daha sonra bir hataya veya kritik hataya neden olabilecek bir koşul vardır. Bu düzeyi aşağıdaki durumlarda kullanabilirsiniz:
- Uygulama azaltma ayarlarının izin verdiğinden daha fazla istek alıyor.
- Alıcı kuyruğu yapılandırılan kapasitesinin yüzde 98'indedir.
Bilgiler - Sistem durumunu izlemek ve tanılamak, performansı ölçmek veya profil oluşturmak için yararlı iletiler oluşturulur. Bu bilgileri kapasite planlaması ve performans yönetimi için kullanabilirsiniz. Bu düzeyi aşağıdaki durumlarda kullanabilirsiniz:
- İleti AppDomain'e ulaştıktan ve seri durumdan çıkarıldıktan sonra bir hata oluştu.
- HTTP bağlaması oluşturulurken bir hata oluştu.
Ayrıntılı - Hem kullanıcı kodu hem de hizmet için hata ayıklama düzeyi izleme. Şu durumlarda bu düzeyi ayarlayın:
- Hata oluştuğunda kodunuzda hangi yöntemin çağrıldığını emin değilseniz.
- Yapılandırılmış yanlış bir uç noktanız var ve rezervasyon deposundaki giriş kilitli olduğundan hizmet başlatılamadı.
ActivityTracing İşleme etkinlikleri ve bileşenler arasında akış olayları.

Bu düzey, yöneticilerin ve geliştiricilerin aynı uygulama etki alanındaki uygulamaları ilişkilendirmesine olanak tanır.

- Etkinlik sınırları için izlemeler: başlatma/durdurma.
- Aktarımlar için izlemeler.

Kullanmak istediğiniz izleme dinleyicisinin adını ve türünü belirtmek için kullanabilirsiniz add . Örnek yapılandırmada Dinleyici adlandırılmıştır sdt ve standart .NET Framework izleme dinleyicisi (System.Diagnostics.XmlWriterTraceListener) tür olarak eklenir. Bu Dinleyici için günlük dosyasının adını ayarlamak için kullanın initializeData . Buna ek olarak, basit bir dosya adı için tam yolu değiştirebilirsiniz.

.NET Framework 4.8'den başlayarak, bazı yüksek karşıtlık temalarındaki ComboBox denetimleri doğru renkte görüntülenir. svcTraceViewer.exe.config dosyasından aşağıdaki ayarı kaldırarak bu değişikliği devre dışı bırakabilirsiniz:

<AppContextSwitchOverrides value="Switch.UseLegacyAccessibilityFeatures=false;Switch.UseLegacyAccessibilityFeatures.2=false" />

Hizmet İzleme Görüntüleyicisi Aracı'nı kullanma

WCF İzleme Dosyalarını Açma ve Görüntüleme

Hizmet İzleme Görüntüleyicisi üç dosya türünü destekler:

  • WCF İzleme Dosyası (.svcLog)

  • Olay İzleme Dosyası (.etl)

  • Crimson İzleme Dosyası

Hizmet İzleme Görüntüleyicisi desteklenen tüm izleme dosyalarını açmanıza, ek izleme dosyaları ekleyip tümleştirmenize veya aynı anda bir izleme dosyası grubunu açıp birleştirmenize olanak tanır.

İzleme dosyasını açmak için
  1. WCF yükleme konumunuza (C:\Program Files\Microsoft SDKs\Windows\v6.0\Bin) gitmek için bir komut penceresi kullanarak Hizmet İzleme Görüntüleyicisi'ni başlatın ve yazın SvcTraceViewer.exe.

Not

Hizmet İzleme Görüntüleyicisi aracı iki dosya türüyle ilişkilendirilebilir: .svclog ve .stvproj. Dosya uzantılarını kaydetmek ve kaydını kaldırmak için komut satırında iki parametre kullanabilirsiniz.

/register: ".svclog" ve ".stvproj" dosya uzantılarının ilişkilendirmesini SvcTraceViewer.exe

/unregister: ".svclog" ve ".stvproj" dosya uzantılarının SvcTraceViewer.exe ile ilişkisinin kaydını kaldırın

  1. Hizmet İzleme Görüntüleyicisi başlatıldığında, Dosya'ya tıklayın ve Aç'ın üzerine gelin. İzleme dosyalarınızın depolandığı konuma gidin.

  2. Açmak istediğiniz izleme dosyasına çift tıklayın.

    Not

    Birden çok izleme dosyasını seçip aynı anda açmak için shift tuşuna basın. Hizmet İzleme Görüntüleyicisi tüm dosyaların içeriğini birleştirir ve tek bir görünüm sunar. Örneğin, hem istemci hem de hizmetin izleme dosyalarını açabilirsiniz. Bu, yapılandırmada ileti günlüğünü ve etkinlik yayma özelliğini etkinleştirdiğinizde kullanışlıdır. Bu şekilde, istemci ve hizmet arasındaki ileti değişimini inceleyebilirsiniz. Görüntüleyiciye birden çok dosya sürükleyebilir veya Proje sekmesini kullanabilirsiniz. Daha fazla ayrıntı için Projeyi Yönetme bölümüne bakın.

  3. Açık olan koleksiyona ek izleme dosyaları eklemek için Dosya'ya tıklayın ve Ekle'nin üzerine gelin. Açılan pencerede, izleme dosyalarının konumuna gidin ve eklemek istediğiniz dosyaya çift tıklayın.

Dikkat

200 MB'tan büyük bir izleme günlüğü dosyası yüklemeniz önerilmez. Bu sınırdan daha büyük bir dosyayı yüklemeye çalışırsanız, yükleme işlemi bilgisayar kaynağınıza bağlı olarak uzun sürebilir. Hizmet İzleme Görüntüleyicisi aracı uzun süre yanıt vermeyebilir veya makinenizin belleğini tüketebilir. Bunu önlemek için kısmi yüklemeyi yapılandırmanız önerilir. Bunun nasıl yapacağı hakkında daha fazla bilgi için "Büyük İzleme Dosyalarını Yükleme" bölümüne bakın.

Olay İzleme ve Kritik İzleme

Görüntüleyicinin yerel biçimi, WCF'nin yaydığı etkinlik izleme biçimidir. Görüntüleyici görüntülemeden önce farklı bir biçimde yayılan izlemelerin dönüştürülmesi gerekir. Şu anda, etkinlik izleme biçimine ek olarak görüntüleyici olay izlemeyi ve kritik izlemeyi destekler.

Etkinlik izlemeleri içermeyen bir dosyayı açtığınızda, görüntüleyici dosyayı dönüştürmeye çalışır. Dönüştürülen izleme verilerini içerecek dosyanın adını ve konumunu belirtmeniz gerekir. Veriler dönüştürüldükten sonra görüntüleyici yeni dosyanın içeriğini görüntüler.

Not

Dönüştürme, dönüştürülen izleme verilerini depolamak için disk alanı gerektirir. Dönüştürmeye başlamadan önce verileri depolamak için yeterli disk alanınız olduğundan emin olun. Aksi takdirde dönüştürme başarısız olur.

Projeleri Yönetme

Görüntüleyici, birden çok izleme dosyasının görüntülenmesini kolaylaştırmak için projeleri destekler. Örneğin, bir istemci izleme dosyanız ve bir hizmet izleme dosyanız varsa, bunları bir projeye ekleyebilirsiniz. Ardından, projeyi her açtığınızda, projedeki tüm izleme dosyaları aynı anda yüklenir.

Projeleri yönetmenin iki yolu vardır:

  • Dosya menüsünde projeleri açabilir, kaydedebilir ve kapatabilirsiniz.

  • Proje sekmesinde, projeye dosya ekleyebilirsiniz.

WCF İzlemelerini Görüntüleme

WCF, etkinlik izleme biçimini kullanarak izlemeleri yayar. Etkinlik izleme modelinde, tek tek izlemeler etkinliklerde amaçlarına göre gruplandırılır. Mantıksal denetim akışı etkinlikler arasında aktarılır. Örneğin, bir uygulamanın ömrü boyunca birçok "ileti gönderme etkinliği" görünür ve kaybolur. İzlemeleri ve etkinlikleri ve Hizmet İzleme Görüntüleyicisi'nin kullanıcı arabirimini görüntüleme hakkında daha fazla bilgi için bkz . İlişkili İzlemeleri Görüntülemek ve Sorun Giderme için Hizmet İzleme Görüntüleyicisi'ni Kullanma.

Farklı Görünümlere Geçme

Hizmet İzleme Görüntüleyicisi aşağıdaki farklı görünümleri sağlar. Bunlar Görüntüleyici'nin sol bölmesinde sekmeler olarak görüntülenir ve Görünüm menüsünden de erişilebilir.

  • Etkinlik Görünümü

  • Proje Görünümü

  • İleti Görünümü

  • Graf Görünümü

Etkinlik görünümü

İzleme dosyaları açıldıktan sonra, izlemelerin etkinlikler halinde gruplandırılmış olduğunu ve sol bölmedeki Etkinlik görünümünde görüntülendiğini görebilirsiniz.

Etkinlik görünümü etkinlik adlarını, etkinlikteki izleme sayısını, süre süresini, başlangıç saatini ve bitiş saatini görüntüler.

Listelenen etkinliklerden herhangi birine tıklandığında, bu etkinlikteki izlemeler sağdaki izleme bölmesinde görüntülenir. Ardından ayrıntılarını görüntülemek için bir izleme seçebilirsiniz.

Ctrl veya Shift tuşlarına basıp istediğiniz etkinliklere tıklayarak birden çok etkinlik seçebilirsiniz. İzleme bölmesi, seçili etkinliklerin tüm izlemelerini görüntüler.

Bir etkinliği Grafik Görünümü'nde görüntülemek için çift tıklayabilirsiniz. Bunun alternatif yolu bir etkinlik seçmek ve Graf Görünümü'ne geçmektir.

Not

"0000000000000" etkinliği, Grafik Görünümünde görüntülenemeyen özel bir etkinliktir. Diğer tüm etkinlikler buna bağlı olduğundan, bu etkinliğin görüntülenmesi ciddi bir performans etkisine sahiptir.

Etkinlik listesini sıralamak için sütun başlığına tıklayabilirsiniz. Uyarı izlemeleri içeren etkinliklerin arka planı sarıdır ve hata izlemeleri içerenler kırmızıdır.

Farklı etkinlik türleri vardır ve her tür her etkinliğin sol tarafındaki bir simgeye karşılık gelir. anlamları için İzleme Simgelerini Anlama bölümüne başvurabilirsiniz.

Proje Görünümü

Bu görünüm, geçerli projedeki izleme dosyalarını yönetmenizi sağlar. Daha fazla ayrıntı için Projeyi Yönetme bölümüne bakın.

İleti Görünümü

Bu görünüm, Eylem, Tarih/Saat, İşlem, Etkinlik ve Başlangıç/Bitiş dahil olmak üzere tüm ileti günlüğü izlemelerini görüntülemenizi ve ilişkili ileti günlüğü izlemesinin ayrıntılarına gitmenizi sağlar. İleti akışının daha kolay gezinmesi için ileti günlüğü izlemelerini Etkinlik Sınırına, İşlem/İş Parçacığına veya Gönder ve Al'a göre gruplandırabilirsiniz.

Graf Görünümü

Bu görünüm, belirli bir etkinliğin izleme verilerini grafik biçiminde görüntüler. Grafik formu, veriler arasında hareket ettikçe olayların adım adım yürütülmesini ve birden çok etkinlik arasındaki ilişkiyi görmenizi sağlar.

Graf görünümüne geçmek için Etkinlik görünümünde bir etkinlik seçin ve Etkinlik sekmesine veya İleti Görünümünde bir ileti günlüğü izlemesine tıklayın. Birden çok izleme dosyası yüklenirse ve etkinlik birden fazla dosyadan izleme içeriyorsa, ilgili izlemelerin tümü grafik görünümünde görünür. Etkinliklere ve ileti günlüğü izlemelerine çift tıklamak da sizi Graf görünümüne götürür.

Graf görünümünde her dikey sütun bir etkinliği, sütundaki her blok da bir izlemeyi temsil eder. Etkinlikler işleme (veya iş parçacığına) göre gruplandırılır. Etkinlikler arasındaki küçük oklar aktarımları temsil eder. İşlemler arasındaki büyük oklar ileti değişimini temsil eder. Seçimdeki etkinlik her zaman sarı renktedir.

Grafikte İzlemeleri Seçme
  1. Grafikte bir bloğa tıklayın.

  2. Komşu izlemelerini seçmek için yukarı ve aşağı tuşlarını kullanın.

  3. İzleme Bölmesi ve Ayrıntı Bölmesi'ndeki izleme bilgilerini inceleyin.

Etkinlik Aktarımlarını Genişletme veya Daraltma

Seçimdeki etkinlik başka bir etkinliğe aktarıldığında etkinlik aktarımlarını genişletebilirsiniz. Aktarımları takip etmenizi sağlar.

Etkinlik aktarımlarını genişletmek veya daraltmak için

  1. Aktarım simgesinin sol tarafında "+" işareti bulunan aktarım izlemesini bulun.

  2. "+" düğmesine tıklayın veya klavyeyi kullanarak Ctrl ve "+" tuşlarına basın.

  3. Sonraki etkinlik grafikte görünür.

  4. Aktarım simgesinin sol tarafında bir "-" görünür. "-" işaretine tıklayın veya Ctrl ve "-" tuşlarına basın; etkinlik aktarımı daraltılır.

Not

Bir etkinlikte birden çok aktarım olduğunda ve aktarımlardan birini genişlettiğiniz zaman, kök etkinlikten yeni etkinliğe yol açan etkinlikler görüntülenir. Bu yeni etkinlikler daraltılmış biçimde görünür. Bu etkinliklerin ayrıntılarını görmek istiyorsanız, grafiğin üst bilgisindeki genişlet simgesine tıklayarak bunları dikey olarak genişletin.

Etkinlikleri Dikey Olarak Genişletme veya Daraltma

Görüntüleyici, etkinlikleri daraltarak etkinlik grafiğindeki gereksiz ayrıntıları gizler. Daraltılmış bir etkinlikte tek tek izlemeler görüntülenmez. Yalnızca aktarım izlemesi görüntülenir. Bir etkinlikteki tüm izlemeleri görüntülemek istiyorsanız, grafiğin üst bilgisindeki etkinliğin genişletme simgesine tıklayarak etkinliği dikey olarak genişletin.

Etkinlikleri dikey olarak genişletmek veya daraltmak için

  1. Etkinliği dikey olarak genişletmek için etkinlik üst bilgisindeki "+" simgesine tıklayın.

  2. Tüm izlemelerin grafikte görüntülendiğine dikkat edin.

  3. Etkinliği dikey olarak daraltmak için etkinlik üst bilgisindeki "-" simgesine tıklayın.

  4. Etkinlikte yalnızca önemli aktarımlar, ileti günlükleri, uyarı ve özel durum izlemelerinin gösterildiğine dikkat edin.

Seçenekler

Grafik görünümündeki Seçenek menüsünden iki seçenek belirleyebilirsiniz.

  • İşaretlenmediğinde grafikteki etkinlik sınırı izlemelerini yoksayan Etkinlik Sınırı İzlemelerini göster.

  • İşaretlenmemiş olduğunda ileti izlemeleri dışında ayrıntılı düzey izlemelerini yoksayan İleti Dışı Ayrıntılı İzlemeleri göster. Çoğu durumda ayrıntılı düzey izlemeleri analiz için daha az önemlidir. Bu seçenek, ayrıntılı düzey izlemelerini analiz etmek istemediğinizde ve yalnızca daha önemli izlemelere odaklanmak istediğinizde yararlıdır.

Düzen Modu

Görüntüleyicinin iki Düzen Modu vardır: İşlem ve İş Parçacığı. Bu ayar, en büyük kuruluş birimini tanımlar. Varsayılan Düzen Modu İşlem'dir ve bu da etkinliklerin grafikteki işlemlere göre gruplandığı anlamına gelir.

Yürütme Listesi

Bu açılan listeden grafikte hangi işlemin veya iş parçacığının görüntüleneceğini seçebilirsiniz. Örneğin, iki istemcinin (A ve B) ve bir hizmetin izleme dosyaları açıksa ve hizmet ile A istemcisini grafikte görüntülemek istiyorsanız, listeden B istemcisinin seçimini kaldırabilirsiniz.

İzleme Ayrıntılarını Görüntüleme

İzleme ayrıntılarını görüntülemek için İzleme bölmesinde bir izleme seçin. Ayrıntılar, Ayrıntılar bölmesinde görüntülenir.

İzleme Bölmesi

Hizmet İzleme Görüntüleyicisi'nin sağ üst bölmesi İzleme Bölmesi'dir. Seçilen etkinlikteki tüm izlemeleri, izleme düzeyi, iş parçacığı kimliği ve işlem adı gibi ek bilgilerle listeler.

İzlemeye sağ tıklayıp İzlemeyi Panoya Kopyala'yı seçerek izlemenin ham XML'sini panoya kopyalayabilirsiniz.

Ayrıntı Bölmesi

Hizmet İzleme Görüntüleyicisi'nin sol alt bölmesi Ayrıntı Bölmesi'dir. İzleme ayrıntılarını görüntülemek için üç sekme sağlar.

Biçimlendirilmiş görünüm, bilgileri daha düzenli bir şekilde görüntüler. Tablolarda ve ağaçlarda bilinen tüm XML öğelerini listeler ve bu da bilgilerin okunmasını ve anlaşılmasını kolaylaştırır.

XML görünümünde, seçilen izlemeye karşılık gelen XML görüntülenir. Vurgulama ve söz dizimi rengini destekler. Dizeleri aramak için Bul'u kullandığınızda arama sonuçları vurgulanır.

İleti görünümü, ileti günlüğü izlemelerinde XML'nin ileti bölümünü görüntüler. İleti olmayan bir izleme seçtiğinizde görünmez.

WCF İzlemelerini Filtreleme

İzleme analizini kolaylaştırmak için bunları aşağıdaki yollarla filtreleyebilirsiniz:

  • Filtre araç çubuğu, önceden tanımlanmış ve özel filtrelere erişim sağlar. Görünüm menüsü aracılığıyla etkinleştirilebilir.

  • Görüntüleyicinin önceden tanımlanmış filtresi, WCF izlemelerinin bölümlerini seçmeli olarak filtrelemek için kullanılabilir. Varsayılan olarak, tüm altyapı izlemelerinin geçmesine izin verecek şekilde ayarlanır. Bu filtrenin ayarları, Görünüm menüsünün altındaki Filtre Seçenekleri alt menüsünde tanımlanır.

  • Özel XPath filtreleri, kullanıcılara filtreleme üzerinde tam denetim sağlar. Bunlar, Görünüm menüsünün altındaki Özel Filtre'de tanımlanabilir.

Yalnızca tüm filtrelerden geçen izlemeler görüntülenir.

Filtre Araç Çubuğu'nu kullanma

Filtre araç çubuğu aracın üst kısmında görünür. Yoksa, Görünüm menüsünde etkinleştirebilirsiniz. Çubuğun üç bileşeni vardır:

  • Arama: Arama , filtre işleminde aranacak konuyu tanımlar. Örneğin, X işlemi bağlamında yayılan tüm izlemeleri bulmak istiyorsanız, bu alanı X ve Arama Alanı alanını 'İşlem Adı' olarak ayarlayın. Bu alan, zamana bağlı bir filtre seçildiğinde DateTime seçici denetimine dönüşür.

  • Arama: Bu alan uygulanacak filtre türünü tanımlar.

  • Düzey: Düzey ayarı, filtre tarafından izin verilen en düşük izleme düzeyini tanımlar. Örneğin, düzey Hata ve Yukarı olarak ayarlanırsa, yalnızca Hata ve kritik düzeydeki izlemeler görüntülenir. Bu filtre, Look For and Search In tarafından belirtilen ölçütlerle birleştirilir.

Şimdi Filtrele düğmesi, filtre işlemini başlatır. Özellikle büyük bir veri kümesine uygulandığında bazı filtrelerin tamamlanması uzun zaman alır. İşlemler menüsünün altındaki durum çubuğunda görüntülenen Durdur düğmesine basarak filtre işlemini iptal edebilirsiniz.

Temizle düğmesi, tüm izlemelerin geçmesine izin vermek için önceden tanımlanmış ve özel filtreleri sıfırlar.

Filtre Seçenekleri

Görüntüleyici, WCF izlemelerini görünümden otomatik olarak kaldırabilir. WCF'nin belirli alanları tarafından yayılan izlemeleri, örneğin işlemle ilgili izlemeleri görünümden seçerek kaldırabilir.

Bu filtrenin ayarları, Görünüm menüsünün altındaki Filtre Seçenekleri alt menüsünde tanımlanır.

Özel Filtreler

XML Yol Dili'ni (XPath) biliyorsanız, bu dili kullanarak izleme verilerini ilgilendiğiniz herhangi bir XML öğesi için aramak üzere özel filtreler oluşturabilirsiniz. Filtrelere filtre araç çubuğundan erişilebilir.

Özel filtreler parametreleri içerebilir. Önceden var olan özel filtreleri de içeri aktarabilirsiniz.

Özel filtre oluşturma

Filtreler iki şekilde oluşturulabilir:

Şablon Sihirbazı'nı kullanarak Özel Filtre Oluşturma

Mevcut bir izlemeye tıklayabilir ve izlemenin yapısına göre bir filtre oluşturabilirsiniz. Bu örnek, iş parçacığı kimliğine göre özel bir filtre oluşturur.

  1. Görüntüleyicinin sağ üst kısmındaki izleme bölmesinde, filtrelemek istediğiniz öğeyi içeren bir izleme seçin.

  2. İzleme bölmesinin en üstünde bulunan Özel Filtre Oluştur düğmesine tıklayın.

  3. Görüntülenen iletişim kutusuna filtreniz için bir ad girin. Bu örnekte girin Thread ID. Filtrenizin açıklamasını da sağlayabilirsiniz.

  4. Soldaki ağaç görünümü, 1. adımda seçtiğiniz izleme kaydının yapısını görüntüler. Koşul oluşturmak istediğiniz öğeye göz atın. Bu örnekte, XPath: /E2ETraceEvent/System/Execution/@ThreadID düğümünde bulunabilecek ThreadID'ye göz atın. Ağaç görünümünde ThreadID özniteliğine çift tıklayın. Bu, iletişim kutusunun sağındaki özniteliği için bir ifade oluşturur.

  5. ThreadID koşulunun parametre alanını None olan '{0}' olarak değiştirin. Bu adım, filtre uygulandığında ThreadID değerinin yapılandırılmasını sağlar. (Filtre Uygulama bölümüne bakın) En fazla dört parametre tanımlayabilirsiniz. Koşullar OR işleci kullanılarak birleştirilir.

  6. Filtreyi oluşturmak için Tamam'a tıklayın.

Not

Şablon sihirbazı kullanılarak bir filtre oluşturulduktan sonra yalnızca el ile düzenlenebilir. Daha önce oluşturulmuş bir filtre için sihirbazı etkinleştirmek mümkün değildir. Ayrıca, şablon sihirbazında oluşturulan bir XPath filtresinin koşulları OR işleci kullanılarak birleştirilir. AND işlemine ihtiyacınız varsa, filtre ifadesini oluşturulduktan sonra düzenleyebilirsiniz.

El ile Özel Filtre Oluşturma

Özel Filtreler menüsü, XPath filtrelerini el ile girmenizi sağlar.

  1. Görünüm menüsünde Özel Filtreler menü öğesine tıklayın.

  2. Görüntülenen iletişim kutusunda Yeni'ye tıklayın .

  3. En azından bir Filtre Adı ve XPath ifadesi belirtin.

  4. Tamam'a tıklayın.

Özel Filtre Uygulama

Özel bir filtre oluşturulduktan sonra, filtre araç çubuğu erişilebilir. Filtre araç çubuğunun Arama Alanı alanında uygulamak istediğiniz filtreyi seçin. Önceki örnekte 'İş Parçacığı Kimliği'ni seçin.

  1. Aranan alanında aradığınız değeri belirtin. Örneğimizde, aramak istediğiniz iş parçacığının kimliğini girin.

  2. Şimdi Filtrele'ye tıklayın ve işlemin sonucunu gözlemleyin.

Filtreniz birden çok parametre kullanıyorsa, bunları Aranan alanına ayırıcı olarak ';' kullanarak girin. Örneğin, aşağıdaki dize 3 parametre tanımlar: '1; findValue; metin'. Görüntüleyici, filtrenin {0} parametresine '1' uygular. 'findValue' ve 'text' sırasıyla ve'ye {1}{2} uygulanır.

Özel Filtreleri Paylaşma

Özel filtreler farklı oturumlar ve farklı kullanıcılar arasında paylaşılabilir. Filtreleri bir tanım dosyasına aktarabilir ve bu dosyayı başka bir konuma aktarabilirsiniz.

Özel filtreyi içeri aktarmak için:

  1. Görünüm menüsünde Özel Filtreler'e tıklayın.

  2. Açılan iletişim kutusunda İçeri Aktar düğmesine tıklayın.

  3. Özel filtre dosyasına (.stvcf) gidin, dosyaya tıklayın ve Aç düğmesine tıklayın.

Özel filtreyi dışarı aktarmak için:

  1. Görünüm menüsünde Özel Filtreler'e tıklayın.

  2. Açılan iletişim kutusunda, dışarı aktarmak istediğiniz filtreyi seçin.

  3. Dışarı Aktar düğmesine tıklayın.

  4. Özel filtre tanımı dosyasının (.stvcf) adını ve konumunu belirtin ve Kaydet düğmesine tıklayın.

Not

Bu özel filtreler yalnızca Hizmet İzleme Görüntüleyicisi'nden içeri ve dışarı aktarılabilir. Bunlar diğer araçlar tarafından okunamaz.

Veri Bulma

Görüntüleyici verileri bulmak için aşağıdaki yolları sağlar:

  • Bul araç çubuğu, en yaygın bulma seçeneklerine hızlı erişim sağlar.

  • Bul iletişim kutusu daha fazla bulma seçeneği sağlar. Düzenle menüsünden veya Ctrl + F kısa tuşuyla erişilebilir.

Bul araç çubuğu görüntüleyicinin en üstünde görünür. Yoksa, Görünüm menüsünde etkinleştirebilirsiniz. Çubuğun iki bileşeni vardır:

  • Aranan: Arama anahtar sözcüğünü girmenize olanak tanır.

  • Bak: Arama kapsamını girmenize izin verir. Tüm etkinliklerde mi yoksa yalnızca geçerli etkinlikte mi arama yapılıp yapılmayacağını seçebilirsiniz.

Bul iletişim kutusu iki ek seçenek sağlar:

  • Hedefi bul:

    • "Ham günlük verileri" seçeneği tüm ham verilerde anahtar sözcüğü arar.

    • "XML Metni" ve "XML Özniteliği" seçenekleri yalnızca XML öğelerinde arar.

    • "Günlüğe Kaydedilen İleti" seçeneği, anahtar sözcüğü yalnızca iletilerde arar.

  • Kök etkinliği yoksay: Arama, "00000000000000" etkinliğindeki izlemeleri yoksayar. Bu, kök etkinliğin binlerce izlemesi olduğunda ve çoğu aktarım olduğunda büyük izleme dosyalarındaki performansı artırır.

İzlemeler uygulama çalışma zamanı sırasında adım adım kaydedildiğinden, izlemelerde gezinmek uygulamanızda hata ayıklamanıza yardımcı olabilir. Hizmet İzleme Görüntüleyicisi, izlemelerde gezinmek için çeşitli yollar sağlar.

İleri veya Geri Adım

Her izlemeyi programdaki bir kod satırı olarak değerlendirirseniz, ileriye doğru ilerlemek Visual Studio Tümleşik Geliştirme Ortamı'ndaki (IDE) "Adımla" özelliğine çok benzer. Aradaki fark, izlemelerde geri adım atabilmenizdir. İleriye doğru ilerlemek, etkinlikte bir sonraki izlemeye geçmek anlamına gelir.

  • İleri Adım: Etkinlik menüsünü kullanın veya "F10" tuşuna basın. İzleme bölmesinde "aşağı" ok tuşunu da kullanabilirsiniz.

  • Geri Adım: Etkinlik menüsünü kullanın veya "F9" tuşuna basın. İzleme bölmesinde "yukarı" ok tuşunu da kullanabilirsiniz.

Not

WcF iletileri makinelere yayılan etkinlik kimlikleri taşıyabileceğinden, bu sizi farklı bir işlemde veya hatta farklı bir bilgisayarda gerçekleşen bir etkinliğe götürebilir.

Aktarımı takip et

Aktarım izlemeleri, izleme dosyasındaki özel izlemelerdir. Bir etkinlik, aktarım izlemesi tarafından başka bir etkinliğe aktarılabilir. Örneğin, "Etkinlik A", "Etkinlik B"ye aktarılabilir. Böyle bir durumda, "Etkinlik A" içinde "To: Activity" adı ve aktarım simgesi ile bir aktarım izlemesi vardır. Bu aktarım izlemesi, iki izleme arasındaki bir bağlantıdır. "Etkinlik B" içinde, etkinliğin sonunda "Etkinlik A"ya geri aktarmak için bir aktarım izlemesi de olabilir. Bu, programlardaki işlev çağrılarına benzer: A B'yi çağırır, sonra B döndürür.

"Aktarımı takip et", hata ayıklayıcıdaki "Adımla" ile benzerdir. A'dan B'ye aktarımı izler. Diğer izlemeler üzerinde herhangi bir etkisi yoktur.

Aktarımı izlemenin iki yolu vardır: fareyle veya klavyeyle:

  • Fareyle: İzleme bölmesinde aktarım izlemesine çift tıklayın.

  • Klavye ile: Bir aktarım izlemesi seçin ve Etkinlik menüsünde "Aktarımı takip et" seçeneğini kullanın veya "F11" tuşuna basın

Not

Çoğu durumda, Etkinlik A Etkinlik B'ye aktarıldığında, Etkinlik A, Etkinlik B'nin A Etkinliğine geri aktarımını bekler. Bu, Etkinlik B'nin etkin olarak izlendiği dönemde A Etkinliğinin günlüğe kaydedilmediği anlamına gelir. Ancak, Etkinlik A'nın beklememesi ve izlemeleri günlüğe kaydetmeye devam etmesi de mümkündür. Etkinlik B'nin A Etkinliğine geri aktarılmaması da mümkündür. Bu nedenle, etkinlik aktarımları bu anlamda işlev çağrılarından hala farklıdır. Grafik görünümünde etkinlik aktarımlarını daha iyi anlayabilirsiniz.

Sonraki veya Önceki Aktarıma Atla

Geçerli etkinliği veya birden çok etkinlik seçildiğinde seçilen etkinlikleri analiz ederken, aktardığınız etkinlikleri hızla bulmak isteyebilirsiniz. "Sonraki aktarıma atla", etkinlikteki bir sonraki aktarım izlemesini bulmanıza olanak tanır. Aktarım izlemesini bulduğunuzda bir sonraki etkinliğe geçmek için "Aktarımı takip et"i kullanabilirsiniz.

  • Sonraki Aktarıma Atla: Etkinlik menüsünü kullanın veya "Ctrl + F10" tuşlarına basın.

  • Önceki Aktarıma Atla: Etkinlik menüsünü kullanın veya "Ctrl + F9" tuşlarına basın.

Etkinlik bölmesinde ve izleme bölmesinde gezinmek hata ayıklamaya benzer olsa da, Graph görünümünü kullanmak gezintide çok daha iyi bir deneyim sağlar. Daha fazla bilgi için "Grafik Görünümü" bölümüne bakın.

Büyük İzleme Dosyalarını Yükleme

İzleme dosyaları çok büyük olabilir. Örneğin, izlemeyi "Ayrıntılı" düzeyinde açarsanız, birkaç dakika çalıştırmak için elde edilen izleme dosyası, ağ hızına ve iletişim düzenine bağlı olarak yüzlerce megabayt veya daha büyük olabilir.

Hizmet İzleme Görüntüleyicisi'nde çok büyük bir izleme dosyası açtığınızda sistem performansı olumsuz etkilenebilir. Yükleme hızı ve yüklemeden sonraki yanıt süresi yavaş olabilir. Gerçek hız, donanım yapılandırmanıza bağlı olarak zaman zaman farklılık gösterir. Çoğu bilgisayarda, 200M'den büyük bir izleme dosyasının yüklenmesi ciddi bir performans etkisine sahiptir. 1G'den büyük izleme dosyaları için araç tüm kullanılabilir belleği kullanabilir veya çok uzun süre yanıt vermeyi durdurabilir.

Büyük izleme dosyalarını analiz etmede yavaş yükleme ve yanıt süresinden kaçınmak için, Hizmet İzleme Görüntüleyicisi bir kerede izlemenin yalnızca küçük bir bölümünü yükleyen "Kısmi Yükleme" adlı bir özellik sağlar. Örneğin, sunucuda birkaç gün çalışan 1 GB üzerinde bir izleme dosyanız olabilir. Bazı hatalar oluştuğunda ve izlemeyi analiz etmek istediğinizde, izleme dosyasının tamamını açmanız gerekmez. Bunun yerine, hatanın oluştuğu belirli bir süre içinde izlemeleri yükleyebilirsiniz. Kapsam daha küçük olduğundan, Hizmet İzleme Görüntüleyicisi aracı dosyayı daha hızlı yükleyebilir ve hataları daha küçük bir veri kümesi kullanarak tanımlayabilirsiniz.

Kısmi Yüklemeyi Etkinleştirme

Kısmi yüklemeyi el ile etkinleştirmeniz gerekmez. Yüklemeye çalıştığınız izleme dosyalarının toplam boyutu 40 MB'ı aşarsa, Hizmet İzleme Görüntüleyicisi yüklemek istediğiniz bölümü seçmeniz için otomatik olarak Bir Kısmi Yükleme iletişim kutusu görüntüler.

Not

İzlemeler zaman aralığında eşit olarak dağıtılmayabileceği için, Kısmi Yükleme araç çubuğunda belirttiğiniz sürenin uzunluğu gösterilen yükleme boyutuyla orantılı olmayabilir. Gerçek yükleme boyutu, kısmi yükleme iletişim kutusundaki Tahmini Boyut'tan daha küçük olabilir.

Kısmi Yüklemeyi Ayarlama

İzleme dosyasını kısmen yükledikten sonra, yüklenmekte olan veri kümesini değiştirmek isteyebilirsiniz. Bunu yapmak için görüntüleyicinin üst kısmındaki Kısmi Yükleme araç çubuğunu ayarlayabilirsiniz.

  1. Araç çubuğunu fareyle hareket ettirin veya Başlangıç ve Bitiş saatini yazın.

  2. Ayarla düğmesine tıklayın.

İzleme Simgelerini Anlama

Aşağıda, Hizmet İzleme Görüntüleyicisi aracının Etkinlik görünümünde, Graf görünümünde ve İzleme bölmesinde farklı öğeleri temsil etmek için kullandığı simgelerin listesi yer alır.

Not

Kategorilere ayrılmamış bazı izlemelerin (örneğin, "bir ileti kapatıldı") simgesi yoktur.

Etkinlik İzleme İzlemeleri

Simge Açıklama
Warning trace Uyarı izleme: Uyarı düzeyinde yayılan bir izleme
Error trace Hata izleme: Hata düzeyinde yayılan bir izleme.
Activity Start trace: Etkinlik Başlangıç izlemesi: Etkinliğin başlangıcını işaretleyen izleme. Etkinliğin adını içerir. Uygulama tasarımcısı veya geliştirici olarak, işlem veya iş parçacığı başına etkinlik kimliği başına bir etkinlik Başlangıç izlemesi tanımlamanız gerekir.

Etkinlik kimliği, izleme bağıntısı için izleme kaynakları arasında yayılırsa, aynı etkinlik kimliği için birden çok Başlangıç görebilirsiniz (izleme kaynağı başına bir tane). İzleme kaynağı için ActivityTracing etkinleştirilirse Başlangıç izlemesi gönderilir.
Activity Stop trace Etkinlik Durdurma izlemesi: Etkinliğin sonunu işaretleyen izleme. . Etkinliğin adını içerir. Uygulama tasarımcısı veya geliştirici olarak, izleme kaynağı başına etkinlik kimliği başına bir etkinlik Durdurma izlemesi tanımlamanız gerekir. İzleme süresi ayrıntı düzeyinin yeterince küçük olmaması dışında, belirli bir izleme kaynağından hiçbir izleme, bu izleme kaynağı tarafından yayılan durdurma etkinliğinden sonra görünmez. Böyle bir durumda, stop da dahil olmak üzere aynı anda iki izleme görüntülendiğinde araya eklenebilir. Etkinlik kimliği izleme bağıntısı için izleme kaynakları arasında yayılırsa, aynı etkinlik kimliği için birden çok Durak görebilirsiniz (izleme kaynağı başına bir tane). İzleme kaynağı için ActivityTracing etkinleştirilirse Durdurma izlemesi yayılır.
Activity Suspend trace Etkinlik Askıya Alma izlemesi: Etkinliğin duraklatıldığı zamanı işaretleyen izleme. Etkinlik devam edene kadar askıya alınmış bir etkinlikte hiçbir izleme kaydedilmez. Askıya alınan etkinlik, izleme kaynağı kapsamında bu etkinlikte hiçbir işlem yapılmadığını belirtir. Askıya Alma/Sürdürme izlemeleri profil oluşturma için yararlıdır. İzleme kaynağı için ActivityTracing etkinleştirilirse Askıya Alma izlemesi gönderilir.
Activity resume trace Etkinlik sürdürme izlemesi: Bir etkinliğin askıya alındıktan sonra sürdürülme zamanını işaretleyen izleme. İzlemeler bu etkinlikte yeniden yayılabilir. Askıya Alma/Sürdürme izlemeleri profil oluşturma için yararlıdır. İzleme kaynağı için ActivityTracing etkinleştirilirse Özgeçmiş izlemesi yayılır.
Transfer Aktarım: Mantıksal denetim akışı bir etkinlikten diğerine aktarıldığında yayılan izleme. Aktarımın kaynağı olan etkinlik, aktarımın gittiği etkinliğe paralel olarak iş yapmaya devam edebilir. İzleme kaynağı için ActivityTracing etkinleştirilirse Aktarım izlemesi yayılır.
Transfer From Aktarım Başlangıcı: Başka bir etkinlikten geçerli etkinliğe aktarımı tanımlayan izleme.
Transfer To Aktarım: Geçerli etkinlikten başka bir etkinliğe mantıksal denetim akışının aktarımını tanımlayan izleme.

WCF İzlemeleri

Simge Açıklama
Message Log trace İleti Günlüğü izlemesi: İzleme kaynağı etkinleştirildiğinde, bir WCF iletisi ileti günlüğü özelliği tarafından günlüğe kaydedildiğinde System.ServiceModel.MessageLogging yayılan izleme. Bu izleme tıklanması iletiyi görüntüler. İleti için yapılandırılabilir dört günlüğe kaydetme noktası vardır: ServiceLevelSendRequest, TransportSend, TransportReceive ve ServiceLevelReceiveRequest, ileti günlüğü izlemesindeki özniteliği tarafından messageSource da belirtilebilir.
Message Received trace İleti Alındı izlemesi: İzleme kaynağı Bilgi veya Ayrıntılı düzeyinde etkinleştirildiyse System.ServiceModel , WCF iletisi alındığında yayılan izleme. Bu izleme, Etkinlik Grafiği görünümünde ileti bağıntı okunu görüntülemek için gereklidir.
Message Sent trace İleti Gönderildi izlemesi: İzleme kaynağı Bilgi veya Ayrıntılı düzeyinde etkinleştirildiğinde WCF iletisi gönderildiğinde System.ServiceModel yayılan izleme. Bu izleme, Etkinlik Grafiği görünümünde ileti bağıntı okunu görüntülemek için gereklidir.

Aktiviteler

Simge Açıklama
Activity Etkinlik: Geçerli etkinliğin genel bir etkinlik olduğunu gösterir.
Root activity Kök etkinlik: Bir işlemin kök etkinliğini gösterir.

WCF Etkinlikleri

Simge Açıklama
Environment activity Ortam etkinliği: WCF konağı veya istemcisi oluşturan, açan veya kapatan bir etkinlik. Bu aşamalar sırasında oluşan hatalar bu etkinlikte görünür.
Listen activity Dinleme etkinliği: Dinleyiciyle ilgili izlemeleri günlüğe kaydeden etkinlik. Bu etkinliğin içinde dinleyici bilgilerini ve bağlantı isteklerini görüntüleyebiliriz.
Receive Bytes activity Alma Baytları etkinliği: İki uç nokta arasındaki bir bağlantıda gelen baytları almayla ilgili tüm izlemeleri gruplandıran bir etkinlik. Bu etkinlik, http.sys gibi etkinlik kimliklerini yayan taşıma etkinlikleriyle bağıntıda önemlidir. Bu etkinlikte iptaller gibi Bağlan hataları görüntülenir.
Process Message activity İşlem İletisi etkinliği: WCF iletisi oluşturmayla ilgili izlemeleri gruplandıran etkinlik. Hatalı zarf veya hatalı biçimlendirilmiş iletiden kaynaklanan hatalar bu etkinlikte görüntülenir. Bu etkinliğin içinde, arayandan bir etkinlik kimliğinin yayılıp yayılmadığını görmek için ileti üst bilgilerini inceleyebiliriz. Bu doğruysa, İşlem Eylemi etkinliğine (sonraki simge) aktardığımızda, çağıranın ve çağıranın izlemeleri arasındaki bağıntı için bu etkinliğe yayılan etkinlik kimliğini de atayabiliriz.
Message Log trace İşlem Eylemi etkinliği: wcf isteğiyle ilgili tüm izlemeleri iki uç nokta arasında gruplandıran bir etkinlik. Yapılandırmadaki her iki uç noktada da olarak ayarlanırsa propagateActivitytrue , doğrudan bağıntı için her iki uç noktadan gelen tüm izlemeler tek bir etkinlikte birleştirilir. Bu tür etkinlikler, taşıma veya güvenlik işleme nedeniyle kullanıcı kodu sınırına ve geriye doğru (yanıt varsa) genişleten hatalar içerir.
Process Message activity Kullanıcı Kodu yürütme etkinliği: bir isteği işlemek için kullanıcı kodu izlemelerini gruplandıran bir etkinlik.

Sorun giderme

Kayıt defterine yazma izniniz yoksa, aracı kaydetmek için "svctraceviewer /register" komutunu kullandığınızda "Microsoft Hizmet İzleme Görüntüleyicisi sisteme kaydedilmedi" hata iletisini alırsınız. Bu durumda, kayıt defterine yazma erişimi olan bir hesap kullanarak oturum açmanız gerekir.

Ayrıca, Hizmet İzleme Görüntüleyicisi aracı bazı ayarları (örneğin, özel filtreler ve filtre seçenekleri) derleme klasöründeki SvcTraceViewer.exe.settings dosyasına yazar. Dosya için okuma izniniz yoksa, yine de aracı başlatabilirsiniz, ancak ayarları yükleyemezsiniz.

.etl dosyasını açarken "Bir veya daha fazla izleme işlenirken bilinmeyen bir hata oluştu" hata iletisini alırsanız, .etl dosyasının biçimi geçersiz demektir.

Arapça işletim sistemi kullanılarak oluşturulan bir izleme günlüğünü açarsanız, zaman filtresinin çalışmadığını fark edebilirsiniz. Örneğin, 2005 yılı Arapça takvimde 1427 yılına karşılık gelir. Ancak, Hizmet İzleme Görüntüleyicisi araç filtresi tarafından desteklenen zaman aralığı 1752'den önceki bir tarihi desteklemez. Bu, filtrede doğru bir tarih seçemediğinizi gösterir. Bu sorunu çözmek için XPath ifadesini kullanarak belirli bir zaman aralığını içerecek özel bir filtre (Görünüm/Özel Filtreler) oluşturabilirsiniz.

Ayrıca bkz.