Application Insights'ta bağlantı dizeleri

Makale
10/29/2024

Bağlantı dizeleri, izlemeli uygulamanızın telemetri verilerini göndermesi gereken Application Insights kaynağını belirtir. bağlantı dizesi, her biri anahtar-değer çifti olarak temsil edilen ve noktalı virgülle ayrılmış birden çok ayardan oluşur. Bu birleştirilmiş yapılandırma yöntemi, birden çok ara sunucu ayarı gereksinimini ortadan kaldırarak kurulum işlemini basitleştirir.

Önemli

bağlantı dizesi, veri alımı hizmeti tarafından telemetriyi belirli bir Application Insights kaynağıyla ilişkilendirmek için kullanılan benzersiz bir tanımlayıcı olan bir ikey içerir. Ikey benzersiz tanımlayıcıları güvenlik belirteçleri veya güvenlik anahtarları değildir ve gizli dizi olarak kabul edilmez.

Application Insights kaynağınızı kötüye kullanıma karşı korumak istiyorsanız, alma uç noktası Microsoft Entra Kimliği'ne göre kimliği doğrulanmış telemetri alımı seçenekleri sağlar.

Not

31 Mart 2025’te izleme anahtarı alımı desteği sona erecektir. İzleme anahtarı alımı çalışmaya devam edecek, ancak artık özellik için güncelleştirme veya destek sağlamayacağız. Yeni özelliklerden yararlanmak için bağlantı dizesi geçiş.

Bağlantı dizesi özellikleri

Güvenilirlik: Bağlantı dizeleri, genel alım uç noktalarındaki bağımlılıkları kaldırarak telemetri alımını daha güvenilir hale getirir.
Güvenlik: Bağlantı dizeleri, Application Insights için Microsoft Entra kimlik doğrulamasını kullanarak kimliği doğrulanmış telemetri alımına izin verir.
Özelleştirilmiş uç noktalar (bağımsız veya karma bulut ortamları): Uç nokta ayarları belirli bir Azure Kamu bölgeye veri gönderilmesine izin verir. (Örneklere bakın.)
Gizlilik (bölgesel uç noktalar): Bağlantı dizeleri, verileri bölgesel uç noktalara göndererek gizlilik sorunlarını kolaylaştırır ve verilerin coğrafi bölgeden ayrılmamasını sağlar.

Bağlantı dizenizi bulma

bağlantı dizesi Application Insights kaynağınızın Genel Bakış bölümünde görünür.

Şema

Şema öğeleri aşağıdaki bölümlerde açıklanmıştır.

Maksimum uzunluk

Bağlantının desteklenen uzunluk üst sınırı 4.096 karakterdir.

Anahtar değer çiftleri

bağlantı dizesi, noktalı virgülle ayrılmış anahtar-değer çiftleri olarak temsil edilen ayarların bir listesinden oluşur:key1=value1;key2=value2;key3=value3

İpucu

Yapılandırılabilir anahtar-değer çiftleri bu belgede ele alınmıştır. Bazı anahtar-değer çiftleri yapılandırılamaz ve gibi otomatik olarak ApplicationIdayarlanır. Bunlar ortamınızda gözlemleniyorsa güvenle yoksayılabilir.

Sözdizimi

InstrumentationKey (örneğin, 00000000-0000-0000-0000-00000000000000). InstrumentationKeygerekli bir alandır.
Authorization (örneğin, ikey). Bugün yalnızca ikey yetkilendirmeyi desteklediğimiz için bu ayar isteğe bağlıdır.
EndpointSuffix (örneğin, applicationinsights.azure.cn). Uç nokta sonekini ayarlamak SDK'ya hangi Azure buluta bağlanacaklarını bildirir. SDK, tek tek hizmetler için uç noktanın geri kalanını bir araya getirerek.
Açık uç noktalar. Herhangi bir hizmet, bağlantı dizesi açıkça geçersiz kılınabilir:
- IngestionEndpoint (örnek, https://dc.applicationinsights.azure.com)
- LiveEndpoint (örnek, https://live.applicationinsights.azure.com)
- ProfilerEndpoint (örnek, https://profiler.monitor.azure.com)
- SnapshotEndpoint (örnek, https://snapshot.monitor.azure.com)

Uç nokta şeması

<prefix>.<suffix>

Ön ek: Bir hizmeti tanımlar.
Sonek: Ortak etki alanı adını tanımlar.

Geçerli sonekler

applicationinsights.azure.cn
applicationinsights.us

Daha fazla bilgi için bkz . Uç nokta değişikliği gerektiren bölgeler.

Geçerli ön ekler

Bağlantı dizesi örnekleri

bağlantı dizesi örnekleri aşağıda verilmiştir.

Uç nokta soneki ile bağlantı dizesi

InstrumentationKey=00000000-0000-0000-0000-000000000000;EndpointSuffix=ai.contoso.com;

Bu örnekte, bağlantı dizesi uç nokta son ekini belirtir ve SDK hizmet uç noktalarını oluşturur:

Yetkilendirme düzeni varsayılan olarak "ikey" olarak adlandırılır
İzleme anahtarı: 00000000-0000-0000-0000-0000000000000
Bölgesel hizmet Tekdüzen Kaynak Tanımlayıcıları (URI'ler) sağlanan uç nokta sonekini temel alır:
- Yenmesi: https://dc.ai.contoso.com
- Canlı ölçümler: https://live.ai.contoso.com
- Profiler: https://profiler.ai.contoso.com
- Hata ayıklayıcı: https://snapshot.ai.contoso.com

Açık uç nokta geçersiz kılmaları olan bağlantı dizesi

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/;

Bu örnekte, bağlantı dizesi her hizmet için açık geçersiz kılmalar belirtir. SDK, değişiklik yapılmadan sağlanan tam uç noktaları kullanır:

Yetkilendirme düzeni varsayılan olarak "ikey" olarak adlandırılır
İzleme anahtarı: 00000000-0000-0000-0000-0000000000000
Bölgesel hizmet URI'leri, açık geçersiz kılma değerlerini temel alır:
- Yenmesi: https://custom.com:111/
- Canlı ölçümler: https://custom.com:222/
- Profiler: https://custom.com:333/
- Hata ayıklayıcı: https://custom.com:444/

Açık bölge içeren bağlantı dizesi

InstrumentationKey=00000000-0000-0000-0000-000000000000;IngestionEndpoint=https://southcentralus.in.applicationinsights.azure.com/

Bu örnekte, bağlantı dizesi Orta Güney ABD bölgesini belirtir:

Yetkilendirme düzeni varsayılan olarak "ikey" olarak adlandırılır
İzleme anahtarı: 00000000-0000-0000-0000-0000000000000
Bölgesel hizmet URI'leri, açık geçersiz kılma değerlerini temel alır:
- Yenmesi: https://southcentralus.in.applicationinsights.azure.com/

Kullanılabilir bölgeleri listelemek için Azure CLI'da aşağıdaki komutu çalıştırın:

az account list-locations -o table

bağlantı dizesi ayarlama

Tüm OpenTelemetry tekliflerimiz ve aşağıdaki SDK sürümleri bağlantı dizesi destekler:

.NET v2.12.0
JavaScript v2.3.0
NodeJS v1.5.0
Python v1.0.0

Bir ortam değişkeni veya yapılandırma dosyası kullanarak kodda bir bağlantı dizesi ayarlayabilirsiniz.

Ortam değişkeni

Bağlantı dizesi: APPLICATIONINSIGHTS_CONNECTION_STRING

Kod örnekleri

Dil	Klasik API	OpenTelemetry
ASP.NET Core	Application Insights SDK'sı	AzMon OTel Distro
.NET Framework	Application Insights SDK'sı	AzMon Exporter
Java	Yok	Java aracısı
JavaScript	JavaScript (Web) SDK Yükleyici Betiği	Yok
Node.js	Application Insights SDK'sı	AzMon OTel Distro
Python	OpenCensus Python SDK'sı	AzMon OTel Distro

Sık sorulan sorular

Bu bölüm, sık sorulan soruların yanıtlarını sağlar.

Yeni Azure bölgeleri için bağlantı dizesi kullanımı gerekiyor mu?

Yeni Azure bölgeleri, izleme anahtarları yerine bağlantı dizesi kullanımını gerektirir. Bağlantı dizesi, telemetri verilerinizle ilişkilendirmek istediğiniz kaynağı tanımlar. Ayrıca kaynağınızın telemetriniz için hedef olarak kullandığı uç noktaları değiştirmenize de olanak tanır. bağlantı dizesi kopyalayın ve uygulamanızın koduna veya bir ortam değişkenine ekleyin.

bağlantı dizesi veya izleme anahtarlarını mı kullanmalıyım?

İzleme anahtarları yerine bağlantı dizesi kullanmanızı öneririz.

Sonraki adımlar

Çalışma zamanında şunlarla kullanmaya başlayın:

Geliştirme zamanında şunlarla kullanmaya başlayın:

Aracılığıyla paylaş