Fitur IntelliTrace (C#, Visual Basic, C++)

Artikel
03/10/2023

Anda dapat menggunakan IntelliTrace untuk merekam peristiwa dan metode yang memanggil aplikasi Anda, yang memungkinkan Anda memeriksa statusnya (nilai variabel lokal dan tumpukan panggilan) di titik yang berbeda dalam eksekusi. Cukup mulai penelusuran kesalahan seperti biasa - IntelliTrace diaktifkan secara default dan Anda dapat melihat informasi yang direkam IntelliTrace di jendela Alat Diagnostik baru di bagian tab Peristiwa. Pilih peristiwa dan klik Aktifkan Penelusuran Kesalahan Historis untuk melihat tumpukan panggilan dan lokal yang direkam terkait peristiwa ini.

Untuk deskripsi langkah demi langkah, lihat Panduan: Menggunakan IntelliTrace.

IntelliTrace tersedia dalam Visual Studio edisi Enterprise, tetapi tidak di edisi Visual Studio Professional atau Community.

Untuk mengonfirmasi bahwa IntelliTrace diaktifkan, buka halaman opsi Opsi > Alat > IntelliTrace. Aktifkan IntelliTrace seharusnya tercentang secara default.

Catatan

Cakupan dari semua pengaturan pada halaman opsi IntelliTrace adalah Visual Studio secara keseluruhan, bukan proyek atau solusi individual. Perubahan pada pengaturan ini berlaku untuk semua instans Visual Studio, semua sesi penelusuran kesalahan, dan semua proyek atau solusi.

Memilih peristiwa yang dicatat IntelliTrace (C#, Visual Basic)

Anda dapat mengaktifkan atau menonaktifkan perekaman untuk peristiwa IntelliTrace tertentu.

Jika Anda menelusuri kesalahan, hentikan penelusuran kesalahan. Buka Alat > Opsi > IntelliTrace > Peristiwa IntelliTrace. Pilih peristiwa yang Anda inginkan untuk direkam IntelliTrace.

Mengumpulkan snapshot (C#, Visual Basic, C++)

Kemampuan ini tidak diaktifkan secara default, tetapi IntelliTrace dapat mengambil snapshot aplikasi Anda di setiap titik henti dan peristiwa langkah debugger, dan Anda dapat melihat snapshot ini di sesi penelusuran kesalahan historis. Snapshot memberi Anda tampilan status aplikasi lengkap Anda. Untuk mengaktifkan pengambilan snapshot, buka Alat > Opsi > IntelliTrace > Umum, dan pilih Snapshot IntelliTrace (terkelola dan asli). Untuk informasi selengkapnya, lihat Memeriksa status aplikasi sebelumnya menggunakan IntelliTrace.

Snapshot tersedia di Visual Studio Enterprise 2017 versi 15.5 dan yang lebih tinggi, serta memerlukan Windows 10 Anniversary Update atau yang lebih tinggi. Untuk aplikasi .NET Core dan ASP.NET Core, diperlukan Visual Studio Enterprise 2017 versi 15.7. Untuk aplikasi asli yang menargetkan Windows, diperlukan Visual Studio Enterprise 2017 versi 15.9 Pratinjau 2.

Mengumpulkan informasi panggilan dan peristiwa IntelliTrace (C#, Visual Basic)

Kemampuan ini tidak diaktifkan secara default, tetapi IntelliTrace dapat merekam panggilan metode bersama dengan peristiwa. Untuk mengaktifkan pengumpulan panggilan metode, buka Alat > Opsi > IntelliTrace > Umum, dan pilih Informasi panggilan dan peristiwa IntelliTrace (hanya terkelola).

Informasi panggilan saat ini tidak tersedia untuk aplikasi ASP.NET Core dan .NET Core.

Hal ini memungkinkan Anda melihat riwayat tumpukan panggilan dan melangkah mundur juga maju melalui panggilan dalam kode Anda. IntelliTrace merekam data seperti nama metode, entri metode dan titik keluar, serta nilai parameter tertentu dan nilai yang ditampilkan.

Tip

Opsi ini tidak diaktifkan secara default karena menambah overhead yang cukup besar. IntelliTrace tidak hanya harus mencegat setiap metode yang dilakukan aplikasi Anda, tetapi juga harus berurusan dengan sekumpulan data yang jauh lebih besar dalam hal menampilkannya di layar atau mempertahankannya ke disk.

Anda dapat mengurangi overhead performa dengan membatasi daftar peristiwa yang dicatat IntelliTrace dan dengan menjaga jumlah modul yang Anda kumpulkan tetap minimal. Untuk informasi selengkapnya, lihat Mengontrol berapa banyak informasi panggilan yang direkam IntelliTrace.

Anda dapat menggunakan gutter navigasi yang muncul di sebelah kiri jendela kode. Jika Anda tidak melihat gutter navigasi, buka Alat > Opsi > IntelliTrace > Tingkat Lanjut, dan pilih Tampilkan gutter navigasi saat dalam mode debug.

Gutter navigasi memungkinkan Anda untuk bergerak maju dan mundur melalui panggilan metode dan peristiwa dalam mode penelusuran kesalahan historis. Untuk informasi selengkapnya tentang penelusuran kesalahan historis, lihat Penelusuran Kesalahan Historis. Gutter navigasi memiliki sejumlah perintah:

Perintah	Deskripsi
Set Debugger Context Here	Mengatur konteks penelusuran kesalahan ke jangka waktu panggilan tempatnya muncul. Ikon ini hanya muncul pada tumpukan panggilan saat ini.
Return to Call Site	Memindahkan konteks penelusuran kesalahan dan penunjuk kembali ke tempat fungsi saat ini dipanggil. Jika Anda berada dalam mode Penelusuran Kesalahan Langsung, perintah ini akan mengaktifkan Penelusuran Kesalahan Historis. Jika Anda kembali ke jeda eksekusi asli, Penelusuran Kesalahan Historis dinonaktifkan dan Penelusuran Kesalahan Langsung diaktifkan.
Go to Previous Call or IntelliTrace Event	Memindahkan konteks penelusuran kesalahan dan penunjuk kembali ke panggilan atau peristiwa sebelumnya. Jika Anda berada dalam mode Penelusuran Kesalahan Langsung, perintah ini akan mengaktifkan Penelusuran Kesalahan Historis.
Step In	Masuk ke fungsi yang saat ini dipilih. Perintah ini hanya tersedia saat Anda berada dalam mode Penelusuran Kesalahan Historis.
Go to Next Call or IntelliTrace Event	Memindahkan konteks penelusuran kesalahan dan penunjuk ke panggilan atau peristiwa berikutnya tempat data IntelliTrace berada. Perintah ini hanya tersedia saat Anda berada dalam mode Penelusuran Kesalahan Historis.
Go to Live Mode	Kembali ke mode Penelusuran Kesalahan Langsung.

Mencari baris atau metode di IntelliTrace

Anda hanya dapat mencari metode ketika informasi panggilan metode telah diaktifkan. Anda dapat mencari riwayat IntelliTrace untuk baris atau metode tertentu. Saat eksekusi debugger dihentikan, klik kanan di dalam isi fungsi untuk melihat menu konteks, dan klik Cari Line Ini Di IntelliTrace atau Cari Metode Ini Di IntelliTrace.

Mengontrol berapa banyak informasi panggilan yang direkam IntelliTrace

Secara default IntelliTrace merekam informasi untuk semua modul yang digunakan solusi Anda. Anda dapat mengatur IntelliTrace agar hanya merekam informasi panggilan untuk modul yang Anda inginkan. Di Alat > Opsi > IntelliTrace > Modul, Anda dapat menentukan modul yang akan disertakan atau modul yang akan dikecualikan dari IntelliTrace. IntelliTrace hanya akan mengumpulkan peristiwa yang berasal dari modul yang telah Anda tentukan dan panggilan metode yang terjadi dalam modul yang Anda inginkan.

Untuk menambahkan beberapa modul, gunakan wildcard * di awal atau akhir string. Untuk nama modul, gunakan nama file, bukan nama assembly. Jalur file tidak diterima.

Cobalah untuk menjaga jumlah modul tetap minimal. Anda mendapatkan performa yang lebih baik karena ada lebih sedikit data yang akan dikumpulkan. Anda juga mendapatkan lebih sedikit kebisingan di UI karena ada lebih sedikit data yang harus dilalui.

Menyimpan data IntelliTrace ke file (C#, Visual Basic, C++)

Anda dapat menyimpan data yang telah dikumpulkan IntelliTrace dengan membuka Debug > IntelliTrace > Simpan Sesi IntelliTrace saat Anda melakukan penelusuran kesalahan dan aplikasi dalam status jeda. Item menu nonaktif dan Anda tidak akan dapat menyimpan data yang dikumpulkan IntelliTrace jika aplikasi masih berjalan atau jika Anda telah menghentikan penelusuran kesalahan.

Anda dapat mengonfigurasi IntelliTrace untuk menyimpan secara otomatis ke file dengan membuka Opsi > Alat > IntelliTrace > Tingkat Lanjut dan memilih Simpan rekaman IntelliTrace di direktori ini. Anda juga dapat mengonfigurasi ukuran yang ditetapkan untuk file yang dihasilkan, yang menyebabkan IntelliTrace menimpa data yang lebih lama saat kehabisan ruang. Visual Studio membuat dua file untuk setiap sesi IntelliTrace saat disimpan secara otomatis dan proses hosting Visual Studio (vshost.exe) diaktifkan.

Tip

Untuk menghemat ruang disk, nonaktifkan penyimpanan file secara otomatis saat Anda tidak membutuhkannya lagi. File yang ada tidak akan dihapus. Anda selalu dapat menyimpan ke file sesuai permintaan dari menu konteks.

Saat Anda menyimpan data IntelliTrace ke file, Anda mendapatkan satu file .itrace untuk setiap proses yang dikumpulkan IntelliTrace. Anda kemudian dapat membuka file .itrace di Visual Studio dengan membuka File > Buka > File dan memilih file .itrace dari dialog Buka File. Untuk informasi selengkapnya, lihat Menggunakan data IntelliTrace yang tersimpan.