Bagikan melalui

Mengontrol Pengelogan .NET Framework

  • Artikel

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 merekam informasi peristiwa CLR, penyedia CLR harus diinstal di komputer Anda. Untuk mengonfirmasi bahwa penyedia telah diinstal, ketik logman query providers pada 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 Wevtutil Windows. Buka jendela Wantian 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 perintah, ketik perintah berikut untuk menginstal penyedia CLR:

wevtutil im CLR-ETW.man

Merekam Peristiwa CLR ETW

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

Untuk mengaktifkan pengelogan, pengguna harus menentukan tiga hal:

  • Penyedia untuk berkomunikasi.

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

  • Sejumlah kecil mewakili level (verbositas) untuk login. Level 1 adalah yang paling tidak banyak kata, dan level 5 adalah yang paling banyak kata. Level 0 adalah default yang artinya khusus penyedia.

Untuk merekam peristiwa 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 dimunculkan.

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

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

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

  2. Untuk berhenti mencatat peristiwa, ketikkan:

    logman stop clrevents -ets

    Perintah ini membuat file jejak biner bernama clrevents.etl.

Untuk merekam peristiwa CLR ETW menggunakan Xperf

  1. Pada command prompt, ketik:

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

    ketika GUID adalah GUID penyedia CLR ETW, dan 0x1CCBD:5 melacak semuanya pada dan di bawah level 5 (verbose).

  2. Untuk berhenti melacak, ketikkan:

    Xperf -stop clr

    Perintah ini membuat file jejak bernama clrevents.etl.

Melihat Peristiwa CLR ETW

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

Untuk melihat peristiwa 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 kejadian, dan summary.txt menyediakan ringkasan kejadian.

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 Umum. Untuk menampilkan kisi data peristiwa yang dikategorikan menurut jenisnya, 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 membuang 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 tajuk mana yang harus digunakan untuk menentukan bidang lainnya.

Lihat juga