Pengantar Application Insights - Observabilitas OpenTelemetry

Azure Monitor Application Insights adalah fitur pemantauan performa aplikasi (APM) Azure Monitor. Untuk skenario yang didukung, Anda dapat menggunakan OpenTelemetry (OTel), kerangka kerja pengamatan vendor-netral, untuk melengkapi aplikasi Anda dan mengumpulkan data telemetri, lalu menganalisis telemetri tersebut di Application Insights.

Pengalaman Application Insights

Application Insights mendukung OpenTelemetry (OTel) untuk mengumpulkan data telemetri dalam format standar di seluruh platform. Integrasi dengan layanan Azure memungkinkan pemantauan dan diagnostik yang efisien, meningkatkan pengamatan dan performa aplikasi.

Menyelidiki

• Dasbor aplikasi: Penilaian sekilas tentang kesehatan dan performa aplikasi Anda.
• Peta aplikasi: Gambaran umum visual arsitektur aplikasi dan interaksi komponen.
• Metrik-metrik langsung: Dasbor analitik waktu nyata yang memberikan wawasan tentang aktivitas dan performa aplikasi.
• Tampilan pencarian: Melacak dan mendiagnosis transaksi untuk mengidentifikasi masalah dan mengoptimalkan performa.
• Tampilan ketersediaan: Secara proaktif memantau dan menguji ketersediaan dan responsivitas titik akhir aplikasi.
• Tampilan kegagalan: Identifikasi dan analisis kegagalan dalam aplikasi Anda untuk meminimalkan waktu tidak beroperasi.
• Tampilan performa: Tinjau metrik performa aplikasi dan potensi hambatan.
• Detail agen: Tampilan terpadu untuk memantau agen AI di Microsoft Foundry, Copilot Studio, dan agen pihak ketiga.

Pemantauan

• Pemberitahuan: Pantau berbagai aspek aplikasi Anda dan picu berbagai tindakan.
• Metrik: Mendalami data metrik untuk memahami pola dan tren penggunaan.
• Pengaturan Diagnostik: Konfigurasikan penyiaran ekspor log platform dan metrik ke tujuan yang Anda pilih.
• Logs: Mengambil, mengonsolidasikan, dan menganalisis semua data yang dikumpulkan ke dalam Log Pemantauan Azure.
• Buku kerja: Membuat laporan interaktif dan dasbor yang memvisualisasikan data pemantauan aplikasi.
• Dashboards dengan Grafana: Membuat, menyesuaikan, dan berbagi dasbor Grafana untuk data Application Insights langsung di portal Azure.
• Statistik SDK: Visualisasikan keberhasilan pengekspor, jumlah yang dibatalkan, jumlah coba lagi, dan alasan pembatalan dari SDK dan agen Application Insights.

Penggunaan

• Pengguna, sesi, dan peristiwa: Tentukan kapan, di mana, dan bagaimana pengguna berinteraksi dengan aplikasi web Anda.
• Corong: Menganalisis tingkat konversi untuk mengidentifikasi di mana pengguna maju atau keluar dalam corong.
• Alur: Visualisasikan jalur pengguna di situs Anda untuk mengidentifikasi area keterlibatan tinggi dan titik keluar.
• Kohor: Mengelompokkan pengguna berdasarkan karakteristik bersama untuk menyederhanakan identifikasi tren, segmentasi, dan pemecahan masalah performa.

Analisis kode

• .NET Profiler: Menangkap, mengidentifikasi, dan melihat jejak performa untuk aplikasi Anda.
• Pengoptimalan kode: Manfaatkan AI untuk menciptakan aplikasi yang lebih baik dan lebih efisien.
• Snapshot debugger: Mengumpulkan snapshot debug secara otomatis saat pengecualian terjadi di aplikasi .NET

Model logika

Diagram model logika memvisualisasikan komponen Application Insights dan cara mereka berinteraksi.

Catatan

Pengaturan firewall harus disesuaikan agar data mencapai endpoint penerimaan. Untuk informasi selengkapnya, lihat akses titik akhir Azure Monitor dan konfigurasi firewall.

Memulai Langkah Pertama

Bagian ini mencakup memulai pengumpulan data berbasis OpenTelemetry.

Titik masuk meliputi:

• Aplikasi web sisi server
• Aplikasi web sisi server yang dihosting di Komputer Virtual (VM)
• Aplikasi JavaScript sisi klien
• Azure Functions
• Agen Kecerdasan Buatan (AI)

Petunjuk / Saran

• Untuk sebagian besar skenario sisi server berbasis kode, penyiapan yang direkomendasikan menggunakan Distro OpenTelemetry Azure Monitor.
• Skenario di mana OpenTelemetry tidak tersedia diidentifikasi dengan jelas.

Pilih tab yang paling cocok dengan beban kerja atau model hosting Anda. Setiap tab memperlihatkan jalur pengumpulan data yang direkomendasikan untuk skenario tersebut.

Aplikasi web

Gunakan jalur ini untuk aplikasi web sisi server yang Anda instrumentasikan dalam kode.

1. Buat sumber daya Application Insights.
2. Dapatkan connection string sumber daya.
3. Tambahkan Distro OpenTelemetry ke aplikasi Anda.
4. Konfigurasikan connection string.

Petunjuk / Saran

Beberapa platform memungkinkan pengumpulan data secara otomatis melalui autoinstrumentasi. Beralih ke instrumentasi berbasis kode dengan Distro OpenTelemetry jika Anda menginginkan lebih banyak opsi konfigurasi dan ekstensibilitas.

VM

Gunakan jalur ini saat aplikasi Anda berjalan pada komputer virtual atau set skala komputer virtual. Alur berbasis kode sama dengan untuk aplikasi sisi server lainnya.

1. Buat sumber daya Application Insights.
2. Dapatkan connection string sumber daya.
3. Tambahkan Distro OpenTelemetry ke aplikasi Anda.
4. Konfigurasikan connection string.

Petunjuk / Saran

Beberapa platform memungkinkan pengumpulan data secara otomatis melalui autoinstrumentasi. Beralih ke instrumentasi berbasis kode dengan Distro OpenTelemetry jika Anda menginginkan lebih banyak opsi konfigurasi dan ekstensibilitas.

JavaScript

Gunakan jalur ini untuk telemetri browser seperti tampilan halaman dan interaksi pengguna. Aplikasi browser menggunakan Application Insights JavaScript SDK, bukan OpenTelemetry.

1. Buat sumber daya Application Insights.
2. Dapatkan connection string sumber daya.
3. Tambahkan JavaScript SDK ke aplikasi Anda.
4. Konfigurasikan connection string.

Catatan

Application Insights JavaScript SDK tidak menggunakan OpenTelemetry. Untuk informasi selengkapnya, lihat Bisakah OpenTelemetry digunakan untuk browser web?

Fungsi

Gunakan jalur ini untuk Azure Functions. Mulailah dengan pengaturan aplikasi fungsi, lalu ikuti artikel Fungsi untuk langkah-langkah khusus bahasa.

1. Aktifkan OpenTelemetry di file aplikasi host.json fungsi Anda dengan mengatur "telemetryMode": "OpenTelemetry".
2. Tambahkan APPLICATIONINSIGHTS_CONNECTION_STRINGpengaturan aplikasi dengan menggunakan connection string (string koneksi) dari Application Insights.
3. Selesaikan instrumentasi yang disesuaikan dengan bahasa dan konfigurasi pekerja yang diperlukan di Gunakan OpenTelemetry dengan Azure Functions.

Catatan

OpenTelemetry saat ini tidak didukung untuk aplikasi dalam proses C#.

Kubernetes

Gunakan jalur ini untuk aplikasi yang berjalan di Azure Kubernetes Service (AKS). Alur berbasis kode sama dengan untuk aplikasi sisi server lainnya.

1. Buat sumber daya Application Insights.
2. Dapatkan connection string sumber daya.
3. Tambahkan Distro OpenTelemetry ke aplikasi Anda.
4. Konfigurasikan connection string.

Catatan

Instrumentasi otomatis untuk Azure Kubernetes Service (AKS) tersedia sebagai pratinjau publik.

Agen

Gunakan jalur ini untuk agen AI. Pilih penyiapan yang cocok dengan model hosting Anda.

• Hosting terkelola

  • Azure AI Foundry: Untuk agen dan alur kerja yang dikelola oleh Foundry, mulailah dengan penyiapan tracing di Foundry. Untuk instrumentasi di sisi aplikasi, Anda juga dapat menggunakan Azure Monitor OpenTelemetry Distro dengan SDK Foundry.
  • Copilot Studio: Gunakan konfigurasi bawaan untuk memancarkan telemetri Anda ke Azure Monitor. Untuk informasi selengkapnya, lihat Hubungkan agen Copilot Studio Anda ke Application Insights.

• Hosting mandiri

  • Microsoft Agent Framework: Jika Anda membangun agen dari awal dan hosting mandiri, gunakan Microsoft Agent Framework untuk mengatur agen Anda dan memancarkan telemetri ke Azure Monitor.
  • Agen pihak ketiga: Jika Anda membangun agen di tempat lain, gunakan Azure AI OpenTelemetry Tracer untuk memancarkan telemetri ke Azure Monitor. Agen-agen ini juga dapat didaftarkan di Azure AI Foundry. Untuk panduan khusus kerangka kerja, lihat Mengaktifkan pelacakan untuk agen yang dibangun di LangChain & LangGraph dan Mengaktifkan pelacakan untuk agen yang dibangun di OpenAI Agents SDK.

Setelah telemetri tersedia, Anda siap untuk menjelajahi tampilan detail agen Application Insights.

Jika Anda memilih untuk mengumpulkan informasi permintaan lengkap, misalnya dengan menggunakan flag EnableSensitiveData di Kerangka Kerja Agen, Anda dapat mencari dalam tampilan Pencarian dan meninjau percakapan yang mencakup pesan asisten, perintah sistem, dan penggunaan alat, pada tampilan Detail Transaksi.

Beri setiap agen nama yang berbeda sehingga Anda dapat membedakannya dalam tampilan detail Agen. Jika komponen agenik Anda adalah bagian dari aplikasi yang lebih besar, pertimbangkan untuk mengirimkannya ke sumber daya Application Insights yang ada.

Jika Anda juga ingin melihat agen Anda di Azure AI Foundry selain Azure Monitor, menyambungkan sumber daya Application Insights ke proyek Foundry Anda.

Anda juga dapat menyiapkan evaluasi dengan cara berikut:

• Evaluasi batch
  • Evaluasi Lokal dengan Azure AI Evaluation SDK:Jalankan evaluasi pada mesin pengembangan Anda selama pengujian.
  • Evaluasi cloud dengan Foundry SDK:Laksanakan di Azure untuk himpunan data yang lebih besar atau kolaborasi tim.
  • Evaluasi berbasis portal Foundry:Gunakan portal Foundry untuk alur kerja evaluasi tanpa kode.
• Evaluasi berkelanjutan:Siapkan evaluasi otomatis yang berjalan terhadap lalu lintas produksi untuk mendeteksi regresi kualitas.

Setelah Anda menyelesaikan penyiapan untuk skenario Anda, jalankan aplikasi Anda dan tunggu beberapa menit agar telemetri muncul di Application Insights. Kemudian jelajahi pengalaman Application Insights.

Penting

Jika Anda masih menggunakan SDK API Klasik Application Insights, lihat Migrasi dari SDK API Klasik Application Insights ke Azure Monitor OpenTelemetry.

Petunjuk / Saran

Untuk meninjau informasi .NET atau Node.js API SDK klasik yang diarsipkan, lihat API 2.x.

Integrasi OpenTelemetry lainnya di Azure

Gunakan sumber daya berikut untuk layanan Azure, kit pengembangan perangkat lunak (SDK), dan alat yang menggunakan OpenTelemetry:

• Konvensi semantik Azure SDK
• Penjejakan Java di Azure SDK
• Observabilitas Azure Cosmos DB SDK
• Observabilitas .NET menggunakan OpenTelemetry
• Pipeline Azure Monitor di konfigurasi edge dan multicloud
• Penggunaan OpenTelemetry ke dalam Azure Data Explorer, Azure Synapse Data Explorer, dan Real-Time Intelligence
• Azure Container Apps agen OpenTelemetry
• Gambaran umum dasbor Aspire

Pemecahan masalah

Untuk bantuan pemecahan masalah Application Insights, lihat dokumentasi pemecahan masalah khusus kami.

Bantuan dan dukungan

dukungan teknis Azure

Untuk masalah Azure support, buka tiket Azure support.

Pertanyaan Umum

Kirim pertanyaan umum ke forum Pertanyaan dan Jawaban Microsoft.

Pertanyaan Pengkodian

Posting pertanyaan pengkodian ke Stack Overflow dengan menggunakan azure-application-insights tag.

Komunitas Umpan Balik

Tinggalkan umpan balik produk untuk tim rekayasa di Komunitas Umpan Balik.