Konsep TraceView

Topik ini menjelaskan konsep yang digunakan dalam TraceView.

Untuk informasi tentang konsep yang umum untuk alat pelacakan di WDK, lihat Konsep Alat Pelacakan.

Penelusuran Grup Sesi

TraceView memungkinkan Anda menggabungkan tampilan log jejak atau sesi pelacakan real time ke dalam grup sesi pelacakan dan mengelolanya seolah-olah mereka adalah satu sesi. Saat log atau sesi jejak berada dalam grup sesi pelacakan yang sama, pesan mereka digabungkan dalam satu daftar pesan pelacakan.

Secara default, setiap sesi lacak adalah anggota grup sesi lacak yang hanya mencakup sesi lacak tersebut.

Untuk informasi tentang membuat grup sesi pelacakan, lihat Mengelompokkan Sesi Pelacakan.

Workspace

Di TraceView, ruang kerja adalah sekumpulan properti sesi pelacakan dan properti tampilan log pelacakan yang dapat Anda simpan dan gunakan kembali. Dengan ruang kerja, Anda dapat menampilkan log yang sering digunakan atau memulai sesi pelacakan yang dikonfigurasi dengan hati-hati dalam satu langkah cepat.

Ruang kerja mencakup:

• Semua properti sesi pelacakan, termasuk buffer, tanda dan tingkatnya, serta lokasi log pelacakan.

• Lokasi file simbol database program (PDB), file format pesan pelacakan (TMF), atau jalur pencarian TMF

• Jalur dan nama file daftar TraceView dan file ringkasan

• Filter

Saat Anda membuka ruang kerja untuk sesi pelacakan real time, TraceView memulai sesi pelacakan baru dengan properti dan pengaturan konfigurasi yang disimpan. Saat Anda membuka ruang kerja untuk tampilan log pelacakan, log muncul persis seperti yang telah Anda konfigurasikan.

Untuk informasi selengkapnya, lihat Menggunakan Ruang Kerja TraceView.

Menentukan Penyedia Pelacakan

Untuk membuat sesi pelacakan, Anda harus mengidentifikasi penyedia pelacakan dan menemukan instruksi pemformatan untuk pesan pelacakan biner yang dihasilkan penyedia. Anda dapat melakukan ini salah satu cara berikut:

• Temukan biner yang dapat dieksekusi untuk kode sumber yang mendukung penyedia. TraceView dapat mengekstrak semua informasi yang diperlukan untuk mengaktifkan dan memformat peristiwa TraceLogging dan ETW yang dimanifestasikan. Ini juga akan mencoba menemukan file simbol PDB untuk mengaktifkan penyedia Pelacakan Perangkat Lunak WPP.

• Temukan file simbol PDB untuk kode sumber yang mencakup penyedia Penelusuran Perangkat Lunak WPP. TraceView dapat mengekstrak dari file PDB semua informasi yang diperlukan untuk mengidentifikasi penyedia dan memformat pesan pelacakan mereka.

• Temukan file GUID kontrol (.ctl) untuk penyedia dan tentukan file TMF atau jalur ke direktori di mana file TMF disimpan.

• Masukkan GUID kontrol penyedia dan tentukan file TMF atau jalur ke direktori tempat file TMF disimpan.

  Jika Anda memasukkan nama penyedia yang didahului oleh tanda bintang (misalnya *SampleProvider), TraceView akan secara otomatis mengubah nama menjadi GUID menggunakan algoritma standar. Tidak semua penyedia mengikuti standar ini, tetapi banyak, seperti penyedia yang ditulis menggunakan .NET's EventSource Class, melakukannya.

• Pilih penyedia terdaftar dari daftar yang dirakitan TraceView dan tentukan file TMF atau jalur ke direktori tempat file TMF disimpan.

• Pilih Sesi Pelacakan Pencatat Kernel NT, lalu pilih satu atau beberapa peristiwa sistem operasi untuk dilacak.

Atur Jalur Pencarian TMF dan Pilih Opsi File TMF

Saat mengaktifkan penyedia WPP, kecuali Anda memiliki file simbol PDB untuk penyedia, Anda harus menentukan direktori di mana TraceView dapat menemukan file TMF atau harus menemukan file TMF untuk pesan jejak penyedia.

TraceView mendukung dua metode:

• Gunakan opsi Atur Jalur Pencarian TMF saat Anda tidak yakin file TMF mana yang akan digunakan untuk penyedia pelacakan. TraceView memeriksa semua file TMF di direktori yang ditentukan dan mencocokkan GUID pesan yang dihasilkan dengan nama file TMF. File TMF harus terletak di direktori yang ditentukan. TraceView tidak mencari secara rekursif.

• Gunakan opsi Pilih file TMF saat Anda mengetahui file TMF mana yang akan digunakan untuk penyedia pelacakan, atau ketika file TMF yang Anda butuhkan berada di direktori yang berbeda. Anda juga harus menggunakan opsi ini jika nama file TMF bukan GUID pesan, karena TraceView tidak dapat menemukannya di direktori.

Jika file TMF yang ditentukan atau yang ditemukan TraceView di direktori yang ditentukan tidak cocok dengan pesan pelacakan yang dihasilkan oleh penyedia pelacakan, TraceView tidak dapat memformat pesan. Sebaliknya, ini menampilkan GUID pesan pelacakan dan pesan kesalahan berikut:

No Format Information found.

Untuk membuat file TMF dari file simbol PDB, di jendela Prompt Perintah, gunakan Tracepdb.