Bagikan melalui

Men-debug layanan cloud Azure yang diterbitkan dengan Visual Studio dan IntelliTrace

  • Artikel

Catatan

Artikel ini berlaku untuk Azure Cloud Services (klasik), yang sekarang tidak digunakan lagi untuk pelanggan baru dan akan dihentikan pada 31 Agustus 2024. Layanan yang ada yang dibangun dengan teknologi ini masih didukung melalui Azure Cloud Services (dukungan yang diperluas). Untuk pengembangan baru, kami sarankan Anda menggunakan jenis layanan yang lebih baru yang dirancang untuk tujuan spesifik Anda, seperti Azure App Service, Azure Functions, atau Azure Container Apps. Untuk daftar terbaru layanan yang tersedia, lihat Direktori produk Azure.

Dengan IntelliTrace, Anda dapat mencatat informasi penelusuran kesalahan yang luas untuk instans peran saat berjalan di Azure. Jika Anda perlu menemukan penyebab masalah, Anda dapat menggunakan log IntelliTrace untuk menelusuri kode Anda dari Visual Studio seolah-olah berjalan di Azure. Akibatnya, IntelliTrace merekam eksekusi kode kunci dan data lingkungan saat aplikasi Azure Anda berjalan sebagai layanan cloud di Azure, dan memungkinkan Anda memutar ulang data yang direkam dari Visual Studio.

Anda dapat menggunakan IntelliTrace jika Anda telah menginstal Visual Studio Enterprise dan aplikasi Azure Anda menargetkan .NET Framework 4 atau versi yang lebih baru. IntelliTrace mengumpulkan informasi untuk peran Azure Anda. Komputer virtual untuk peran ini selalu menjalankan sistem operasi 64-bit.

Sebagai alternatif, Anda dapat menggunakan penelusuran kesalahan jarak jauh untuk melampirkan langsung ke layanan cloud yang berjalan di Azure.

Penting

IntelliTrace hanya ditujukan untuk skenario debug, dan tidak boleh digunakan untuk penyebaran produksi.

Prasyarat

Mengonfigurasi aplikasi Azure untuk IntelliTrace

Untuk mengaktifkan IntelliTrace untuk aplikasi Azure, Anda harus membuat dan menerbitkan aplikasi dari proyek Azure Visual Studio. Anda harus mengonfigurasi IntelliTrace untuk aplikasi Azure Anda sebelum menerbitkannya ke Azure. Jika Anda menerbitkan aplikasi tanpa mengonfigurasi IntelliTrace, Anda perlu menerbitkan ulang proyek. Untuk informasi selengkapnya, lihat Menerbitkan proyek Azure Cloud Services menggunakan Visual Studio.

  1. Saat Anda siap untuk menyebarkan aplikasi Azure, verifikasi bahwa target build proyek Anda diatur ke Debug.

  2. Pada Penjelajah Solusi, klik kanan proyek, dan, dari menu konteks, pilih Terbitkan.

  3. Dalam dialog Terbitkan Aplikasi Azure, pilih langganan Azure, dan pilih Berikutnya.

  4. Di halaman Pengaturan, pilih tab Pengaturan Tingkat Lanjut.

  5. Aktifkan opsi Aktifkan IntelliTrace untuk mengumpulkan log IntelliTrace untuk aplikasi Anda saat diterbitkan di cloud.

  6. Untuk menyesuaikan konfigurasi IntelliTrace dasar, pilih Pengaturan di samping Aktifkan IntelliTrace.

    Tautan pengaturan IntelliTrace

  7. Dalam dialog Pengaturan IntelliTrace, Anda dapat menentukan peristiwa mana yang akan dicatat, apakah akan mengumpulkan informasi panggilan, modul dan proses mana yang akan dikumpulkan lognya, dan berapa banyak ruang yang akan dialokasikan ke rekaman. Untuk informasi selengkapnya tentang IntelliTrace, lihat Debugging dengan IntelliTrace.

    Pengaturan IntelliTrace

Log IntelliTrace adalah file log melingkar dengan ukuran maksimum yang ditentukan dalam pengaturan IntelliTrace (ukuran defaultnya adalah 250 MB). Log IntelliTrace dikumpulkan ke file dalam sistem file komputer virtual. Saat Anda meminta log, sebuah snapshot diambil pada saat itu dan diunduh ke komputer lokal Anda.

Setelah layanan cloud Azure diterbitkan ke Azure, Anda dapat menentukan apakah IntelliTrace telah diaktifkan dari simpul Azure di Server Explorer, seperti yang ditunjukkan pada gambar berikut:

Server Explorer - IntelliTrace diaktifkan

Mengunduh log IntelliTrace untuk instans peran

Dengan menggunakan Visual Studio, Anda dapat mengunduh log IntelliTrace untuk instans peran dengan mengikuti langkah-langkah berikut:

  1. Pada Server Explorer, perluas node Cloud Services, dan temukan instans peran yang lognya ingin Anda unduh.

  2. Klik kanan instans peran, dan dari menu konteks s, pilih Tampilkan Log IntelliTrace.

    Tampilkan opsi menu log IntelliTrace

  3. Log IntelliTrace diunduh ke file dalam direktori di komputer lokal Anda. Setiap kali Anda meminta log IntelliTrace, snapshot baru dibuat. Saat log sedang diunduh, Visual Studio menampilkan kemajuan operasi di jendela Log Aktivitas Azure. Seperti yang ditunjukkan pada gambar berikut, Anda bisa memperluas item baris untuk operasi guna melihat detail selengkapnya.

VST_IntelliTraceDownloadProgress

Anda dapat terus bekerja di Visual Studio saat log IntelliTrace diunduh. Setelah log selesai diunduh, log akan terbuka di Visual Studio.

Catatan

Log IntelliTrace mungkin berisi pengecualian yang dihasilkan dan ditangani kerangka kerja setelahnya. Kode kerangka kerja internal menghasilkan pengecualian ini sebagai bagian normal dari memulai peran, sehingga Anda dapat mengabaikannya dengan aman.

Konten terkait