Application Insights'ta bağlantı dizeleri

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.

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

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

• Telemetri Alımı: dc
• Canlı Ölçümler: live
• Profil Oluşturucu: profiler
• Anlık görüntü: snapshot

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

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:

• Azure Sanal Makine (VM) ve Azure Sanal Makine Ölçek Kümeleri IIS tarafından barındırılan uygulamalar
• Internet Information Server (IIS) sunucusu
• Azure Uygulaması Hizmeti'nin Web Apps özelliği

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

• ASP.NET Core
• ASP.NET
• Java
• Node.js
• Python