Service Trace Viewer Tool (SvcTraceViewer.exe)
Alat Service Trace Viewer Windows Communication Foundation (WCF) membantu Anda menganalisis jejak diagnostik yang dihasilkan oleh WCF. Service Trace Viewer menyediakan cara untuk dengan mudah menggabungkan, melihat, dan memfilter pesan jejak di log sehingga Anda dapat mendiagnosis, memperbaiki, dan memverifikasi masalah layanan WCF.
Mengonfigurasi Pelacakan
Jejak diagnostik memberi Anda informasi yang menunjukkan apa yang terjadi di seluruh operasi aplikasi Anda. Seperti namanya, Anda dapat mengikuti operasi dari sumbernya ke tujuan dan melalui titik perantara juga.
Anda dapat mengonfigurasi pelacakan menggunakan file konfigurasi aplikasi—baik Web.config untuk aplikasi yang dihosting Web, atau Appname.config untuk aplikasi yang dihost sendiri. Berikut ini adalah contohnya:
<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>
Dalam contoh ini, nama dan jenis pendengar jejak ditentukan. Pendengar diberi nama sdt dan pendengar jejak .NET Framework standar (System.Diagnostics.XmlWriterTraceListener) ditambahkan sebagai jenisnya. Atribut initializeData digunakan untuk mengatur nama file log untuk Pendengar tersebut menjadi SdrConfigExample.e2e. Untuk file log, Anda dapat mengganti jalur yang sepenuhnya memenuhi syarat untuk nama file sederhana.
Contoh membuat file di direktori akar yang disebut SdrConfigExample.e2e. Saat Anda menggunakan Trace Viewer untuk membuka file seperti yang dijelaskan di bagian "Membuka dan Melihat File Jejak WCF", Anda dapat melihat semua pesan yang telah dikirim.
Tingkat pelacakan dikendalikan oleh pengaturan switchValue. Tingkat pelacakan yang tersedia dijelaskan dalam tabel berikut.
| Tingkat Jejak | Deskripsi |
|---|---|
| Kritis | - Mencatat Fail-Fast dan entri Log Peristiwa, dan melacak informasi yang berhubungan. Berikut ini adalah beberapa contoh kapan Anda mungkin menggunakan tingkat Kritis: - AppDomain Anda turun karena pengecualian yang tidak tertangani. - Aplikasi Anda gagal dimulai. - Pesan yang menyebabkan kegagalan berasal dari proses MyApp.exe. |
| Error | - Mencatat semua pengecualian. Anda dapat menggunakan tingkat Kesalahan dalam situasi berikut: - Kode Anda crash karena Pengecualian Konversi Eksplisit Tidak Valid. - Pengecualian "gagal membuat titik akhir" menyebabkan aplikasi Anda gagal saat startup. |
| Peringatan | - Kondisi ada yang kemudian dapat mengakibatkan kesalahan atau kegagalan kritis. Anda dapat menggunakan tingkat ini dalam situasi berikut: - Aplikasi menerima lebih banyak permintaan daripada pengaturan pembatasannya memungkinkan. - Antrean penerima berada di 98 persen dari kapasitas yang dikonfigurasi. |
| Informasi | - Pesan berguna untuk memantau dan mendiagnosis status sistem, mengukur performa, atau membuat profil. Anda dapat memanfaatkan informasi tersebut untuk perencanaan kapasitas dan manajemen performa. Anda dapat menggunakan tingkat ini dalam situasi berikut: - Kegagalan terjadi setelah pesan mencapai AppDomain dan dideserialisasi. - Kegagalan terjadi saat pengikatan HTTP sedang dibuat. |
| Verbose | - Pelacakan tingkat debug untuk kode pengguna dan layanan. Atur tingkat ini ketika: - Anda tidak yakin metode mana dalam kode Anda yang dipanggil ketika kegagalan terjadi. - Anda memiliki titik akhir yang salah dikonfigurasi dan layanan gagal dimulai karena entri di penyimpanan reservasi dikunci. |
| ActivityTracing | Peristiwa alur antara aktivitas pemrosesan dan komponen. Tingkat ini memungkinkan administrator dan pengembang untuk menghubungkan aplikasi di domain aplikasi yang sama. - Jejak untuk batas aktivitas: mulai/berhenti. - Jejak untuk transfer. |
Anda dapat menggunakan add untuk menentukan nama dan jenis pendengar jejak yang ingin Anda gunakan. Dalam konfigurasi contoh, Pendengar diberi nama sdt dan pendengar jejak .NET Framework standar (System.Diagnostics.XmlWriterTraceListener) ditambahkan sebagai jenis. Gunakan initializeData untuk mengatur nama file log untuk Pendengar tersebut. Selain itu, Anda dapat mengganti jalur yang sepenuhnya memenuhi syarat untuk nama file sederhana.
Mulai dari .NET Framework 4.8, kontrol ComboBox dalam beberapa tema kontras tinggi ditampilkan dalam warna yang benar. Anda dapat menonaktifkan perubahan ini dengan menghapus pengaturan berikut dari file svcTraceViewer.exe.config:
<AppContextSwitchOverrides value="Switch.UseLegacyAccessibilityFeatures=false;Switch.UseLegacyAccessibilityFeatures.2=false" />
Menggunakan Alat Penampil Jejak Layanan
Membuka dan Menampilkan File Jejak WCF
Service Trace Viewer mendukung tiga jenis file:
File Pelacakan WCF (.svcLog)
File Pelacakan Peristiwa (.etl)
File Pelacakan Crimson
Service Trace Viewer memungkinkan Anda untuk membuka file jejak yang didukung, menambahkan dan mengintegrasikan file jejak tambahan, atau membuka dan menggabungkan sekelompok file jejak secara bersamaan.
Untuk membuka file jejak
- Mulai Service Trace Viewer dengan menggunakan jendela perintah untuk menavigasi ke lokasi penginstalan WCF Anda (C:\Program Files\Microsoft SDKs\Windows\v6.0\Bin), lalu ketik
SvcTraceViewer.exe.
Catatan
Alat Service Trace Viewer dapat dikaitkan dengan dua jenis file: .svclog dan .stvproj. Anda dapat menggunakan dua parameter di baris perintah untuk mendaftar dan membatalkan pendaftaran ekstensi file.
/register: daftarkan asosiasi ekstensi file ".svclog" dan ".stvproj" dengan SvcTraceViewer.exe
/unregister: batalkan pendaftaran asosiasi ekstensi file ".svclog" dan ".stvproj" dengan SvcTraceViewer.exe
Saat Service Trace Viewer dimulai, klik File lalu arahkan ke Buka. Navigasi ke lokasi tempat file jejak Anda disimpan.
Klik dua kali file jejak yang ingin Anda buka.
Catatan
Tekan SHIFT sambil mengklik beberapa file jejak untuk memilih dan membukanya secara bersamaan. Service Trace Viewer menggabungkan konten semua file dan menyajikan satu tampilan. Misalnya, Anda dapat membuka file jejak klien dan layanan. Hal ini berguna ketika Anda telah mengaktifkan pengelogan pesan dan penyebaran aktivitas dalam konfigurasi. Dengan cara ini, Anda dapat memeriksa pertukaran pesan antara klien dan layanan. Anda juga dapat menyeret beberapa file ke penampil, atau menggunakan tab Proyek. Lihat bagian Mengelola Proyek untuk detail selengkapnya.
Untuk menambahkan file jejak tambahan ke koleksi yang terbuka, klik File lalu arahkan ke Tambahkan. Di jendela yang terbuka, navigasikan ke lokasi file jejak dan klik dua kali file yang ingin Anda tambahkan.
Perhatian
Tidak disarankan agar Anda memuat file log jejak yang lebih besar dari 200MB. Jika Anda mencoba memuat file yang lebih besar dari batas ini, proses pemuatan mungkin memakan waktu lama, tergantung pada sumber daya komputer Anda. Alat Service Trace Viewer mungkin tidak responsif untuk waktu yang lama, atau mungkin menghabiskan memori komputer Anda. Disarankan agar Anda mengonfigurasi pemuatan sebagian untuk menghindari hal ini. Untuk informasi selengkapnya tentang cara melakukannya, lihat bagian "Memuat File Jejak Besar".
Pelacakan Peristiwa dan Pelacakan Crimson
Format asli penampil adalah format pelacakan aktivitas yang dipancarkan WCF. Jejak yang dipancarkan dalam format yang berbeda harus dikonversi sebelum penampil menampilkannya. Saat ini, selain format pelacakan aktivitas, penampil mendukung pelacakan peristiwa dan pelacakan crimson.
Saat Anda membuka file yang tidak berisi jejak aktivitas, penampil mencoba mengonversi file. Anda harus menentukan nama dan lokasi file yang akan berisi data jejak yang dikonversi. Setelah data dikonversi, penampil menampilkan konten file baru.
Catatan
Konversi memerlukan ruang disk untuk menyimpan data jejak yang dikonversi. Pastikan Anda memiliki cukup ruang disk yang tersedia untuk menyimpan data sebelum Anda memulai konversi. Jika tidak, konversinya gagal.
Mengelola Proyek
Penampil mendukung proyek untuk memfasilitasi melihat beberapa file jejak. Misalnya, jika Anda memiliki file jejak klien dan file jejak layanan, Anda dapat menambahkannya ke proyek. Kemudian, setiap kali Anda membuka proyek, semua file jejak dalam proyek dimuat secara bersamaan.
Ada dua cara untuk mengelola proyek:
Di menu File, Anda dapat membuka, menyimpan, dan menutup proyek.
Di tab Proyek, Anda dapat menambahkan file ke proyek.
Menampilkan Jejak WCF
WCF memancarkan jejak menggunakan format jejak aktivitas. Dalam model jejak aktivitas, jejak individu dikelompokkan dalam aktivitas sesuai dengan tujuannya. Alur kontrol logis ditransfer antar aktivitas. Misalnya, selama masa pakai aplikasi, banyak "aktivitas pengiriman pesan" muncul dan menghilang. Untuk informasi selengkapnya tentang melihat jejak dan aktivitas, dan antarmuka pengguna Service Trace Viewer juga, lihat Menggunakan Service Trace Viewer untuk Melihat Jejak dan Pemecahan Masalah yang Berkorelasi.
Beralih ke Tampilan Berbeda
Service Trace Viewer menyediakan tampilan berbeda berikut ini. Mereka ditampilkan sebagai tab di panel kiri Penampil, dan juga dapat diakses dari menu Tampilan.
Tampilan Aktivitas
Tampilan Proyek
Tampilan Pesan
Tampilan Graph
Tampilan aktivitas
Setelah file jejak dibuka, Anda dapat melihat jejak yang dikelompokkan ke dalam aktivitas dan ditampilkan dalam tampilan Aktivitas di panel sebelah kiri.
Tampilan Aktivitas menampilkan nama aktivitas, jumlah jejak dalam aktivitas, waktu durasi, waktu mulai, dan waktu akhir.
Dengan mengklik salah satu aktivitas yang tercantum, jejak dalam aktivitas ini ditampilkan di panel jejak di sebelah kanan. Anda kemudian dapat memilih jejak untuk melihat detailnya.
Anda dapat memilih beberapa aktivitas dengan menekan tombol Ctrl atau Shift dan mengklik aktivitas yang diinginkan. Panel jejak menampilkan semua jejak aktivitas yang dipilih.
Anda dapat mengeklik dua kali aktivitas untuk menampilkannya di Tampilan Graph. Cara alternatifnya adalah memilih aktivitas dan beralih ke Tampilan Graph.
Catatan
Aktivitas "000000000000" adalah aktivitas khusus yang tidak dapat ditampilkan dalam Tampilan Graph. Karena semua aktivitas lain terkait dengannya, menampilkan aktivitas ini memiliki dampak performa yang parah.
Anda dapat mengklik judul kolom untuk mengurutkan daftar aktivitas. Aktivitas yang berisi jejak peringatan memiliki latar belakang kuning dan yang berisi jejak kesalahan memiliki latar merah.
Ada berbagai jenis aktivitas dan setiap jenis sesuai dengan ikon di sisi kiri setiap aktivitas. Anda dapat merujuk ke bagian Memahami Ikon Jejak untuk maknanya.
Tampilan Proyek
Tampilan ini memungkinkan Anda mengelola file jejak dalam proyek saat ini. Lihat bagian Mengelola Project untuk detail selengkapnya.
Tampilan Pesan
Tampilan ini memungkinkan Anda untuk melihat semua jejak log pesan, termasuk Tindakan, Tanggal/Waktu, Proses, Aktivitas dan Dari/Ke, dan menavigasi ke detail jejak log pesan terkait. Anda dapat mengelompokkan jejak log pesan menurut Batas Aktivitas, Proses/Utas, atau Kirim &Terima untuk navigasi alur pesan yang lebih mudah.
Tampilan Graph
Tampilan ini menampilkan data jejak untuk aktivitas tertentu dalam formulir bagan. Formulir bagan memungkinkan Anda untuk melihat eksekusi peristiwa secara bertahap dan hubungan timbal balik antara beberapa aktivitas saat data berpindah di antara aktivitas tersebut.
Untuk beralih ke tampilan Graph, pilih aktivitas dalam tampilan Aktivitas dan klik tab Aktivitas, atau jejak log pesan di Tampilan Pesan. Jika beberapa file jejak dimuat dan aktivitas melibatkan jejak dari lebih dari satu file, semua jejak yang relevan muncul dalam tampilan grafik. Mengklik dua kali aktivitas dan jejak log pesan juga mengarahkan Anda ke tampilan Graph.
Dalam tampilan Graph, setiap kolom vertikal mewakili aktivitas, dan setiap blok dalam kolom mewakili jejak. Aktivitas dikelompokkan menurut proses (atau utas). Panah kecil di antara aktivitas mewakili transfer. Panah besar antar proses mewakili pertukaran pesan. Aktivitas dalam pilihan selalu berwarna kuning.
Memilih Jejak di Graph
Klik blok dalam grafik.
Gunakan tombol atas dan bawah untuk memilih jejak tetangganya.
Amati informasi jejak di Panel Jejak dan Panel Detail.
Memperluas atau Menciutkan Transfer Aktivitas
Anda dapat memperluas transfer aktivitas saat aktivitas dalam pilihan ditransfer ke aktivitas lain. Ini memungkinkan Anda untuk mengikuti transfer.
Untuk memperluas atau menciutkan transfer aktivitas,
Temukan jejak transfer dengan tanda "+" di sebelah kiri ikon transfer.
Klik "+", atau tekan Ctrl dan "+" menggunakan keyboard.
Aktivitas berikutnya muncul di grafik.
"-" muncul di sebelah kiri ikon transfer. Klik tanda "-" atau tekan Ctrl dan "-", transfer aktivitas akan diciutkan.
Catatan
Saat aktivitas memiliki beberapa transfer ke dalamnya dan Anda memperluas salah satu transfer, aktivitas yang mengarah ke aktivitas baru dari aktivitas akar akan ditampilkan. Aktivitas baru ini muncul dalam bentuk yang diciutkan. Jika Anda ingin melihat detail aktivitas ini, perluas secara vertikal dengan mengklik ikon perluas di header grafik.
Memperluas atau Menciutkan Aktivitas Secara Vertikal
Penampil menyembunyikan detail yang tidak perlu dalam grafik aktivitas dengan menciutkan aktivitas. Dalam aktivitas yang diciutkan, jejak individual tidak ditampilkan. Hanya jejak transfer yang muncul. Jika Anda ingin melihat semua jejak dalam suatu aktivitas, perluas aktivitas secara vertikal dengan mengklik simbol luaskan aktivitas di header grafik.
Untuk memperluas atau menciutkan aktivitas secara vertikal,
Klik ikon "+" di header aktivitas untuk memperluas aktivitas secara vertikal.
Perhatikan bahwa semua jejak ditampilkan dalam grafik.
Klik ikon "-" di header aktivitas untuk menciutkan aktivitas secara vertikal.
Perhatikan bahwa hanya transfer penting, log pesan, peringatan, dan jejak pengecualian yang ditampilkan dalam aktivitas.
Opsi
Anda dapat memilih dua opsi dari menu Opsi dalam tampilan Graph.
Perlihatkan Jejak Batas Aktivitas, yang saat tidak dicentang mengabaikan jejak batas aktivitas dalam grafik.
Tampilkan Jejak Verbose Non-pesan, yang ketika tidak dicentang mengabaikan jejak tingkat verbose, kecuali untuk jejak pesan. Dalam kebanyakan kasus, jejak tingkat verbose kurang penting untuk analisis. Opsi ini berguna ketika Anda tidak ingin menganalisis jejak tingkat verbose dan hanya ingin fokus pada jejak yang lebih penting.
Mode Tata Letak
Penampil memiliki dua Mode Tata Letak: Proses dan Utas. Pengaturan ini mendefinisikan unit organisasi terbesar. Mode Tata Letak default adalah Proses, yang berarti bahwa aktivitas dikelompokkan menurut proses dalam grafik.
Daftar Eksekusi
Anda dapat memilih proses atau utas mana yang akan ditampilkan dalam grafik dari daftar tarik turun ini. Misalnya, jika Anda memiliki file jejak dua klien (A dan B) dan satu layanan dibuka, dan Anda hanya ingin menampilkan layanan dan klien A dalam grafik, Anda dapat membatalkan pilihan klien B dari daftar.
Menampilkan Detail Jejak
Untuk menampilkan detail jejak, pilih jejak di panel Lacak. Detail ditampilkan di panel Detail.
Panel Jejak
Panel kanan atas di Service Trace Viewer adalah Panel Jejak. Ini mencantumkan semua jejak dalam aktivitas yang dipilih dengan informasi tambahan, misalnya, tingkat jejak, ID utas, dan nama proses.
Anda dapat menyalin XML mentah jejak ke clipboard dengan mengklik kanan jejak dan memilih Salin Jejak ke Clipboard.
Panel Detail
Panel kiri bawah di Service Trace Viewer adalah Panel Detail. Ini menyediakan tiga tab untuk melihat detail jejak.
Tampilan Diformat menampilkan informasi dengan cara yang lebih terorganisir. Ini mencantumkan semua elemen XML yang dikenal dalam tabel dan pohon, membuatnya lebih mudah untuk membaca dan memahami informasi.
Tampilan XML menampilkan XML yang sesuai dengan jejak yang dipilih. Ini mendukung penyorotan dan warna sintaksis. Saat Anda menggunakan Temukan untuk mencari string, string tersebut menyoroti hasil pencarian.
Tampilan Pesan menampilkan bagian pesan XML dalam jejak log pesan. Ini tidak terlihat ketika Anda memilih jejak non-pesan.
Memfilter Jejak WCF
Untuk mempermudah analisis jejak, Anda dapat memfilternya dengan cara berikut:
Toolbar filter menyediakan akses ke filter yang telah ditentukan sebelumnya dan kustom. Ini dapat diaktifkan melalui menu Tampilan.
Filter yang telah ditentukan sebelumnya dari penampil dapat digunakan untuk memfilter bagian jejak WCF secara selektif. Secara default, ini diatur untuk memungkinkan semua jejak infrastruktur untuk diteruskan. Pengaturan filter ini ditentukan di sub-menu Opsi Filter di bawah menu Tampilan.
Filter JalurX kustom memberi pengguna kontrol penuh atas pemfilteran. Mereka dapat ditentukan dalam Filter Kustom di bawah menu Tampilan.
Hanya jejak yang melewati semua filter yang ditampilkan.
Menggunakan Toolbar Filter
Toolbar filter muncul di bagian atas alat. Jika tidak ada, Anda dapat mengaktifkannya di menu Tampilan. Bilahnya memiliki tiga komponen:
Car untuki: Cari untuk yang menentukan subjek yang harus dicari dalam operasi filter. Misalnya, jika Anda ingin menemukan semua jejak yang dipancarkan dalam konteks proses X, atur bidang ini ke X dan bidang Pencarian Di ke 'Nama Proses'. Bidang ini berubah menjadi kontrol pemilih DateTime saat filter berbasis waktu dipilih.
Pencarian di: Bidang ini menentukan jenis filter yang akan diterapkan.
Tingkat: Pengaturan tingkat menentukan tingkat jejak minimum yang diizinkan oleh filter. Misalnya, jika tingkat diatur ke Kesalahan dan Naik, hanya jejak pada Kesalahan dan tingkat kritis yang ditampilkan. Filter ini dikombinasikan dengan kriteria yang ditentukan oleh Cari untuk dan Pencarian Di.
Tombol Filter Sekarang memulai operasi filter. Beberapa filter, terutama ketika diterapkan pada himpunan data besar, membutuhkan waktu lama untuk diselesaikan. Anda dapat membatalkan operasi filter dengan menekan tombol Hentikan yang muncul di bilah status di bawah menu Operasi.
Tombol Bersihkan mengatur ulang filter yang telah ditentukan sebelumnya dan kustom untuk memungkinkan semua jejak diteruskan.
Opsi Filter
Penampil dapat secara otomatis menghapus jejak WCF dari tampilan. Ini dapat secara selektif menghapus jejak yang dipancarkan oleh area tertentu dari WCF, misalnya, menghapus jejak terkait transaksi dari tampilan.
Pengaturan filter ini ditentukan di sub-menu Opsi Filter di bawah menu Tampilan.
Filter Kustom
Jika Anda terbiasa dengan Bahasa Jalur XML (JalurX), Anda dapat menggunakannya untuk membuat filter kustom untuk mencari data jejak untuk elemen XML yang menarik. Filter dapat diakses melalui toolbar filter.
Filter kustom dapat menyertakan parameter. Anda juga dapat mengimpor filter kustom yang sudah ada sebelumnya.
Membuat filter kustom
Filter dapat dibuat dengan dua cara:
Membuat Filter Kustom menggunakan Wizard Templat
Anda dapat mengklik jejak yang ada dan membuat filter berdasarkan struktur jejak. Contoh ini membuat filter kustom berdasarkan ID utas.
Di panel jejak di area kanan atas penampil, pilih jejak yang menyertakan elemen yang ingin Anda filter.
Klik tombol Buat Filter Kustom yang terletak di bagian atas panel jejak.
Dalam kotak dialog yang muncul, masukkan nama untuk filter Anda. Dalam contoh ini, masukkan
Thread ID. Anda juga dapat memberikan deskripsi filter Anda.Tampilan pohon di sebelah kiri menampilkan struktur rekaman jejak yang Anda pilih di langkah 1. Telusuri ke elemen yang ingin Anda buat kondisinya. Dalam contoh ini, telusuri ke ThreadID yang akan terletak di JalurX: node /E2ETraceEvent/System/Execution/@ThreadID. Klik dua kali atribut ThreadID dalam tampilan pohon. Ini membuat ekspresi untuk atribut di sebelah kanan dialog.
Ubah bidang parameter untuk kondisi ThreadID dari Tidak Ada menjadi '{0}'. Langkah ini memungkinkan nilai ThreadID dikonfigurasi saat filter diterapkan. (Lihat bagian Cara Menerapkan Filter) Anda dapat menentukan hingga empat parameter. Kondisi digabungkan menggunakan operator OR.
Klik Ok untuk membuat filter.
Catatan
Setelah filter dibuat menggunakan wizard templat, filter hanya dapat diedit secara manual. Tidak dimungkinkan untuk mengaktifkan wizard untuk filter yang telah dibuat sebelumnya. Selain itu, kondisi filter JalurX yang dibuat dalam wizard templat digabungkan menggunakan operator OR. Jika Anda memerlukan operasi AND, Anda dapat mengedit ekspresi filter setelah dibuat.
Membuat Filter Kustom Secara Manual
Menu Filter Kustom memungkinkan Anda memasukkan filter JalurX secara manual.
Di menu Tampilan, klik item menu Filter Kustom.
Dalam kotak dialog yang muncul, klik Baru.
Minimal, tentukan Nama Filter dan ekspresi JalurX.
Klik OK.
Menerapkan Filter Kustom
Setelah filter kustom dibuat, filter dapat diakses melalui toolbar filter. Pilih filter yang ingin Anda terapkan di bidang Pencarian Di toolbar filter. Untuk contoh sebelumnya, pilih 'ID Utas'.
Tentukan nilai yang Anda cari di bidang Temukan Apa. Dalam contoh kami, masukkan ID utas yang ingin Anda cari.
Klik Filter Sekarang, dan amati hasil operasi.
Jika filter Anda menggunakan beberapa parameter, masukkan menggunakan ';' sebagai pemisah di bidang Temukan Apa. Misalnya, string berikut menentukan 3 parameter: '1;findValue;text'. Penampil menerapkan '1' ke parameter {0} filter. 'findValue' dan 'teks' diterapkan ke {1} dan {2} masing-masing.
Berbagi Filter kustom
Filter kustom dapat dibagikan antara sesi yang berbeda dan pengguna yang berbeda. Anda dapat mengekspor filter ke file definisi dan mengimpor file ini di lokasi lain.
Untuk mengimpor filter kustom:
Di menu Tampilan, klik Filter Kustom.
Dalam kotak dialog yang terbuka, klik tombol Impor.
Navigasi ke file filter kustom (.stvcf), klik file, dan klik tombol Buka.
Untuk mengekspor filter kustom:
Di menu Tampilan, klik Filter Kustom.
Dalam kotak dialog yang terbuka, pilih filter yang ingin Anda ekspor.
Klik tombol Ekspor.
Tentukan nama dan lokasi file definisi filter kustom (.stvcf), dan klik tombol Simpan.
Catatan
Filter kustom ini hanya dapat diimpor dan diekspor dari Service Trace Viewer. Mereka tidak dapat dibaca oleh alat lain.
Menemukan Data
Penampil menyediakan cara berikut untuk menemukan data:
Toolbar Temukan menyediakan akses cepat ke opsi temukan yang paling umum.
Dialog Temukan menyediakan opsi temukan lainnya. Ini dapat diakses melalui menu Edit, atau dengan tombol cepat Ctrl + F.
Toolbar temukan muncul di bagian atas penampil. Jika tidak ada, Anda dapat mengaktifkannya di menu Tampilan. Bilahnya memiliki dua komponen:
Temukan Apa: Memungkinkan Anda memasukkan kata kunci pencarian.
Lihat Di: Memungkinkan Anda memasukkan cakupan pencarian. Anda dapat memilih apakah akan mencari di semua aktivitas atau hanya dalam aktivitas saat ini.
Dialog temukan menyediakan dua opsi tambahan:
Temukan target:
Opsi "Data log mentah" mencari kata kunci di semua data mentah.
Opsi "Teks XML" dan "Atribut XML" hanya mencari dalam elemen XML.
Opsi "Pesan Yang Dicatat" hanya mencari kata kunci dalam pesan.
Abaikan aktivitas akar: Pencarian mengabaikan jejak dalam aktivitas "000000000000". Ini meningkatkan performa dalam file jejak besar ketika aktivitas akar memiliki ribuan jejak, yang sebagian besar adalah transfer.
Menavigasi Jejak
Karena jejak direkam langkah demi langkah selama runtime bahasa umum aplikasi, menavigasi jejak dapat membantu Anda men-debug aplikasi Anda. Service Trace Viewer menyediakan berbagai cara untuk menavigasi dalam jejak.
Langkah Maju atau Mundur
Jika Anda menganggap setiap jejak sebagai baris kode dalam program, langkah maju sangat mirip dengan "Melangkah" di Visual Studio Integrated Development Environment (IDE) Visual Studio. Perbedaannya adalah Anda juga dapat melangkah mundur dalam jejak. Melangkah maju berarti berpindah ke jejak berikutnya dalam aktivitas.
Langkah Maju: Gunakan menu Aktivitas, atau tekan "F10". Anda juga dapat menggunakan tombol panah "turun" di panel jejak.
Langkah Mundur: Gunakan menu Aktivitas, atau tekan "F9". Anda juga dapat menggunakan tombol panah "naik" di panel jejak.
Catatan
Ini dapat membawa Anda ke aktivitas yang terjadi dalam proses yang berbeda atau bahkan pada komputer yang berbeda, karena pesan WCF dapat membawa ID aktivitas yang menjangkau mesin.
Ikuti Transfer
Jejak transfer adalah jejak khusus dalam file jejak. Aktivitas dapat ditransfer ke aktivitas lain dengan jejak transfer. Misalnya, "Aktivitas A" dapat ditransfer ke "Aktivitas B". Dalam kasus seperti itu, ada jejak transfer di "Aktivitas A" dengan nama "Ke: Aktivitas" dan ikon transfer. Jejak transfer ini adalah link antara dua jejak. Di "Aktivitas B", mungkin juga ada jejak transfer di akhir aktivitas untuk ditransfer kembali ke "Aktivitas A". Ini mirip dengan panggilan fungsi dalam program: Panggilan B, lalu B kembali.
"Ikuti transfer" mirip dengan "Masuki" dalam debugger. Ini mengikuti transfer dari A ke B. Ini tidak berpengaruh pada jejak lain.
Ada dua cara untuk mengikuti transfer: dengan mouse atau dengan keyboard:
Dengan Mouse: Klik dua kali jejak transfer di panel jejak.
Dengan Keyboard: Pilih jejak transfer, dan gunakan "Ikuti Transfer" di menu Aktivitas, atau tekan "F11"
Catatan
Dalam banyak kasus, saat Aktivitas A ditransfer ke Aktivitas B, Aktivitas A menunggu hingga Aktivitas B mentransfer kembali ke Aktivitas A. Ini berarti Aktivitas A tidak memiliki jejak yang dicatat selama periode saat Aktivitas B dilacak secara aktif. Namun, mungkin juga Aktivitas A tidak menunggu, dan terus mencatat jejak. Ada kemungkinan juga bahwa Aktivitas B tidak ditransfer kembali ke Aktivitas A. Oleh karena itu, transfer aktivitas masih berbeda dari panggilan fungsi dalam pengertian ini. Anda dapat memahami transfer aktivitas dengan lebih baik dalam tampilan Graph.
Langsung ke Transfer Berikutnya atau Sebelumnya
Saat Anda menganalisis aktivitas saat ini, atau aktivitas yang dipilih saat beberapa aktivitas dipilih, Anda mungkin ingin dengan cepat menemukan aktivitas yang ditransfernya. "Langsung ke transfer berikutnya" memungkinkan Anda menemukan jejak transfer berikutnya dalam aktivitas. Setelah menemukan jejak transfer, Anda dapat menggunakan "Ikuti transfer" untuk melangkah ke aktivitas berikutnya.
Langsung ke Transfer Berikutnya: Gunakan menu Aktivitas, atau tekan "Ctrl + F10".
Langsung ke Transfer Sebelumnya: Gunakan menu Aktivitas, atau tekan "Ctrl + F9".
Menavigasi dalam Tampilan Graph
Meskipun menavigasi di panel aktivitas dan panel jejak mirip dengan penelusuran kesalahan, menggunakan tampilan Graph memberikan pengalaman yang jauh lebih baik di navigasi. Lihat bagian "Tampilan Graph" untuk informasi selengkapnya.
Memuat File Jejak Besar
File jejak bisa sangat besar. Misalnya, jika Anda mengaktifkan jejak pada tingkat "Verbose", file jejak yang dihasilkan untuk menjalankan beberapa menit dapat dengan mudah menjadi ratusan megabyte atau bahkan lebih besar, tergantung pada kecepatan jaringan dan pola komunikasi.
Ketika Anda membuka file jejak yang sangat besar di Service Trace Viewer, performa sistem dapat berdampak negatif. Kecepatan pemuatan dan waktu respons setelah pemuatan bisa lambat. Kecepatan aktual berbeda dari waktu ke waktu, tergantung pada konfigurasi perangkat keras Anda. Di sebagian besar PC, memuat file jejak yang lebih besar dari 200M memiliki dampak performa yang parah. Untuk file jejak yang lebih besar dari 1G, alat ini dapat menggunakan semua memori yang tersedia, atau berhenti merespons untuk waktu yang sangat lama.
Untuk menghindari waktu pemuatan dan respons yang lambat dalam menganalisis file jejak besar, Service Trace Viewer menyediakan fitur yang disebut "Pemuatan Sebagian", yang hanya memuat sebagian kecil jejak dalam satu waktu. Misalnya, Anda mungkin memiliki file jejak lebih dari 1GB, berjalan selama beberapa hari di server. Ketika beberapa kesalahan telah terjadi dan Anda ingin menganalisis jejak, tidak perlu membuka seluruh file jejak. Sebagai gantinya, Anda dapat memuat jejak dalam jangka waktu tertentu ketika kesalahan mungkin telah terjadi. Karena cakupannya lebih kecil, alat Service Trace Viewer dapat memuat file lebih cepat dan Anda dapat mengidentifikasi kesalahan menggunakan sekumpulan data yang lebih kecil.
Mengaktifkan Pemuatan Sebagian
Anda tidak perlu mengaktifkan pemuatan sebagian secara manual. Jika ukuran total file jejak yang Anda coba muat melebihi 40 MB, Service Trace Viewer secara otomatis menampilkan dialog Pemuatan Sebagian agar Anda dapat memilih bagian yang ingin Anda muat.
Catatan
Karena jejak mungkin tidak didistribusikan secara merata dalam rentang waktu, panjang periode waktu yang Anda tentukan di toolbar Pemuatan Sebagian mungkin tidak sebanding dengan ukuran pemuatan yang ditampilkan. Ukuran pemuatan aktual bisa lebih kecil dari Estimasi Ukuran dalam dialog pemuatan sebagian.
Menyesuaikan Pemuatan Sebagian
Setelah Memuat sebagian file jejak, Anda mungkin ingin mengubah himpunan data yang sedang dimuat. Anda dapat melakukannya dengan menyesuaikan toolbar Pemuatan Sebagian di bagian atas penampil.
Pindahkan toolbar dengan mouse, atau masukkan waktu Mulai dan Selesai.
Klik tombol Sesuaikan.
Memahami Ikon Jejak
Berikut ini adalah daftar ikon yang digunakan alat Service Trace Viewer dalam tampilan Aktivitas, tampilan Graph dan panel Lacak untuk mewakili item yang berbeda.
Catatan
Beberapa jejak yang tidak dikategorikan (misalnya, "pesan ditutup") tidak memiliki ikon.
Jejak Pelacakan Aktivitas
| Ikon | Deskripsi |
|---|---|
 |
Jejak peringatan: Jejak yang dipancarkan pada tingkat peringatan |
 |
Jejak kesalahan: Jejak yang dipancarkan pada tingkat kesalahan. |
 |
Jejak Mulai Aktivitas: Jejak yang menandai awal aktivitas. Ini berisi nama aktivitas. Sebagai perancang atau pengembang aplikasi, Anda harus menentukan satu aktivitas Mulai jejak per id aktivitas per proses atau utas. Jika id aktivitas disebarkan di seluruh sumber pelacakan untuk korelasi pelacakan, Anda kemudian dapat melihat beberapa Mulai untuk id aktivitas yang sama (satu per sumber jejak). Jejak Mulai dipancarkan jika ActivityTracing diaktifkan untuk sumber jejak. |
 |
Jejak Perhentian Aktivitas: Jejak yang menandai akhir aktivitas. . Ini berisi nama aktivitas. Sebagai perancang atau pengembang aplikasi, Anda harus menentukan satu aktivitas Perhentian jejak per id aktivitas per sumber jejak. Tidak ada jejak dari sumber jejak tertentu yang muncul setelah aktivitas Perhentian dipancarkan oleh sumber jejak itu, kecuali jika granuralitas waktu jejak tidak cukup kecil. Ketika itu terjadi, dua jejak dengan waktu yang sama, termasuk Perhentian, dapat disisipkan saat ditampilkan. Jika id aktivitas disebarkan di seluruh sumber jejak untuk korelasi jejak, Anda dapat melihat beberapa Perhentian untuk id aktivitas yang sama (satu per sumber jejak). Jejak Perhentian dipancarkan jika ActivityTracing diaktifkan untuk sumber jejak. |
 |
