Mengakses data pelacakan

.NET TraceProcessing tersedia dari NuGet dengan ID paket berikut:

Microsoft.Windows.EventTracing.Processing.All

Paket ini memungkinkan Anda mengakses data dalam file pelacakan. Jika Anda belum memiliki file pelacakan, Anda bisa menggunakan Perekam Performa Windows untuk membuatnya.

Contoh aplikasi konsol berikut menunjukkan cara mengakses baris perintah dari semua proses yang terkandung dalam jejak:

using Microsoft.Windows.EventTracing;
using Microsoft.Windows.EventTracing.Processes;
using System;

class Program
{
    static void Main(string[] args)
    {
        if (args.Length != 1)
        {
            Console.Error.WriteLine("Usage: <trace.etl>");
            return;
        }

        using (ITraceProcessor trace = TraceProcessor.Create(args[0]))
        {
            IPendingResult<IProcessDataSource> pendingProcessData = trace.UseProcesses();

            trace.Process();

            IProcessDataSource processData = pendingProcessData.Result;

            foreach (IProcess process in processData.Processes)
            {
                Console.WriteLine(process.CommandLine);
            }
        }
    }
}

Menggunakan TraceProcessor

Untuk memproses jejak, panggil TraceProcessor.Create. Antarmuka intinya adalah ITraceProcessor, dan menggunakan antarmuka ini melibatkan pola berikut:

1. Pertama, beri tahu prosesor data apa yang ingin Anda gunakan dari jejak
2. Kedua, proses jejak; dan
3. Terakhir, akses hasilnya.

Memberi tahu prosesor jenis data apa yang Anda inginkan di depan berarti Anda tidak perlu menghabiskan waktu untuk memproses volume besar dari semua jenis data pelacakan yang mungkin. Sebagai gantinya, TraceProcessor hanya melakukan pekerjaan yang diperlukan untuk menyediakan jenis data tertentu yang Anda minta.

Pengaturan proyek yang direkomendasikan

Ada beberapa pengaturan proyek yang sebaiknya kami gunakan dengan TraceProcessor:

1. Sebaiknya jalankan exes sebagai 64-bit.

   Default Visual Studio untuk aplikasi konsol C# .NET Framework baru adalah CPU apa pun dengan Prefer 32-bit diperiksa. Default untuk .NET mungkin sudah memiliki pengaturan yang direkomendasikan.

   Pemrosesan pelacakan dapat intensif memori, terutama dengan jejak yang lebih besar, dan sebaiknya ubah target Platform ke x64 (atau hapus centang Prefer 32-bit) dalam exes yang menggunakan TraceProcessor. Untuk mengubah pengaturan ini, lihat tab Build di bawah Properti untuk proyek. Untuk mengubah pengaturan ini untuk semua konfigurasi, pastikan bahwa dropdown Konfigurasi diatur ke Semua Konfigurasi, bukan default konfigurasi saat ini saja.

2. Sebaiknya gunakan NuGet dengan mode PackageReference gaya yang lebih baru daripada mode packages.config yang lebih lama.

   Untuk mengubah default untuk proyek baru, lihat Alat, Pengelola Paket NuGet, Pengaturan Manajer Paket, Manajemen Paket, Format manajemen paket default.

Sumber data bawaan

File .etl dapat mengambil banyak jenis data dalam pelacakan. Perhatikan bahwa data mana yang ada dalam file .etl tergantung pada penyedia apa yang diaktifkan saat jejak diambil. Daftar berikut ini memperlihatkan jenis data pelacakan yang tersedia dari TraceProcessor:

Lihat juga metode ekstensi di ITraceSource untuk semua data pelacakan yang tersedia, atau periksa metode yang tersedia dari "jejak." yang ditunjukkan oleh IntelliSense.

Langkah berikutnya

Dalam gambaran umum ini, Anda mempelajari cara mengakses data pelacakan menggunakan TraceProcessor dan sumber data bawaan yang dapat diaksesnya.

Langkah selanjutnya adalah mempelajari cara memperluas TraceProcessor untuk mengakses data pelacakan kustom.