Mendebug aplikasi ASP.NET Azure langsung dengan menggunakan Snapshot Debugger

Snapshot Debugger mengambil snapshot dari aplikasi dalam produksi Anda saat kode yang Anda minati dijalankan. Untuk menginstruksikan debugger untuk mengambil snapshot, Anda mengatur snappoints dan logpoints dalam kode Anda. Debugger memungkinkan Anda melihat dengan tepat apa yang salah, tanpa memengaruhi lalu lintas aplikasi produksi Anda. Snapshot Debugger dapat membantu Anda secara dramatis mengurangi waktu yang diperlukan untuk menyelesaikan masalah yang terjadi di lingkungan produksi.

Snappoint dan logpoint mirip dengan titik henti, tetapi tidak seperti titik henti, snappoint tidak menghentikan aplikasi saat tercapai. Biasanya, menangkap snapshot di snappoint membutuhkan waktu 10-20 milidetik.

Dalam tutorial ini, Anda akan:

• Mulai Snapshot Debugger
• Mengatur snappoint dan lihat snapshot
• Mengatur logpoint

Prasyarat

• Snapshot Debugger hanya tersedia mulai dari Visual Studio 2017 Enterprise versi 15.5 atau lebih tinggi dengan beban kerja pengembangan Azure. (Di bawah tab Komponen individu, Anda menemukannya di bawah Penelusuran kesalahan dan pengujian>Snapshot debugger.)

  Jika belum diinstal, instal Visual Studio 2019. Jika Anda memperbarui dari penginstalan Visual Studio sebelumnya, jalankan Penginstal Visual Studio dan periksa komponen Snapshot Debugger di ASP.NET dan beban kerja pengembangan web.

• Paket Azure App Service dasar atau lebih tinggi.

• Kumpulan snapshot tersedia untuk aplikasi web berikut yang berjalan di Azure App Service:

  • Aplikasi ASP.NET berjalan pada .NET Framework 4.6.1 atau yang lebih baru.
  • Aplikasi ASP.NET Core berjalan di .NET Core 2.0 atau yang lebih baru di Windows.

Buka proyek Anda dan mulai Snapshot Debugger

1. Buka proyek yang ingin Anda snapshot debug.

   Penting

   Untuk snapshot debug, Anda perlu membuka versi kode sumber yang sama yang diterbitkan ke Azure App Service Anda.

2. Pilih Debug > Lampirkan Snapshot Debugger.... Pilih Azure App Service yang digunakan proyek Anda dan akun penyimpanan Azure, lalu klik Lampirkan. Snapshot Debugger juga mendukung Azure Kubernetes Service dan Azure Virtual Machines (VM) & Virtual Machine Scale Sets.

   

   

   Penting

   Saat Anda pertama kali memilih Lampirkan Snapshot Debugger, Anda akan diminta untuk menginstal ekstensi situs Snapshot Debugger di Azure App Service Anda. Penginstalan ini memerlukan hidupkan ulang Azure App Service Anda.

   Catatan

   (Visual Studio 2019 versi 16.2 dan di atasnya) Snapshot Debugger telah mengaktifkan dukungan cloud Azure. Pastikan sumber daya Azure dan akun Azure Storage yang Anda pilih berasal dari cloud yang sama. Silakan hubungi administrator Azure Anda jika Anda memiliki pertanyaan tentang konfigurasi kepatuhan Azure enterprise Anda.

   Visual Studio sekarang dalam mode penelusuran kesalahan snapshot.

   Jendela Modul menunjukkan kepada Anda saat semua modul telah dimuat untuk Azure App Service (pilih Debug > Jendela > Modul untuk membuka jendela ini).

   

Atur snappoint

1. Di editor kode, klik sisi kiri di samping baris kode yang Anda minati untuk mengatur snappoint. Pastikan kode yang Anda ketahui akan dijalankan.

   

