Bagikan melalui

Mengaktifkan .NET Profiler untuk aplikasi Azure App Service

  • Artikel

Application Insights Profiler untuk .NET telah diinstal sebelumnya sebagai bagian dari runtime Azure App Service. Anda dapat menjalankan Profiler di aplikasi ASP.NET dan ASP.NET Core yang berjalan di App Service dengan menggunakan tingkat layanan Dasar atau yang lebih tinggi.

Penginstalan tanpa kode Application Insights Profiler untuk .NET:

Untuk mengaktifkan .NET Profiler di Linux, telusuri instruksi aplikasi web ASP.NET Core Azure Linux.

Prasyarat

  • Aplikasi Azure App Service ASP.NET/ASP.NET Core.
  • Sumber daya Application Insights yang terhubung ke aplikasi App Service Anda.

Verifikasi pengaturan "Selalu aktif" diaktifkan

  1. Di portal Azure, buka instans App Service Anda.

  2. Di menu sebelah kiri, pilih Konfigurasi Pengaturan>.

    Cuplikan layar yang memperlihatkan pemilihan Konfigurasi di panel kiri.

  3. Pilih tab Pengaturan umum.

  4. Verifikasi bahwa Always on> dipilih.

    Catatan

    Jika tombol Selalu aktif dinonaktifkan , tingkatkan aplikasi web App Service Anda untuk berjalan pada tingkat Dasar atau yang lebih tinggi.

    Cuplikan layar yang memperlihatkan tab Umum pada panel Konfigurasi memperlihatkan bahwa Always On diaktifkan.

  5. Pilih Simpan jika Anda membuat perubahan.

Mengaktifkan Application Insights dan .NET Profiler

Anda dapat mengaktifkan Profiler baik saat:

Untuk Application Insights dan App Service dalam langganan yang sama

Jika sumber daya Application Insights Anda berada dalam langganan yang sama dengan instans App Service Anda:

  1. Di menu sebelah kiri, pilih Memantau>Application Insights.

  2. Di bawah Application Insights, pilih Aktifkan.

  3. Verifikasi bahwa Anda menghubungkan sumber daya Application Insights ke aplikasi Anda.

    Cuplikan layar yang memperlihatkan pengaktifan Application Insights di aplikasi Anda.

  4. Gulir ke bawah dan pilih tab .NET atau .NET Core, bergantung pada aplikasi Anda.

  5. Verifikasi bahwa Tingkat>koleksi Direkomendasikan dipilih.

  6. Di bawah Profiler, pilih Aktif.

    Jika Anda memilih tingkat koleksi Dasar sebelumnya, pengaturan Profiler dinonaktifkan.

  7. Pilih Terapkan>Ya untuk mengonfirmasi.

    Cuplikan layar yang menunjukkan pengaktifan Profiler di aplikasi Anda.

Untuk Application Insights dan App Service dalam langganan yang berbeda

Jika sumber daya Application Insights Anda berada dalam langganan yang berbeda dari instans App Service, Anda perlu mengaktifkan Profiler untuk .NET secara manual dengan membuat pengaturan aplikasi untuk instans App Service Anda. Anda dapat mengotomatiskan pembuatan pengaturan ini dengan menggunakan templat atau cara lain. Berikut adalah pengaturan yang Anda butuhkan untuk mengaktifkan Profiler.

Pengaturan aplikasi Nilai
APPINSIGHTS_INSTRUMENTATIONKEY iKey untuk sumber daya Application Insights Anda
APPINSIGHTS_PROFILERFEATURE_VERSION 1.0.0
DiagnosticServices_EXTENSION_VERSION ~3

Atur nilai-nilai ini dengan menggunakan:

Mengaktifkan .NET Profiler untuk cloud regional

Saat ini, satu-satunya wilayah yang memerlukan modifikasi titik akhir adalah Azure Government dan Microsoft Azure yang dioperasikan oleh 21Vianet.

Pengaturan aplikasi Cloud Pemerintah AS Cloud Tiongkok
ApplicationInsightsProfilerEndpoint https://profiler.monitor.azure.us https://profiler.monitor.azure.cn
ApplicationInsightsEndpoint https://dc.applicationinsights.us https://dc.applicationinsights.azure.cn

Mengaktifkan autentikasi Microsoft Entra untuk penyerapan profil

Application Insights Profiler untuk .NET mendukung autentikasi Microsoft Entra untuk penyerapan profil. Agar semua profil aplikasi Anda diserap, aplikasi Anda harus diautentikasi dan meyediakan pengaturan aplikasi yang dibutuhkan ke agen Profiler.

Profiler hanya mendukung autentikasi Microsoft Entra saat Anda mereferensikan dan mengonfigurasi ID Microsoft Entra dengan menggunakan Application Insights SDK di aplikasi Anda.

Untuk mengaktifkan ID Microsoft Entra untuk penyerapan profil:

  1. Buat dan tambahkan identitas terkelola untuk mengautentikasi terhadap sumber daya Application Insights Anda ke App Service Anda:

    1. Dokumentasi identitas terkelola yang ditetapkan sistem

    2. Dokumentasi identitas terkelola yang ditetapkan pengguna

  2. Konfigurasikan dan aktifkan ID Microsoft Entra di sumber daya Application Insights Anda.

  3. Tambahkan pengaturan aplikasi berikut untuk memberi tahu agen Profiler identitas terkelola mana yang akan digunakan.

    • Untuk identitas yang ditetapkan sistem:

      Pengaturan aplikasi Nilai
      APPLICATIONINSIGHTS_AUTHENTICATION_STRING Authorization=AAD

    • Untuk identitas yang ditetapkan pengguna:

      Pengaturan aplikasi Nilai
      APPLICATIONINSIGHTS_AUTHENTICATION_STRING Authorization=AAD;ClientId={Client id of the User-Assigned Identity}

Menonaktifkan .NET Profiler

Untuk menghentikan atau memulai ulang Profiler untuk instance aplikasi individual:

  1. Di bawah Pengaturan di panel kiri, pilih WebJobs.

    Cuplikan layar yang memperlihatkan pemilihan pekerjaan web di panel kiri.

  2. Pilih webjob bernama ApplicationInsightsProfiler3.

  3. Pilih Hentikan.

    Cuplikan layar yang memperlihatkan pemilihan berhenti untuk menghentikan webjob.

  4. Pilih Ya untuk mengonfirmasi.

Sebaiknya Profiler diaktifkan di semua aplikasi untuk menemukan masalah performa sedini mungkin.

Anda dapat menghapus file Profiler saat menggunakan WebDeploy untuk menyebarkan perubahan ke aplikasi web Anda. Anda dapat mencegah penghapusan dengan mengecualikan folder App_Data dihapus selama penyebaran.

Langkah berikutnya