Penelusuran Kesalahan Jarak Jauh

Anda dapat men-debug aplikasi Visual Studio yang telah disebarkan di komputer lain. Untuk melakukannya, Anda menggunakan debugger jarak jauh Visual Studio.

Untuk petunjuk yang lebih rinci tentang penelusuran kesalahan jarak jauh, lihat daftar topik berikut.

Jika Anda hanya ingin mengunduh dan menginstal debugger jarak jauh dan tidak memerlukan instruksi tambahan untuk skenario Anda, ikuti langkah-langkah dalam artikel ini.

Mengunduh dan Menginstal alat jarak jauh

Pada perangkat jarak jauh atau server yang ingin Anda debug, bukan komputer Visual Studio, unduh dan instal versi alat jarak jauh yang benar dari tautan dalam tabel berikut.

• Unduh pembaruan terbaru alat jarak jauh untuk versi Visual Studio Anda. Versi alat jarak jauh sebelumnya tidak kompatibel dengan versi Visual Studio yang lebih baru. (Misalnya, jika Anda menggunakan Visual Studio 2019, unduh pembaruan terbaru alat jarak jauh untuk Visual Studio 2019. Dalam skenario ini, jangan unduh alat jarak jauh untuk Visual Studio 2022.)
• Unduh alat jarak jauh dengan arsitektur yang sama dengan komputer tempat Anda menginstalnya. Misalnya, jika Anda ingin men-debug aplikasi x86 di komputer jarak jauh yang menjalankan sistem operasi x64, instal alat jarak jauh x64. Untuk men-debug aplikasi x86, ARM, atau x64 pada sistem operasi ARM64, instal alat jarak jauh ARM64.

Anda dapat menjalankan debugger jarak jauh dengan menyalin msvsmon.exe ke komputer jarak jauh, daripada menginstal alat jarak jauh. Namun, Panduan Konfigurasi Debugger Jarak Jauh (rdbgwiz.exe) hanya tersedia saat Anda menginstal alat jarak jauh. Anda mungkin perlu menggunakan wizard untuk konfigurasi jika Anda ingin menjalankan debugger jarak jauh sebagai layanan. Untuk informasi selengkapnya, lihat (Opsional) Mengonfigurasi debugger jarak jauh sebagai layanan.

Persyaratan

Sistem Operasi yang Didukung

Komputer jarak jauh harus menjalankan salah satu sistem operasi berikut:

• Windows 11

• Windows 10 (bukan telepon)

• Windows 8 atau 8.1 (bukan telepon)

• Paket Layanan Windows 7 1

• Windows Server 2016

• Windows Server 2012 atau Windows Server 2012 R2

• Windows Server 2008 Service Pack 2, Windows Server 2008 R2 Service Pack 1

Konfigurasi Perangkat Keras yang Didukung

• Prosesor 1,6 GHz atau lebih cepat

• RAM 1 GB (1,5 GB jika berjalan pada komputer virtual)

• 1 GB ruang hard disk yang tersedia

• Hard disk 5400 revolusi per menit

• Kartu video berkemampuan DirectX 9 yang berjalan pada resolusi tampilan 1024 x 768 atau lebih tinggi

Konfigurasi jaringan

Komputer jarak jauh dan komputer Visual Studio harus tersambung melalui jaringan, grup kerja, atau grup rumah, atau yang terhubung langsung melalui kabel Ethernet. Debugging antara dua komputer yang terhubung melalui proksi tidak didukung. Debugging melalui koneksi dengan latensi tinggi atau bandwidth rendah, seperti Internet dialup, atau melalui Internet yang melintasi negara/wilayah, tidak disarankan dan mungkin gagal atau terlalu lambat untuk diterima.

(Opsional) Untuk menjalankan debugger jarak jauh dari berbagi file

Anda dapat menemukan debugger jarak jauh (msvsmon.exe) di komputer dengan Visual Studio Community, Professional, atau Enterprise yang sudah diinstal. Untuk beberapa skenario, cara term mudah untuk menyiapkan penelusuran kesalahan jarak jauh adalah dengan menjalankan debugger jarak jauh (msvsmon.exe) dari berbagi file. Untuk batasan penggunaan, lihat halaman Bantuan debugger jarak jauh (Bantuan > penggunaan di debugger jarak jauh).

1. Temukan msvsmon.exe di direktori yang cocok dengan versi Visual Studio Anda:

   File Program\Microsoft Visual Studio 17.0\Common7\IDE\Remote Debugger\x64\msvsmon.exe

   Program File\Microsoft Visual Studio 17.0\Common7\IDE\Remote Debugger\x86\msvsmon.exe

   Program Files (x86)\Microsoft Visual Studio\2019\Enterprise\Common7\IDE\Remote Debugger\x64\msvsmon.exe

   Program Files (x86)\Microsoft Visual Studio\2019\Enterprise\Common7\IDE\Remote Debugger\x86\msvsmon.exe

2. Bagikan folder Remote Debugger di komputer Visual Studio.

3. Pada komputer jarak jauh, jalankan msvsmon.exe dari folder bersama. Ikuti instruksi penyiapan .

Menyiapkan debugger jarak jauh

1. Di komputer jarak jauh, temukan dan mulai Remote Debugger dari menu Mulai.

   Jika Anda tidak memiliki izin administratif di komputer jarak jauh, klik kanan aplikasi Remote Debugger dan pilih Jalankan sebagai administrator. Jika tidak, mulai saja secara normal.

   Jika Anda berencana untuk menautkan ke proses yang berjalan sebagai administrator, atau berjalan dengan akun pengguna yang berbeda (seperti IIS), klik kanan pada aplikasi Remote Debugger dan pilih Jalankan sebagai administrator. Untuk informasi selengkapnya, lihat Menjalankan debugger jarak jauh sebagai administrator.

2. Pertama kali Anda memulai debugger jarak jauh (atau sebelum Anda mengonfigurasinya), wizard Konfigurasi Debugging Jarak Jauh muncul.

   Dalam sebagian besar skenario, pilih Berikutnya hingga Anda masuk ke halaman Mengonfigurasi Windows Firewall dari wizard.

   

   

   Jika WINDOWS Web Services API tidak diinstal, yang hanya terjadi pada Windows Server 2008 R2, pilih tombol Instal.

3. Pilih setidaknya satu jenis jaringan tempat Anda ingin menggunakan alat jarak jauh. Jika komputer tersambung melalui domain, Anda harus memilih item pertama. Jika komputer tersambung melalui grup kerja atau grup rumah, pilih item kedua atau ketiga yang sesuai.

   Selanjutnya, pilih Selesai untuk memulai debugger jarak jauh.

   Selanjutnya, pilih Konfigurasi debugging jarak jauh untuk memulai debugger jarak jauh.

4. Setelah konfigurasi selesai, jendela Remote Debugger akan muncul.

   

   

   Debugger jarak jauh sekarang menunggu koneksi. Gunakan nama server dan nomor port yang ditampilkan untuk mengatur konfigurasi koneksi jarak jauh di Visual Studio.

Untuk menghentikan debugger jarak jauh, pilih File>Keluar. Anda dapat memulai ulang dari menu Mulai, atau dari baris perintah:

<Remote debugger installation directory>\msvsmon.exe

Mengonfigurasi debugger jarak jauh

Anda dapat mengubah beberapa aspek konfigurasi debugger jarak jauh setelah memulainya untuk pertama kalinya.

• Jika Anda perlu menambahkan izin bagi pengguna lain untuk menyambungkan ke debugger jarak jauh, pilih Alat > Izin. Anda harus memiliki hak administrator untuk memberikan atau menolak izin.

  Penting

  Anda dapat menjalankan debugger jarak jauh di bawah akun pengguna yang berbeda dari akun pengguna yang Anda gunakan di komputer Visual Studio, tetapi Anda harus menambahkan akun pengguna yang berbeda ke izin debugger jarak jauh.

  Atau, Anda dapat memulai debugger jarak jauh dari baris perintah dengan parameter /allow <username>: msvsmon /allow <username@computer>.

• Jika Anda perlu mengubah mode Autentikasi atau nomor port, atau menentukan nilai batas waktu untuk alat jarak jauh: pilih Alat > Opsi.

  Untuk melihat daftar nomor port yang digunakan secara default, silakan lihat Penetapan Port Debugger Jarak Jauh.

  Peringatan

  Anda dapat memilih untuk menjalankan alat jarak jauh dalam mode Tanpa Autentikasi, tetapi mode ini sangat tidak disarankan. Tidak ada keamanan jaringan ketika Anda menjalankan dalam mode ini. Pilih mode Tanpa Autentikasi hanya jika Anda yakin bahwa jaringan tidak berisiko dari lalu lintas berbahaya atau bermusuhan.

Mengonfigurasi Visual Studio untuk debugging jarak jauh

Untuk petunjuk terperinci untuk menyambungkan ke aplikasi dari Visual Studio, gunakan tautan yang terkait dengan skenario spesifik Anda di awal artikel ini.

Beberapa skenario memerlukan penggunaan fungsi Lampirkan ke Proses untuk menyambungkan ke aplikasi jarak jauh yang sudah dimulai. Namun, untuk aplikasi .NET Core, .NET 5+, .NET Framework, dan C++, Anda dapat memulai aplikasi jarak jauh dari Visual Studio dengan mengonfigurasi properti proyek dan memulai debugger. Untuk informasi selengkapnya, lihat Remote debug proyek C# atau Visual Basic atau Remote debug proyek C++.

Anda juga dapat melakukan debug jarak jauh pada executable yang bukan bagian dari proyek Visual Studio, meskipun fitur penelusuran kesalahan yang didukung bergantung pada konfigurasi seperti ketersediaan simbol. Untuk informasi selengkapnya, lihat Men-debug aplikasi yang bukan bagian dari solusi Visual Studio.

(Opsional) Mengonfigurasi debugger jarak jauh sebagai layanan

Untuk debugging di ASP.NET dan lingkungan server lainnya, Anda harus menjalankan debugger jarak jauh sebagai Administrator atau, jika Anda ingin tetap berjalan, jalankan debugger jarak jauh sebagai layanan.

Jika Anda ingin mengonfigurasi debugger jarak jauh sebagai layanan, ikuti langkah-langkah ini.

1. Temukan Wizard Konfigurasi Debugger Jarak Jauh (rdbgwiz.exe). (Ini adalah aplikasi terpisah dari Remote Debugger.) Ini hanya tersedia ketika Anda menginstal alat jarak jauh. Ini tidak diinstal dengan Visual Studio.

2. Mulai jalankan wizard konfigurasi. Saat halaman pertama muncul, klik Berikutnya.

3. Centang kotak Jalankan Remote Debugger Visual Studio sebagai layanan.

4. Tambahkan nama akun pengguna dan kata sandi.

   Anda mungkin perlu menambahkan hak pengguna Masuk sebagai layanan ke akun ini (Temukan Kebijakan Keamanan Lokal (secpol.msc) di halaman atau jendela Mulai (atau ketik secpol pada prompt perintah). Saat jendela muncul, klik dua kali Penetapan Hak Pengguna, lalu temukan Masuk sebagai layanan di panel sebelah kanan. Klik dua kali. Tambahkan akun pengguna ke jendela Properti dan klik OK). Klik Berikutnya.

5. Pilih jenis jaringan yang Anda inginkan untuk berkomunikasi dengan alat jarak jauh. Setidaknya satu tipe jaringan harus dipilih. Jika komputer tersambung melalui domain, Anda harus memilih item pertama. Jika komputer tersambung melalui grup kerja atau grup rumah, Anda harus memilih item kedua atau ketiga. Klik Berikutnya.

6. Jika layanan dapat dimulai, Anda akan melihat Anda telah berhasil menyelesaikan Wizard Konfigurasi Debugger Jarak Jauh Visual Studio. Jika layanan tidak dapat dimulai, Anda akan melihat Gagal menyelesaikan Wizard Konfigurasi Debugger Jarak Jauh Visual Studio. Halaman ini juga memberikan beberapa tips yang harus diikuti untuk memulai layanan.

7. Klik Selesai.

   Pada titik ini debugger jarak jauh berjalan sebagai layanan. Anda dapat memverifikasi ini dengan masuk ke Panel Kontrol > Layanan dan mencari Visual Studio Remote Debugger.

   Anda dapat menghentikan dan memulai layanan debugger jarak jauh dari Control Panel > Services.

Menyiapkan debug dengan simbol secara jarak jauh

Anda harus dapat men-debug kode Anda dengan simbol yang Anda hasilkan di komputer Visual Studio. Performa debugger jarak jauh jauh lebih baik ketika Anda menggunakan simbol lokal. Jika Anda harus menggunakan simbol jarak jauh, Anda perlu memberi tahu monitor debugging jarak jauh untuk mencari simbol pada mesin jarak jauh.

Anda dapat menggunakan sakelar baris perintah msvsmon berikut untuk menggunakan simbol jarak jauh untuk kode terkelola: Msvsmon /FallbackLoadRemoteManagedPdbs

Untuk informasi selengkapnya, silakan lihat bantuan debugging jarak jauh (tekan F1 di jendela debugger jarak jauh, atau klik Bantuan > Penggunaan).

Konten terkait

• Pertama-tama lihat debugger
• Mengonfigurasi Firewall Windows untuk Debugging Jarak Jauh
• Penetapan Port Debugger Jarak Jauh
• Pemecahan Masalah Jarak Jauh ASP.NET Core pada Komputer IIS yang Terhubung Jarak Jauh
• Kesalahan Debugging Jarak Jauh dan Pemecahan Masalah