2. Klik Mulai Koleksi untuk mengaktifkan snappoint.

   

   Tip

   Anda tidak dapat melangkah saat melihat snapshot, tetapi Anda dapat menempatkan beberapa snappoint dalam kode Anda untuk mengikuti eksekusi pada baris kode yang berbeda. Jika Anda memiliki beberapa snappoint dalam kode Anda, Snapshot Debugger memastikan bahwa snapshot yang sesuai berasal dari sesi pengguna akhir yang sama. Snapshot Debugger melakukan ini meskipun ada banyak pengguna yang membuka aplikasi Anda.

Mengambil snapshot

Setelah snappoint diatur, Anda dapat membuat snapshot secara manual dengan membuka tampilan browser situs web Anda dan menjalankan baris kode yang ditandai atau menunggu pengguna Anda membuatnya dari penggunaan situs mereka.

Periksa data snapshot

1. Saat snappoint terkena, snapshot muncul di jendela Alat Diagnostik. Untuk membuka jendela ini, pilih Debug > Windows > Tampilkan Alat Diagnostik.

   

2. Klik dua kali snappoint untuk membuka snapshot di editor kode.

   

   Dari tampilan ini, Anda dapat mengarahkan kursor ke variabel untuk melihat DataTips, menggunakan jendela Lokal, Watches, dan Tumpukan Panggilan, dan juga mengevaluasi ekspresi.

   Situs web itu sendiri masih aktif dan pengguna akhir tidak terpengaruh. Hanya satu snapshot yang diambil per snappoint secara default: setelah snapshot ditangkap, snappoint akan dinonaktifkan. Jika Anda ingin mengambil snapshot lain di snappoint, Anda dapat mengaktifkan kembali snappoint dengan mengeklik Perbarui Koleksi.

Anda juga dapat menambahkan lebih banyak snappoint ke aplikasi Anda dan mengaktifkannya dengan tombol Perbarui Koleksi.

Butuh bantuan? Lihat halaman Pemecahan masalah dan masalah yang diketahui dan FAQ untuk penelusuran kesalahan snapshot.

Mengatur snappoint kondisional

Jika sulit untuk membuat ulang status tertentu di aplikasi Anda, pertimbangkan untuk menggunakan snappoint kondisional. Snappoint kondisional membantu Anda mengontrol kapan harus mengambil snapshot seperti saat variabel berisi nilai tertentu yang ingin Anda periksa. Anda dapat mengatur ketentuan menggunakan ekspresi, filter, atau jumlah klik.

Untuk membuat snappoint kondisional

1. Klik kanan ikon snappoint (bola berongga) dan pilih Pengaturan.

   

2. Di jendela pengaturan snappoint, ketik ekspresi.

   

   Dalam ilustrasi sebelumnya, snapshot hanya diambil untuk snappoint ketika visitor.FirstName == "Dan".

Mengatur logpoint

Selain mengambil snapshot saat snappoint terkena, Anda juga dapat mengonfigurasi snappoint untuk mencatat pesan (yaitu, membuat logpoint). Anda dapat mengatur logpoint tanpa harus menyebarkan ulang aplikasi Anda. Logpoint dijalankan secara virtual dan tidak menyebabkan dampak atau efek samping pada aplikasi Anda yang sedang berjalan.

Untuk membuat logpoint

1. Klik kanan ikon snappoint (segi enam biru) dan pilih Pengaturan.

2. Di jendela pengaturan snappoint, pilih Tindakan.

   

3. Di bidang Pesan, Anda dapat memasukkan pesan log baru yang ingin Anda catat. Anda juga dapat mengevaluasi variabel dalam pesan log Anda dengan menempatkannya di dalam kurung kurawal.

   Jika Anda memilih Kirim ke Windows Output, saat logpoint ditekan, pesan akan muncul di jendela Alat Diagnostik.

   

   Jika Anda memilih Kirim ke log aplikasi, saat logpoint ditekan, pesan akan muncul di mana pun Anda dapat melihat pesan dari System.Diagnostics.Trace (atau ILogger di .NET Core), seperti Aplikasi Insights.

Konten terkait

Dalam tutorial ini, Anda telah mempelajari cara menggunakan Snapshot Debugger untuk App Services. Anda mungkin ingin membaca detail lebih lanjut tentang fitur ini.

FAQ untuk penelusuran kesalahan snapshot