Jejak Penangguhan Aktivitas: Jejak yang menandai waktu suatu aktivitas dijeda. Tidak ada jejak yang dipancarkan dalam aktivitas yang ditangguhkan hingga aktivitas dilanjutkan. Aktivitas yang ditangguhkan menunjukkan bahwa tidak ada pemrosesan yang terjadi dalam aktivitas tersebut dalam cakupan sumber jejak. Menangguhkan/Melanjutkan jejak berguna untuk pembuatan profil. Jejak Pengangguhan dipancarkan jika ActivityTracing diaktifkan untuk sumber jejak. |
 |
Jejak lanjutan aktivitas: Jejak yang menandai waktu aktivitas dilanjutkan setelah ditangguhkan. Jejak dapat dipancarkan lagi dalam aktivitas tersebut. Menangguhkan/Melanjutkan jejak berguna untuk pembuatan profil. Jejak Lanjutkan dipancarkan jika ActivityTracing diaktifkan untuk sumber jejak. |
 |
Transfer: Jejak yang dipancarkan saat alur kontrol logis ditransfer dari satu aktivitas ke aktivitas lainnya. Aktivitas tempat transfer berasal dapat terus melakukan pekerjaan secara paralel dengan aktivitas yang dialihkan transfer. Jejak Transfer dipancarkan jika ActivityTracing diaktifkan untuk sumber jejak. |
 |
Transfer Dari: Jejak yang menentukan transfer dari aktivitas lain ke aktivitas saat ini. |
 |
Transfer Ke: Jejak yang menentukan transfer alur kontrol logis dari aktivitas saat ini ke aktivitas lain. |
Jejak WCF
| Ikon | Deskripsi |
|---|---|
 |
Jejak Log Pesan: Jejak yang dipancarkan saat pesan WCF dicatat oleh fitur pengelogan pesan, saat sumber jejak System.ServiceModel.MessageLogging diaktifkan. Mengklik jejak ini akan menampilkan pesan. Ada empat titik pengelogan yang dapat dikonfigurasi untuk pesan: ServiceLevelSendRequest, TransportSend, TransportReceive, dan ServiceLevelReceiveRequest, yang juga dapat ditentukan oleh atribut messageSource dalam jejak log pesan. |
 |
Jejak Yang Diterima Pesan: Jejak yang dipancarkan saat pesan WCF diterima, jika sumber jejak System.ServiceModel diaktifkan di tingkat Informasi atau Verbose. Jejak ini sangat penting untuk melihat panah korelasi pesan dalam tampilan Graph Aktivitas. |
 |
Jejak Terkirim Pesan: Jejak yang dipancarkan saat pesan WCF dikirim jika sumber jejak System.ServiceModel diaktifkan di tingkat Informasi atau Verbose. Jejak ini sangat penting untuk melihat panah korelasi pesan dalam tampilan Graph Aktivitas. |
Aktivitas
| Ikon | Deskripsi |
|---|---|
 |
