Bagikan melalui

Mengontrol Pengelogan .NET Framework

Anda dapat menggunakan pelacakan peristiwa untuk Windows (ETW) untuk merekam peristiwa runtime bahasa umum (CLR). Anda dapat membuat dan melihat jejak dengan menggunakan alat berikut:

Untuk mengumpulkan informasi acara CLR, penyedia CLR harus diinstal di komputer Anda. Untuk mengonfirmasi bahwa penyedia diinstal, ketik logman query providers pada prompt perintah. Daftar penyedia ditampilkan. Daftar ini harus berisi entri untuk penyedia CLR, sebagai berikut.

Provider                                 GUID
-------------------------------------------------------------------------------
.NET Common Language Runtime    {E13C0D23-CCBC-4E12-931B-D9CC2EEE27E4}.

Jika penyedia CLR tidak terdaftar, Anda dapat menginstalnya di Windows Vista dan sistem operasi yang lebih baru dengan menggunakan alat baris perintah Windows Wevtutil . Buka jendela Prompt Perintah sebagai administrator. Ubah direktori prompt ke folder .NET Framework 4 (%WINDIR%\Microsoft.NET\Framework[64]\v4.<.NET version>\ ). Folder ini berisi file CLR-ETW.man. Pada prompt perintah, ketik perintah berikut untuk menginstal penyedia CLR:

wevtutil im CLR-ETW.man

Menangkap Acara CLR ETW

Anda dapat menggunakan alat baris perintah Logman dan Xperf untuk menangkap peristiwa ETW, dan alat Tracerpt dan Xperf untuk mendekode peristiwa pelacakan.

Untuk mengaktifkan pengelogan, pengguna harus menentukan tiga hal:

  • Penyedia yang harus dikomunikasikan.

  • Angka 64-bit yang mewakili sekumpulan kata kunci. Setiap kata kunci mewakili sekumpulan peristiwa yang dapat diaktifkan penyedia. Angka mewakili sekumpulan kata kunci gabungan untuk diaktifkan.

  • Angka kecil yang menunjukkan tingkat (verbositas) untuk masuk. Tingkat 1 adalah yang paling sedikit kata-kata, dan tingkat 5 adalah yang paling terperinci. Tingkat 0 adalah default yang maknanya khusus untuk penyedia.

Untuk merekam kejadian CLR ETW menggunakan Logman

  1. Pada command prompt, ketik:

    logman start clrevents -p {e13c0d23-ccbc-4e12-931b-d9cc2eee27e4} 0x1CCBD 0x5 -ets -ct perf

    di mana:

    • Parameter -p mengidentifikasi GUID penyedia.

    • 0x1CCBD menentukan kategori peristiwa yang akan dipicu.

    • 0x5 mengatur tingkat pengelogan (dalam hal ini, verbose (5)).

    • Parameter -ets menginstruksikan Logman untuk mengirim perintah ke sesi pelacakan peristiwa.

    • Parameter -ct perf menentukan bahwa QueryPerformanceCounter fungsi akan digunakan untuk mencatat stempel waktu untuk setiap peristiwa.

  2. Untuk berhenti mencatat peristiwa, ketik:

    logman stop clrevents -ets

    Perintah ini membuat file pelacakan biner bernama clrevents.etl.

Untuk menangkap peristiwa CLR ETW menggunakan Xperf

  1. Pada command prompt, ketik:

    xperf -start clr -on e13c0d23-ccbc-4e12-931b-d9cc2eee27e4:0x1CCBD:5 -f clrevents.etl

    GUID yang dimaksud adalah GUID penyedia CLR ETW, dan 0x1CCBD:5 melacak semua pada tingkat 5 (verbose) dan di bawahnya.

  2. Untuk menghentikan pelacakan, ketik:

    Xperf -stop clr

    Perintah ini membuat file pelacakan bernama clrevents.etl.

Melihat Acara CLR ETW

Gunakan perintah yang tercantum di bawah ini untuk melihat peristiwa CLR ETW. Untuk deskripsi peristiwa, lihat Peristiwa CLR ETW.

Untuk melihat event CLR ETW menggunakan Tracerpt

  • Pada command prompt, ketik:

    tracerpt clrevents.etl

    Perintah ini membuat dua file: dumpfile.xml dan summary.txt. File dumpfile.xml mencantumkan semua peristiwa, dan summary.txt menyediakan ringkasan peristiwa.

Untuk melihat peristiwa CLR ETW menggunakan Xperf

  • Pada command prompt, ketik:

    xperf clrevents.etl

    Perintah ini membuka penampil file Xperf ETL. Dalam penampil ini, peristiwa CLR muncul di tampilan Peristiwa Generik . Untuk menampilkan kisi data peristiwa yang dikategorikan menurut jenis, pilih wilayah waktu dalam tampilan ini, lalu klik kanan dan pilih Ringkasan.

Untuk mengonversi file .etl ke file nilai yang dipisahkan koma

  • Pada command prompt, ketik:

    xperf -i clrevents.etl -f clrevents.csv

    Perintah ini menyebabkan XPerf mencadangkan peristiwa sebagai file nilai yang dipisahkan koma (CSV) yang dapat Anda lihat. Karena peristiwa yang berbeda memiliki bidang yang berbeda, file CSV ini berisi lebih dari satu baris header sebelum data. Bidang pertama dari setiap baris adalah jenis peristiwa, yang menunjukkan header mana yang harus digunakan untuk menentukan bidang lainnya.

Lihat juga

  • Last updated on