Bağlantı dizeleri
Bu makalede bağlantı dizesi nasıl kullanılacağı gösterilmektedir.
Genel bakış
Not
Aşağıdaki belgeler, Uygulama Analizler klasik API'sine dayanır. Uygulama Analizler için uzun vadeli plan, OpenTelemetry kullanarak veri toplamaktır. Daha fazla bilgi için bkz . .NET, Node.js, Python ve Java uygulamaları için Azure İzleyici OpenTelemetry'yi etkinleştirme.
Bağlan ion dizeleri telemetri verilerinin nereye gönderileceği tanımlar.
Anahtar-değer çiftleri, kullanıcıların her Uygulama Analizler hizmeti veya ürünü için bir ön ek soneki bileşimi tanımlaması için kolay bir yol 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ş.
Senaryoya genel bakış
Bu değişiklikten en çok etkilenen senaryolar:
Güvenlik duvarı özel durumları veya ara sunucu yeniden yönlendirmeleri:
İntranet web sunucusu izlemenin gerekli olduğu durumlarda, önceki çözümümüz yapılandırmanıza tek tek hizmet uç noktaları eklemenizi istedi. Daha fazla bilgi için bkz . Intranet web sunucusunu izleyebilir miyim?. Bağlan ion dizeleri, bu çabayı tek bir ayara indirgeyerek daha iyi bir alternatif sunar. Basit bir ön ek, sonek değişikliği, tüm uç noktaların otomatik olarak nüfusa ve doğru hizmetlere yeniden yönlendirilmesine olanak tanır.
Bağımsız veya hibrit bulut ortamları:
Kullanıcılar tanımlı bir Azure Kamu bölgeye veri gönderebilir. bağlantı dizesi kullanarak intranet sunucularınız veya karma bulut ayarlarınız için uç nokta ayarlarını tanımlayabilirsiniz.
Kullanmaya başlayın
Başlamak için aşağıdaki bölümleri gözden geçirin.
Bağlantı dizenizi bulma
bağlantı dizesi, Uygulama Analizler 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).InstrumentationKey
gerekli 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 bir sır mı?
bağlantı dizesi, veri alımı hizmeti tarafından telemetriyi belirli bir Uygulama Analizler kaynağıyla ilişkilendirmek için kullanılan benzersiz bir tanımlayıcı olan bir ikey içerir. Bu ikey benzersiz tanımlayıcıları güvenlik belirteçleri veya güvenlik anahtarları değildir. Yapay zeka kaynağınızı kötüye kullanıma karşı korumak istiyorsanız, alma uç noktası Microsoft Entra Id'ye göre kimliği doğrulanmış telemetri alımı seçenekleri sağlar.
Not
Application Analizler JavaScript SDK'sı, başlatma ve yapılandırma sırasında bağlantı dizesi geçirilmesini gerektirir. İstemci tarayıcılarında düz metin olarak görüntülenebilir. Tarayıcı telemetrisi için Microsoft Entra ID tabanlı kimlik doğrulamasını kullanmanın kolay bir yolu yoktur. Hizmet telemetrisinin güvenliğini sağlamanız gerekiyorsa tarayıcı telemetrisi için ayrı bir Uygulama Analizler kaynağı oluşturmanızı öneririz.
Bağlan ion dizesi örnekleri
bağlantı dizesi örnekleri aşağıda verilmiştir.
Uç nokta soneki ile Bağlan ion 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 URI'leri, sağlanan uç nokta son ekini 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
- Yenmesi:
Açık uç nokta geçersiz kılmalarıyla Bağlan ion 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/
- Yenmesi:
Açık bir bölgeye sahip Bağlan ion 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/
- Yenmesi:
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
Bağlan ion dizeleri aşağıdaki SDK sürümlerinde desteklenir:
- .NET v2.12.0
- Java v2.5.1 ve Java 3.0
- JavaScript v2.3.0
- NodeJS v1.5.0
- Python v1.0.0
Kodda veya ortam değişkeni veya yapılandırma dosyası kullanarak bir bağlantı dizesi ayarlayabilirsiniz.
Ortam değişkeni
Bağlan ion dizesi:APPLICATIONINSIGHTS_CONNECTION_STRING
Kod örnekleri
Dosyadaki bağlantı dizesi
appsettings.json
ayarlayın:{ "ApplicationInsights": { "ConnectionString" : "InstrumentationKey=00000000-0000-0000-0000-000000000000;IngestionEndpoint=https://{region}.in.applicationinsights.azure.com/;LiveEndpoint=https://{region}.livediagnostics.monitor.azure.com/" } }
Hizmeti kaydederken
ApplicationInsightsTelemetry
içindekiProgram.cs
bağlantı dizesi alın:var options = new ApplicationInsightsServiceOptions { ConnectionString = app.Configuration["ApplicationInsights:ConnectionString"] }; builder.Services.AddApplicationInsightsTelemetry(options: options);
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ğlan ion 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 VM ve Azure Sanal Makine Ölçek Kümeleri IIS tarafından barındırılan uygulamalar
- IIS sunucusu
- Azure Uygulaması Hizmeti'nin Web Apps özelliği
Geliştirme zamanında şunlarla kullanmaya başlayın: