String koneksi di Application Insights
String koneksi menentukan sumber daya Application Insights mana yang harus dikirim oleh aplikasi berinstrumentasi Anda. string koneksi terdiri dari beberapa pengaturan, masing-masing diwakili sebagai pasangan kunci-nilai dan dipisahkan oleh titik koma. Metode konfigurasi terkonsolidasi ini menyederhanakan proses penyiapan dengan menghilangkan kebutuhan akan beberapa pengaturan proksi.
Penting
String koneksi berisi ikey, yang merupakan pengidentifikasi unik yang digunakan oleh layanan penyerapan untuk mengaitkan telemetri ke sumber daya Application Insights tertentu. Pengidentifikasi unik Ikey bukan token keamanan atau kunci keamanan, dan tidak dianggap sebagai rahasia.
Jika Anda ingin melindungi sumber daya Application Insights dari penyalahgunaan, titik akhir penyerapan menyediakan opsi penyerapan telemetri terautentikasi berdasarkan ID Microsoft Entra.
Catatan
Pada tanggal 31 Maret 2025, dukungan untuk penyerapan kunci instrumentasi akan berakhir. Penyerapan kunci instrumentasi akan berjalan terus, namun kami tidak akan lagi menyediakan pembaruan atau dukungan terhadap fitur tersebut. Transisi ke string koneksi untuk memanfaatkan kemampuan baru.
Kemampuan string koneksi
- Keandalan: String koneksi membuat penyerapan telemetri lebih andal dengan menghapus dependensi pada titik akhir penyerapan global.
- Keamanan: String koneksi memungkinkan penyerapan telemetri yang diautentikasi dengan menggunakan autentikasi Microsoft Entra untuk Application Insights.
- Titik akhir yang disesuaikan (lingkungan sovereign atau cloud hibrid): Pengaturan titik akhir memungkinkan pengiriman data ke wilayah Azure Government tertentu. (Lihat contoh.)
- Privasi (titik akhir regional): String koneksi memudahkan masalah privasi dengan mengirim data ke titik akhir regional, memastikan data tidak meninggalkan wilayah geografis.
Menemukan string koneksi Anda
String koneksi Anda muncul di bagian Gambaran Umum sumber daya Application Insights Anda.
Skema
Elemen skema dijelaskan di bagian berikut.
Panjang maksimum
Koneksi memiliki panjang maksimum yang didukung yaitu 4.096 karakter.
Pasangan kunci-nilai
String koneksi terdiri dari daftar pengaturan yang direpresentasikan sebagai pasangan nilai kunci yang dipisahkan oleh titik koma: key1=value1;key2=value2;key3=value3
Tip
Pasangan kunci-nilai yang dapat dikonfigurasi tercakup dalam dokumen ini. Beberapa pasangan kunci-nilai tidak dapat dikonfigurasi dan diatur secara otomatis, seperti ApplicationId. Ini dapat diabaikan dengan aman jika diamati di lingkungan Anda.
Sintaks
InstrumentationKey(misalnya, 00000000-0000-0000-0000-000000000000).InstrumentationKeyadalah bidang yang diperlukan .Authorization(misalnya, ikey). Pengaturan ini opsional karena hari ini kami hanya mendukung otorisasi ikey.EndpointSuffix(misalnya, applicationinsights.azure.cn). Mengatur akhiran titik akhir memberi tahu SDK cloud Azure mana yang akan disambungkan. SDK merakitan sisa titik akhir untuk layanan individual.Titik akhir eksplisit. Layanan apa pun dapat diganti secara eksplisit dalam string koneksi:
IngestionEndpoint(misalnya,https://dc.applicationinsights.azure.com)LiveEndpoint(misalnya,https://live.applicationinsights.azure.com)ProfilerEndpoint(misalnya,https://profiler.monitor.azure.com)SnapshotEndpoint(misalnya,https://snapshot.monitor.azure.com)
Skema titik akhir
<prefix>.<suffix>
- Awalan: Mendefinisikan layanan.
- Akhiran: Menentukan nama domain umum.
Akhiran yang valid
- applicationinsights.azure.cn
- applicationinsights.us
Untuk informasi selengkapnya, lihat Wilayah yang memerlukan modifikasi titik akhir.
Awalan yang valid
- Penyerapan Telemetri:
dc - Metrik Langsung:
live - Profiler:
profiler - Rekam jepret:
snapshot
Contoh string koneksi
Berikut adalah beberapa contoh string koneksi.
String koneksi dengan akhiran titik akhir
InstrumentationKey=00000000-0000-0000-0000-000000000000;EndpointSuffix=ai.contoso.com;
Dalam contoh ini, string koneksi menentukan akhiran titik akhir dan titik akhir layanan konstruksi SDK:
- Default skema otorisasi ke "ikey"
- Kunci instrumentasi: 00000000-0000-0000-0000-000000000000
- Pengidentifikasi Sumber Daya Seragam (URI) layanan regional didasarkan pada akhiran titik akhir yang disediakan:
- Penyerapan:
https://dc.ai.contoso.com - Metrik langsung:
https://live.ai.contoso.com - Profiler:
https://profiler.ai.contoso.com - Debugger:
https://snapshot.ai.contoso.com
- Penyerapan:
String koneksi dengan penggantian titik akhir eksplisit
InstrumentationKey=00000000-0000-0000-0000-000000000000;IngestionEndpoint=https://custom.com:111/;LiveEndpoint=https://custom.com:222/;ProfilerEndpoint=https://custom.com:333/;SnapshotEndpoint=https://custom.com:444/;
Dalam contoh ini, string koneksi menentukan pengambilalihan eksplisit untuk setiap layanan. SDK menggunakan titik akhir yang tepat yang disediakan tanpa modifikasi:
- Default skema otorisasi ke "ikey"
- Kunci instrumentasi: 00000000-0000-0000-0000-000000000000
- URI layanan regional didasarkan pada nilai penimpaan eksplisit:
- Penyerapan:
https://custom.com:111/ - Metrik langsung:
https://custom.com:222/ - Profiler:
https://custom.com:333/ - Debugger:
https://custom.com:444/
- Penyerapan:
String koneksi dengan wilayah eksplisit
InstrumentationKey=00000000-0000-0000-0000-000000000000;IngestionEndpoint=https://southcentralus.in.applicationinsights.azure.com/
Dalam contoh ini, string koneksi menentukan wilayah US Tengah Selatan:
- Default skema otorisasi ke "ikey"
- Kunci instrumentasi: 00000000-0000-0000-0000-000000000000
- URI layanan regional didasarkan pada nilai penimpaan eksplisit:
- Penyerapan:
https://southcentralus.in.applicationinsights.azure.com/
- Penyerapan:
Untuk mencantumkan wilayah yang tersedia, jalankan perintah berikut ini di Azure CLI:
az account list-locations -o table
Mengatur string koneksi
Semua penawaran OpenTelemetry kami dan versi SDK berikut dan seterusnya mendukung string koneksi:
- .NET v2.12.0
- JavaScript v2.3.0
- NodeJS v1.5.0
- Python v1.0.0
Anda dapat mengatur string koneksi dalam kode, dengan menggunakan variabel lingkungan, atau file konfigurasi.
Variabel lingkungan
String koneksi: APPLICATIONINSIGHTS_CONNECTION_STRING
Sampel kode
| Bahasa | API Klasik | OpenTelemetry |
|---|---|---|
| Inti ASP.NET | Application Insights SDK | AzMon OTel Distro |
| .NET Framework | Application Insights SDK | Pengekspor AzMon |
| Java | N/A | Agen Java |
| JavaScript | Skrip Pemuat SDK JavaScript (Web) | N/A |
| Node.js | Application Insights SDK | AzMon OTel Distro |
| Python | OpenCensus Python SDK | AzMon OTel Distro |
Tanya jawab umum
Bagian ini menyediakan jawaban atas pertanyaan umum.
Apakah wilayah Azure baru memerlukan penggunaan string koneksi?
Wilayah Azure baru mewajibkan penggunaan string koneksi, dan bukan kunci instrumentasi. String koneksi mengidentifikasi sumber daya yang ingin Anda kaitkan dengan data telemetri Anda. Ini juga memungkinkan Anda untuk memodifikasi titik akhir yang digunakan sumber daya Anda sebagai tujuan telemetri Anda. Salin string koneksi dan tambahkan ke kode aplikasi Anda atau ke variabel lingkungan.
Haruskah saya menggunakan string koneksi atau kunci instrumentasi?
Kami menyarankan agar Anda menggunakan string koneksi alih-alih kunci instrumentasi.
Langkah berikutnya
Mulai pada runtime dengan:
- Azure Virtual Machine (VM) dan Azure Virtual Machine Scale Sets aplikasi yang dihosting IIS
- Server Internet Information Server (IIS)
- Fitur Web Apps dari Azure App Service
Mulai pada waktu pengembangan dengan: