Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
String koneksi menentukan ke sumber daya Application Insights mana aplikasi Anda yang berinstrumentasi harus mengirimkan data telemetri. Sebuah 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 kunci instrumentasi (ikey) dan ApplicationId.
Ikey adalah 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. String koneksi ditingkatkan dengan menambahkan nilai ApplicationId. Pembaruan ini adalah fitur baru yang mendukung instrumentasi otomatis untuk skenario yang menggunakan Open Telemetry SDK. 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 pemasukan 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 sambungan membuat penyerapan telemetri lebih andal dengan menghilangkan ketergantungan pada titik akhir penyerapan global.
- Keamanan: String koneksi memungkinkan penyerapan telemetri yang diautentikasi dengan menggunakan autentikasi Microsoft Entra untuk Application Insights.
- Titik akhir yang dikustomisasi (lingkungan sovereign atau cloud hibrid): Pengaturan titik akhir memungkinkan pengiriman data ke region 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
Tips
Pasangan kunci-nilai yang dapat dikonfigurasi tercakup dalam dokumen ini. Beberapa pasangan kunci-nilai tidak dapat dikonfigurasi dan diatur secara otomatis, seperti ApplicationId. Pasangan 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). Menetapkan akhiran titik akhir memberi tahu SDK awan Azure mana yang harus dihubungkan. SDK menyusun bagian lain dari endpoint untuk layanan individu.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 sebuah layanan.
- Suffix: 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 untuk .NET:
profiler -
Cuplikan:
snapshot
Contoh string koneksi
Berikut adalah beberapa contoh string koneksi.
String koneksi dengan sufiks titik akhir
InstrumentationKey=00000000-0000-0000-0000-000000000000;EndpointSuffix=ai.contoso.com;
Dalam contoh ini, string koneksi menentukan akhiran titik akhir dan SDK membangun titik akhir layanan.
- Skema otorisasi bawaan adalah "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 untuk .NET:
https://profiler.ai.contoso.com - Debugger:
https://snapshot.ai.contoso.com
- Penyerapan:
String koneksi dengan penggantian titik akhir secara 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 penggantian eksplisit untuk setiap layanan. SDK menggunakan titik akhir yang tepat yang disediakan tanpa modifikasi:
- Skema otorisasi bawaan adalah "ikey"
- Kunci instrumentasi: 00000000-0000-0000-0000-000000000000
- URI layanan regional didasarkan pada nilai penggantian eksplisit:
- Penyerapan:
https://custom.com:111/ - Metrik Langsung:
https://custom.com:222/ - Profiler untuk .NET:
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:
- Skema otorisasi bawaan adalah "ikey"
- Kunci instrumentasi: 00000000-0000-0000-0000-000000000000
- URI layanan regional didasarkan pada nilai penggantian 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
Tetapkan 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
- Java v3.1.1
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 |
|---|---|---|
| ASP.NET Core | 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 |
| Phyton | OpenCensus Python SDK telah dihentikan. | AzMon OTel Distro |
Langkah berikutnya
Untuk meninjau tanya jawab umum (FAQ):
Mulai saat runtime dengan:
- Azure Virtual Machine (VM) dan Azure Virtual Machine Scale Sets aplikasi yang dihosting di IIS
- Server Internet Information (IIS)
- Fitur Web Apps dari Azure App Service
Mulailah selama waktu pengembangan dengan: