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). 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 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

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/

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/

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

.NET 5.0+

1. 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/"
       }
   }
   

2. Hizmeti kaydederken ApplicationInsightsTelemetry içindeki Program.cs bağlantı dizesi alın:

   var options = new ApplicationInsightsServiceOptions { ConnectionString = app.Configuration["ApplicationInsights:ConnectionString"] };
   builder.Services.AddApplicationInsightsTelemetry(options: options);
   

.NET Framework

TelemetryConfiguration.Bağlan özelliğini ayarlamaionString veya Application Analizler ServiceOptions.BağlanionString.

Koddaki bağlantı dizesi açıkça ayarlayın:

var configuration = new TelemetryConfiguration
{
    ConnectionString = "InstrumentationKey=00000000-0000-0000-0000-000000000000;IngestionEndpoint=https://{region}.in.applicationinsights.azure.com/;LiveEndpoint=https://{region}.livediagnostics.monitor.azure.com/"
};

Yapılandırma dosyası kullanarak bağlantı dizesi ayarlayın:

<?xml version="1.0" encoding="utf-8"?>
<ApplicationInsights xmlns="http://schemas.microsoft.com/ApplicationInsights/2013/Settings">
    <ConnectionString>InstrumentationKey=00000000-0000-0000-0000-000000000000;IngestionEndpoint=https://{region}.in.applicationinsights.azure.com/;LiveEndpoint=https://{region}.livediagnostics.monitor.azure.com/</ConnectionString>
</ApplicationInsights>

Java

yapılandırma dosyasında bağlantı dizesi applicationinsights.json ayarlayabilirsiniz:

{
  "connectionString": "InstrumentationKey=00000000-0000-0000-0000-000000000000;IngestionEndpoint=https://{region}.in.applicationinsights.azure.com/;LiveEndpoint=https://{region}.livediagnostics.monitor.azure.com/"
}

Daha fazla bilgi için bkz. Bağlan ion dizesi yapılandırması.

JavaScript

JavaScript, ortam değişkenlerinin kullanımını desteklemez. İki seçeneğiniz vardır:

• JavaScript (Web) SDK Yükleyici Betiğini kullanmak için bkz . JavaScript (Web) SDK Yükleyici Betiği.
• El ile kurulum:

  import { ApplicationInsights } from '@microsoft/applicationinsights-web'
  
  const appInsights = new ApplicationInsights({ config: {
     connectionString: 'InstrumentationKey=00000000-0000-0000-0000-000000000000;'
     /* ...Other Configuration Options... */
  } });
  appInsights.loadAppInsights();
  appInsights.trackPageView();
  

Node.js

const appInsights = require("applicationinsights");
appInsights.setup("InstrumentationKey=00000000-0000-0000-0000-000000000000;IngestionEndpoint=https://{region}.in.applicationinsights.azure.com/;LiveEndpoint=https://{region}.livediagnostics.monitor.azure.com/");
appInsights.start();

Python

Kullanıcıların ortam değişkenini ayarlamasını öneririz.

bağlantı dizesi açıkça ayarlamak için:

from opencensus.ext.azure.trace_exporter import AzureExporter
from opencensus.trace.samplers import ProbabilitySampler
from opencensus.trace.tracer import Tracer

tracer = Tracer(exporter=AzureExporter(connection_string='InstrumentationKey=00000000-0000-0000-0000-000000000000;IngestionEndpoint=https://{region}.in.applicationinsights.azure.com/;LiveEndpoint=https://{region}.livediagnostics.monitor.azure.com/'), sampler=ProbabilitySampler(1.0))

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:

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