Uygulama İçgörüleri'nde Bağlantı Dizileri

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. Konsolide edilmiş bu yapılandırma yöntemi, birden fazla vekil ayarı yapma gerekliliğini ortadan kaldırarak kurulum sürecini basitleştirir.

Önemli

Bağlantı dizesi, bir izleme anahtarı (ikey) ve bir Uygulama ID içerir.

Ikey, telemetriyi belirli bir Application Insights kaynağıyla ilişkilendirmek için yutma hizmeti tarafından kullanılan benzersiz bir tanımlayıcıdır. Ikey benzersiz tanımlayıcıları güvenlik belirteçleri veya güvenlik anahtarları değildir ve gizli dizi olarak kabul edilmez. Bağlantı dizelerini geliştirmek için ApplicationId değerini ekleyin. Bu güncelleme, Open Telemetry SDK kullanan senaryolar için otomatik araç desteği sunan yeni bir özelliktir. Application Insights kaynağınızı kötüye kullanıma karşı korumak için, alma uç noktası Microsoft Entra ID temelinde kimliği doğrulanmış telemetri alımı seçenekleri sağlar.

Connection string özellikleri

  • Güvenilirlik: Bağlantı dizeleri, küresel alma uç noktalarına bağımlılıkları ortadan kaldırarak telemetri alımını daha güvenilir hale getirir.
  • Güvenlik: Bağlantı dizeleri, Microsoft Entra kimlik doğrulaması kullanarak Application Insights için 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. (Örnekleri gör.)
  • Gizlilik (bölgesel uç noktalar): Bağlantı dizeleri, verileri bölgesel uç noktalara göndererek gizlilik endişelerini azaltır ve verilerin bir coğrafi bölgeyi terk etmemesini sağlar.

Bağlantı dizesini bulun

Connection String'i, Application Insights kaynağınızın Overview bölümünde bulabilirsiniz.

Application Insights genel bakışını ve bağlantı dizesini gösteren ekran görüntüsü.

Şema

Aşağıdaki bölümlerde şema öğeleri açıklanmaktadır.

Maksimum uzunluk

Bağlantı en fazla 4.096 karakteri destekler.

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

Bu belge yapılandırılabilir anahtar-değer çiftlerini kapsar. Bazı anahtar-değer çiftleri yapılandırılamaz ve ApplicationId gibi otomatik olarak ayarlanır. Ortamınızda bu çiftleri görürseniz onları güvenle yoksayabilirsiniz.

Sözdizimi

  • InstrumentationKey (örneğin, 00000000-0000-0000-0000-000000000000). InstrumentationKey bir zorunlu alandır.

  • Authorization (örneğin, ikey). Bugün SDK yalnızca ikey yetkilendirmesini desteklediğinden bu ayar isteğe bağlıdır.

  • EndpointSuffix (örneğin, applicationinsights.azure. cn). Uç nokta ekini ayarlamak, SDK'ya hangi Azure bulutuna bağlanacağını bildirir. SDK, tek tek hizmetler için uç noktasının geri kalanını bir araya getirir.

  • Açık uç noktaları. Bağlantı dizesinde herhangi bir hizmeti açıkça geçersiz kılabilirsiniz.

    • IngestionEndpoint (örneğin, https://dc.applicationinsights.azure.com)
    • LiveEndpoint (örneğin, https://live.applicationinsights.azure.com)
    • ProfilerEndpoint (örneğin, https://profiler.monitor.azure.com)
    • SnapshotEndpoint (örneğin, https://snapshot.monitor.azure.com)

Uç nokta şeması

<prefix>.<suffix>

  • Önek: Bir hizmeti tanımlar.
  • Ek: Ortak etki alanı adını tanımlar.

Geçerli son ekler

  • applicationinsights.azure.cn
  • applicationinsights.us

Daha fazla bilgi için bkz. Uç nokta modifikasyonu gerektiren bölgeler.

Geçerli ön ekler

Bağlantı dizesi örnekleri

İşte bağlantı dizelerinin bazı örnekleri.

Uç nokta eki içeren bağlanı dizgesi

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 sistemi varsayılan olarak "ikey" seçeneğini kullanır.
  • Enstrümantasyon anahtarı: 00000000-0000-0000-0000-000000000000
  • Bölgesel hizmet Birleşik Kaynak Tanımlayıcıları (URIs), sağlanan uç nokta son ekine dayanır.
    • Yutma: https://dc.ai.contoso.com
    • Canlı Metrikler: https://live.ai.contoso.com
    • .NET için profil oluşturucu: https://profiler.ai.contoso.com
    • Hata ayıklayıcı: https://snapshot.ai.contoso.com

Açık uç nokta geçersiz kılmaları ile "Connection string"

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, sağlanan uç noktaları aynen değişiklik yapmadan kullanır.

  • Yetkilendirme sistemi varsayılan olarak "ikey" seçeneğini kullanır.
  • Enstrümantasyon anahtarı: 00000000-0000-0000-0000-000000000000
  • Bölgesel servis URI'leri, açıkça belirtilmiş geçersiz kılma değerlerine dayanmaktadır.
    • Yutma: https://custom.com:111/
    • Canlı Metrikler: https://custom.com:222/
    • .NET için profil oluşturucu: https://custom.com:333/
    • Hata ayıklayıcı: https://custom.com:444/

Açık bir bölgeye sahip 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 sistemi varsayılan olarak "ikey" seçeneğini kullanır.
  • Enstrümantasyon anahtarı: 00000000-0000-0000-0000-000000000000
  • Bölgesel servis URI'leri, açıkça belirtilmiş geçersiz kılma değerlerine dayanmaktadır.
    • Yutma: https://southcentralus.in.applicationinsights.azure.com/

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

az account list-locations -o table

Bağlantı dizesi ayarla

Bağlantı dizesini ayarlama hakkında bilgi için OpenTelemetry Configuration ve Application Insights için Microsoft Entra kimlik doğrulaması bölümüne bakın.

Bağlantı dizelerini kullanarak kimliği doğrulanmış tarayıcı telemetrisi

Kuruluşlar Microsoft Entra ID zorlamak için Application Insights'ta yerel kimlik doğrulamasını devre dışı bıraktığında, JavaScript SDK'sı tarayıcı tabanlı telemetri için doğrudan kimlik doğrulaması yapamaz ve telemetri akışını durdurabilir.

Pratik bir desen, tarayıcı telemetrisini Azure API Management (APIM) aracılığıyla yönlendirmektir:

  • Yönetilen kimlik kullanarak Application Insights'ta kimlik doğrulaması yapar.
  • İstekleri sizin yerinize bölgesel alım uç noktasına iletir.

Bu kurulumla, bağlantı dizesi hedef Application Insights kaynağını tanımlamaya devam eder, ancak IngestionEndpoint APIM proxy URL'nize işaret eder.

CORS ilkeleri ve APIM ilkeleri de dahil olmak üzere uçtan uca yönergeler için bkz. Azure API Management'ı Application Insights Telemetrisi için bir eşleme olarak kullanma.

Sonraki adımlar

Sık sorulan soruları (SSS) gözden geçirmek için bkz:

Kullanmaya başlayın:

  • Last updated on