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 sumber daya Application Insights ke mana aplikasi yang telah diinstrumentasi harus mengirim data telemetri. 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. Untuk meningkatkan string koneksi, tambahkan nilai ApplicationId. Pembaruan ini adalah fitur baru yang mendukung instrumentasi otomatis untuk skenario yang menggunakan Open Telemetry SDK. Untuk melindungi sumber daya Application Insights Anda dari penyalahgunaan, titik akhir penyerapan menyediakan opsi penyerapan telemetri yang diautentikasi berdasarkan Microsoft Entra ID.
Kemampuan "Connection string"
- 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 kustom (lingkungan cloud berdaulat atau 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.
Temukan string koneksi Anda
Anda dapat menemukan string koneksi di bagian Overview sumber daya Application Insights Anda.
Skema
Bagian berikut menjelaskan elemen skema.
Panjang maksimum
Koneksi mendukung hingga 4.096 karakter.
Pasangan kunci-nilai
string koneksi terdiri dari daftar pengaturan yang direpresentasikan sebagai pasangan kunci-nilai yang dipisahkan oleh titik koma: key1=value1;key2=value2;key3=value3
Tips
Dokumen ini mencakup pasangan kunci-nilai yang dapat dikonfigurasi. Beberapa pasangan kunci-nilai tidak dapat dikonfigurasi dan diatur secara otomatis, seperti ApplicationId. Anda dapat mengabaikan pasangan ini dengan aman jika melihatnya di lingkungan Anda.
Sintaks
InstrumentationKey(misalnya, 00000000-0000-0000-0000-000000000000).InstrumentationKeyadalah bidang yang diperlukan .Authorization(misalnya, ikey). Pengaturan ini bersifat opsional karena hari ini SDK hanya mendukung otorisasi ikey.EndpointSuffix(misalnya, applicationinsights.azure. cn). Mengatur akhiran endpoint memberi tahu SDK cloud Azure mana yang harus dihubungkan. SDK menyusun bagian lain dari endpoint untuk layanan individu.Titik akhir eksplisit. Anda dapat secara eksplisit mengambil alih layanan apa pun di 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 Connection String
Berikut adalah beberapa contoh string koneksi.
Connection string dengan akhiran endpoint
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 (alat pelacak kesalahan):
https://snapshot.ai.contoso.com
- Penyerapan:
String koneksi dengan pengaturan ulang 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 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 (alat pelacak kesalahan):
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 di Azure CLI:
az account list-locations -o table
Tetapkan string koneksi
Untuk mempelajari tentang mengatur string koneksi, lihat Konfigurasi OpenTelemetry dan autentikasi Microsoft Entra untuk Application Insights.
Telemetri browser terautentikasi menggunakan string koneksi
Saat organisasi menonaktifkan autentikasi lokal di Application Insights untuk memberlakukan Microsoft Entra ID, JavaScript SDK tidak dapat mengautentikasi langsung untuk telemetri berbasis browser, dan telemetri mungkin berhenti mengalir.
Pola praktis adalah merutekan telemetri browser melalui Azure API Management (APIM), yang:
- Mengautentikasi ke Application Insights dengan menggunakan identitas terkelola.
- Meneruskan permintaan ke titik akhir penyerapan regional atas nama Anda.
Dengan penyiapan ini, string koneksi Anda terus mengidentifikasi sumber daya Application Insights tujuan, tetapi IngestionEndpoint menunjuk ke URL proksi APIM Anda.
Untuk panduan menyeluruh, termasuk kebijakan CORS dan APIM, lihat: Menggunakan Azure API Management sebagai proksi untuk Telemetri Application Insights.
Langkah berikutnya
Untuk meninjau tanya jawab umum (FAQ), lihat:
Mulai menggunakan: