Not
Bu sayfaya erişim yetkilendirme gerektiriyor. Oturum açmayı veya dizinleri değiştirmeyi deneyebilirsiniz.
Bu sayfaya erişim yetkilendirme gerektiriyor. Dizinleri değiştirmeyi deneyebilirsiniz.
Bağlantı dizeleri, enstrümante edilmiş uygulamanızın hangi Application Insights kaynağına telemetri verisi göndereceğini belirtir. Bir bağlantı dizesi, her biri anahtar-değer çifti olarak temsil edilen ve noktalı virgüllerle ayrılan birden fazla 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 araç-alet anahtarı (ikey) ve bir ApplicationId 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 sır olarak kabul edilmez. Bağlantı dizeleri, ApplicationId değeri eklenerek geliştirilmektedir. Bu güncelleme, Open Telemetry SDK kullanan senaryolar için otomatik araç desteği sunan yeni bir özelliktir. Uygulama İçgörüleri kaynağınızı kötü kullanımdan korumak istiyorsanız, aktarım uç noktası, Microsoft Entra ID'ye dayanan doğrulamalı telemetri aktarım seçenekleri sunar.
Uyarı
31 Mart 2025 tarihinde, enstrümantasyon anahtarının alınması için verilen destek sona erecek. Enstrümantasyon anahtar alımı çalışmaya devam edecek, ancak bu özellik için artık güncelleme veya destek sağlamayacağız. Bağlantı dizelerine geçiş yapın yeni olanaklardan yararlanmak için.
Bağlantı dizesi yetenekleri
- 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, Application Insights için Microsoft Entra kimlik doğrulaması kullanılarak kimlik doğrulamalı telemetri alımına olanak tanır.
- Özelleştirilmiş uç noktalar (egemen veya hibrit bulut ortamları): Uç nokta ayarları, verilerin belirli bir Azure Hükümet bölgesine gönderilmesine olanak tanır. (Ö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ı dizginizi bulun.
Bağlantı dizesi, Uygulama İçgörüleri kaynağınızın Genel Bakış bölümünde görünür.
Şema
Şema öğeleri aşağıdaki bölümlerde açıklanmaktadır.
Maksimum uzunluk
Bağlantı için desteklenen maksimum uzunluk 4.096 karakterdir.
Anahtar-değer çiftleri
Bağlantı dizesi, noktalı virgülle ayrılmış anahtar-değer çiftleri olarak temsil edilen bir ayar listesi içerir: key1=value1;key2=value2;key3=value3
İpucu
Bu belgede yapılandırılabilir anahtar-değer çiftleri ele alınmaktadır. Bazı anahtar-değer çiftleri yapılandırılamaz ve ApplicationId gibi otomatik olarak ayarlanır. Ortamınızda gözlemleniyorsa bu tür çiftler göz ardı edilebilir.
Sözdizimi
InstrumentationKey(örneğin, 00000000-0000-0000-0000-000000000000).InstrumentationKeybir zorunlu alandır.Authorization(örneğin, ikey). Bu ayar isteğe bağlıdır çünkü bugün yalnızca ikey yetkilendirmesini destekliyoruz.EndpointSuffix(örneğin, applicationinsights.azure.cn). Uç nokta ekini ayarlamak, SDK'ya hangi Azure bulutuna bağlanması gerektiğini söyler. 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 hizmet açıkça geçersiz kılınabilir.
-
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
-
Telemetri Alımı:
dc -
Canlı Ölçümler:
live -
.NET için Profil Oluşturucu:
profiler -
Anlık görüntü:
snapshot
Bağlantı dizesi örnekleri
İşte bağlantı dizelerinin bazı örnekleri.
Uç nokta soneki ile bağlantı dizesi
InstrumentationKey=00000000-0000-0000-0000-000000000000;EndpointSuffix=ai.contoso.com;
Bu örnekte, bağlantı dizesi uç nokta sonekini 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 Profiler:
https://profiler.ai.contoso.com - Hata ayıklayıcı:
https://snapshot.ai.contoso.com
- Yutma:
Açık uç nokta aşmaları içeren 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 belirgin 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 Profiler:
https://custom.com:333/ - Hata ayıklayıcı:
https://custom.com:444/
- Yutma:
Açıkça belirtilen bölge ile bağlantı dizesi
InstrumentationKey=00000000-0000-0000-0000-000000000000;IngestionEndpoint=https://southcentralus.in.applicationinsights.azure.com/
Bu örnekte, bağlantı dizesi Güney Merkez 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/
- Yutma:
Mevcut bölgeleri listelemek için Azure CLI'de aşağıdaki komutu çalıştırın:
az account list-locations -o table
Bir bağlantı dizesi ayarla
Tüm OpenTelemetry teklifleri ve aşağıdaki SDK sürümlerinden itibaren bağlantı dizilerini destekler:
- .NET v2.12.0
- JavaScript v2.3.0
- NodeJS v1.5.0
- Java v3.1.1
Bir bağlantı dizesini kodda, bir ortam değişkeni kullanarak veya bir yapılandırma dosyasıyla ayarlayabilirsiniz.
Çevre 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 Çerçevesi | Application Insights SDK'sı | AzMon Exporter |
| Java | GEÇERLİ DEĞİL | Java aracısı |
| JavaScript | JavaScript (Web) SDK Yükleyici Betiği | GEÇERLİ DEĞİL |
| Node.js | Application Insights SDK'sı | AzMon OTel Distro |
| Piton | OpenCensus Python SDK'sı kullanımdan kaldırıldı. | AzMon OTel Distro |
Sonraki adımlar
Sık sorulan soruları (SSS) gözden geçirmek için:
Çalışma zamanında başlamak için:
- Azure Sanal Makine (VM) ve Azure Sanal Makine Ölçek Kümeleri IIS barındırılan uygulamalar
- Internet Information Server (IIS) sunucusu
- Azure Uygulama Hizmeti'nin Web Uygulamaları özelliği
Geliştirme zamanında şu adımlarla başlayın: