Menambahkan Azure Application Insights dengan menggunakan Visual Studio Connected Services

Dengan Visual Studio, Anda dapat menyambungkan salah satu hal berikut ini ke Azure Application Insights dengan menggunakan fitur Connected Services:

  • Aplikasi konsol .NET Framework
  • ASP.NET Model-View-Controller (MVC) (.NET Framework)
  • Inti ASP.NET
  • .NET Core (termasuk aplikasi konsol, WPF, Formulir Windows, pustaka kelas)
  • Peran Pekerja .NET Core
  • Azure Functions
  • Aplikasi Universal Windows Platform
  • Xamarin
  • Cordova

Fungsionalitas layanan terhubung menambahkan semua referensi dan kode koneksi yang diperlukan ke proyek, dan memodifikasi file konfigurasi Anda dengan tepat.

Catatan

Topik ini berlaku untuk Visual Studio di Windows. Untuk Visual Studio untuk Mac, lihat Layanan tersambung di Visual Studio untuk Mac.

Prasyarat

  • Visual Studio dengan beban kerja Azure diinstal.
  • Proyek dari salah satu jenis yang didukung
  • Akun Azure. Jika Anda tidak memiliki akun Azure, aktifkan manfaat Azure Anda untuk pelanggan Visual Studio atau daftar untuk uji coba gratis.

Menyambungkan ke Azure Application Insights menggunakan Connected Services

  1. Buka proyek Anda di Visual Studio.

  2. Di Penjelajah Solusi, klik kanan node Layanan Tersambung, dan, dari menu konteks, pilih Tambahkan Layanan Tersambung.

  3. Di tab Layanan Tersambung, pilih ikon + untuk Dependensi Layanan.

    Screenshot showing

  4. Di halaman Tambahkan Dependensi, pilih Azure Application Insights.

    Screenshot showing

    Jika Anda belum masuk, masuk ke akun Azure Anda. Jika Anda tidak memiliki akun Azure, Anda dapat mendaftar untuk coba gratis.

  5. Di layar Konfigurasi Azure Application Insights, pilih komponen Azure Application Insights yang sudah ada, dan pilih Berikutnya.

    Jika Anda perlu membuat komponen baru, lanjutkan ke langkah berikutnya. Jika tidak, lewati ke langkah 7.

    Screenshot showing

  6. Untuk membuat komponen Application Insights:

    1. Pilih Buat komponen Application Insights baru di bagian bawah layar.

    2. Isi Application Insights: Buat layar baru, dan pilih Buat.

      Screenshot showing

    3. Saat layar Konfigurasikan Azure Application Insights ditampilkan, komponen baru muncul dalam daftar. Pilih komponen baru dalam daftar, dan pilih Berikutnya.

  7. Masukkan nama kunci instrumentasi, atau pilih default, dan pilih apakah Anda ingin string koneksi disimpan dalam file rahasia lokal, atau di Azure Key Vault.

    Screenshot showing

  8. Layar Ringkasan perubahan menunjukkan semua modifikasi yang akan dilakukan pada proyek jika Anda menyelesaikan proses. Jika perubahan terlihat OK, pilih Selesai.

    Screenshot showing

  9. Koneksi muncul di bawah bagian Dependensi Layanan dari tab Layanan Tersambung.

    Screenshot showing

Menyambungkan ke Azure Application Insights menggunakan Connected Services

Catatan

Untuk proyek .NET Framework, Koneksi ed Services UI sedikit berbeda. Untuk melihat perbedaannya, bandingkan dengan versi Visual Studio 2019 dari halaman ini.

  1. Buka proyek Anda di Visual Studio.

  2. Di Penjelajah Solusi, klik kanan simpul Layanan Koneksi, dan, dari menu konteks, pilih Tambahkan untuk membuka menu layanan yang tersedia.

    Screenshot showing Connected Services context menu options.

  3. Pilih Azure Application Insights. Halaman Koneksi ke dependensi muncul. Anda akan melihat dua opsi, satu untuk emulator lokal, Application Insights Sdk (Lokal), dan satu untuk menyambungkan ke layanan Azure Application Insights langsung. Anda dapat mengurangi biaya dan menyederhanakan pengembangan awal dengan memulai dengan emulator lokal. Anda dapat bermigrasi ke layanan langsung nanti dengan mengulangi langkah-langkah ini dan memilih opsi lainnya.

    Screenshot showing Application Insights choices.

    Jika Anda memilih untuk menggunakan Application Insights SDK secara lokal, klik Berikutnya untuk melihat layar Ringkasan perubahan, yang menunjukkan bagaimana proyek Anda dimodifikasi. Referensi paket NuGet ditambahkan ke proyek Anda dan kode koneksi untuk emulator lokal ditambahkan ke proyek Anda.

    Jika Anda ingin menyambungkan ke layanan Azure, lanjutkan ke langkah berikutnya, atau jika Anda belum masuk, masuk ke akun Azure Anda sebelum melanjutkan. Jika Anda tidak memiliki akun Azure, Anda dapat mendaftar untuk coba gratis.

  4. Di layar Konfigurasi Azure Application Insights, pilih komponen Azure Application Insights yang sudah ada, dan pilih Berikutnya.

    Jika Anda perlu membuat komponen baru, lanjutkan ke langkah berikutnya. Jika tidak, lewati ke langkah 7.

    Screenshot showing

  5. Untuk membuat komponen Application Insights:

    1. Pilih Buat komponen Application Insights baru di bagian bawah layar.

    2. Isi Application Insights: Buat layar baru, dan pilih Buat.

      Screenshot showing

    3. Saat layar Konfigurasikan Azure Application Insights ditampilkan, komponen baru muncul dalam daftar. Pilih komponen baru dalam daftar, dan pilih Berikutnya.

  6. Masukkan nama kunci instrumentasi, atau pilih default, dan pilih apakah Anda ingin string koneksi disimpan dalam file rahasia lokal, atau di Azure Key Vault.

    Screenshot showing

  7. Layar Ringkasan perubahan menunjukkan semua modifikasi yang akan dilakukan pada proyek jika Anda menyelesaikan proses. Jika perubahan terlihat OK, pilih Selesai.

    Screenshot showing

  8. Di Penjelajah Solusi, klik dua kali pada simpul Layanan Koneksi untuk membuka tab Layanan yang Koneksi. Koneksi muncul di bawah bagian Dependensi Layanan:

    Screenshot showing

    Jika Anda mengklik tiga titik di samping dependensi yang Anda tambahkan, Anda bisa melihat berbagai opsi seperti Koneksi untuk membuka kembali wizard dan mengubah koneksi. Anda juga dapat mengklik tiga titik di kanan atas jendela untuk melihat opsi untuk memulai dependensi lokal, mengubah pengaturan, dan lainnya.

  9. Buka file kode startup Anda (Program.cs dalam templat) dan perhatikan bahwa baris telah ditambahkan yang menyerupan berikut ini:

    builder.Services.AddApplicationInsightsTelemetry(builder.Configuration["APPLICATIONINSIGHTS_CONNECTION_STRING"]);
    

Langkah berikutnya

Untuk proyek ASP.NET Core, pelajari cara mengaktifkan pemantauan untuk aplikasi Anda di Application Insights untuk aplikasi ASP.NET Core.

Untuk proyek ASP.NET, lihat Mengonfigurasi Application Insights untuk situs web ASP.NET Anda.

Tautan membawa Anda ke bagian artikel setelah langkah-langkah penyiapan awal, yang telah Anda lakukan.