Aktivitas: Menunjukkan bahwa aktivitas saat ini adalah aktivitas generik. |
 |
Aktivitas akar: Menunjukkan aktivitas akar proses. |
Aktivitas WCF
| Ikon | Deskripsi |
|---|---|
 |
Aktivitas lingkungan: Aktivitas yang membuat, membuka, atau menutup host atau klien WCF. Kesalahan yang telah terjadi selama fase ini akan muncul dalam aktivitas ini. |
 |
Aktivitas mendengarkan: Aktivitas yang mencatat jejak yang terkait dengan pendengar. Di dalam aktivitas ini, kita dapat melihat informasi pendengar dan permintaan koneksi. |
 |
Aktivitas Terima Byte: Aktivitas yang mengelompokkan semua jejak yang terkait dengan penerimaan byte masuk pada koneksi antara dua titik akhir. Aktivitas ini sangat penting dalam berkorelasi dengan aktivitas transportasi yang menyebarluaskan id aktivitasnya seperti http.sys. Kesalahan koneksi seperti batalkan akan muncul dalam aktivitas ini. |
 |
Aktivitas Pesan Proses: Aktivitas yang mengelompokkan jejak yang terkait dengan pembuatan pesan WCF. Kesalahan karena amplop yang buruk atau pesan cacat akan muncul dalam aktivitas tersebut. Di dalam aktivitas ini, kita dapat memeriksa header pesan untuk melihat apakah id aktivitas disebarluaskan dari pemanggil. Jika ini benar, ketika kita mentransfer ke aktivitas Tindakan Proses (ikon berikutnya), kita juga dapat menetapkan ke aktivitas tersebut id aktivitas yang disebarkan untuk korelasi antara pemanggil dan jejak penerima panggilan. |
|
Aktivitas Tindakan Proses: Aktivitas yang mengelompokkan semua jejak yang terkait dengan permintaan WCF di dua titik akhir. Jika propagateActivity diatur ke true pada kedua titik akhir dalam konfigurasi, semua jejak dari kedua titik akhir digabungkan menjadi satu aktivitas untuk korelasi langsung. Aktivitas tersebut akan berisi kesalahan karena pemrosesan transportasi atau keamanan, meluas ke batas kode pengguna dan kembali (jika respons ada). |
|
Aktivitas Jalankan Kode Pengguna: Aktivitas yang mengelompokkan jejak kode pengguna untuk memroses permintaan. |
Pemecahan Masalah
Jika Anda tidak memiliki izin untuk menulis ke registri, Anda mendapatkan pesan kesalahan berikut "Microsoft Service Trace Viewer tidak terdaftar ke sistem" ketika Anda menggunakan perintah "svctraceviewer /register" untuk mendaftarkan alat. Jika ini terjadi, Anda harus masuk menggunakan akun yang memiliki akses tulis ke registri.
Selain itu, alat Service Trace Viewer menulis beberapa pengaturan (misalnya, filter kustom dan opsi filter) ke file SvcTraceViewer.exe.settings di folder rakitannya. Jika Anda tidak memiliki izin baca untuk file, Anda masih dapat meluncurkan alat, tetapi Anda tidak dapat memuat pengaturan.
Jika Anda mendapatkan pesan kesalahan "Terjadi kesalahan yang tidak diketahui saat memroses satu atau beberapa jejak" saat membuka file .etl, itu berarti bahwa format file .etl tidak valid.
Jika Anda membuka log jejak yang dibuat menggunakan sistem operasi Arab, Anda mungkin melihat bahwa filter waktu tidak berfungsi. Misalnya, tahun 2005 sesuai dengan tahun 1427 dalam kalender Arab. Namun, rentang waktu yang didukung oleh filter alat Service Trace Viewer tidak mendukung tanggal yang lebih awal dari 1752. Ini dapat menyiratkan bahwa Anda tidak dapat memilih tanggal yang benar dalam filter. Untuk mengatasi masalah ini, Anda dapat membuat filter kustom (Lihat/Filter Kustom) menggunakan ekspresi JalurX untuk menyertakan rentang waktu tertentu.