Kapcsolati sztringek

Ez a cikk bemutatja a kapcsolati sztring használatát.

Áttekintés

Feljegyzés

Az alábbi dokumentáció az Alkalmazás Elemzések klasszikus API-ra támaszkodik. Az Alkalmazás Elemzések hosszú távú terve az Adatok gyűjtése Az OpenTelemetria használatával. További információ: Az Azure Monitor OpenTelemetria engedélyezése .NET-, Node.js-, Python- és Java-alkalmazásokhoz.

Csatlakozás ion sztringek határozzák meg a telemetriai adatok küldésének helyét.

A kulcs-érték párok egyszerű módot biztosítanak a felhasználók számára az előtag utótag-kombinációinak meghatározására minden alkalmazáshoz Elemzések szolgáltatáshoz vagy termékhez.

Feljegyzés

2025. március 31-én megszűnik az eszközkulcsalapú betöltés támogatása. A rendszerállapot-kulcsok betöltése továbbra is működni fog, de a továbbiakban nem biztosítunk frissítéseket vagy támogatást a funkcióhoz. Váltás kapcsolati sztring az új képességek kihasználásához.

Forgatókönyv áttekintése

A változás által leginkább érintett forgatókönyvek:

• Tűzfal-kivételek vagy proxyátirányítások:

  Azokban az esetekben, amikor az intranetes webkiszolgáló monitorozására van szükség, korábbi megoldásunk arra kérte, hogy adjon hozzá egyéni szolgáltatásvégpontokat a konfigurációhoz. További információt az intranetes webkiszolgálók figyelése című témakörben talál. Csatlakozás ion-sztringek jobb alternatívát kínálnak azáltal, hogy ezt az erőfeszítést egyetlen beállításra csökkentik. Egy egyszerű előtag, az utótag módosítása lehetővé teszi az automatikus sokaságot, és az összes végpontot a megfelelő szolgáltatásokra irányítja át.

• Szuverén vagy hibrid felhőkörnyezetek:

  A felhasználók adatokat küldhetnek egy meghatározott Azure Government-régióba. A kapcsolati sztring használatával végpontbeállításokat határozhat meg az intranetes kiszolgálókhoz vagy a hibrid felhőbeállításokhoz.

Első lépések

Első lépésként tekintse át a következő szakaszokat.

A kapcsolati sztring megkeresése

A kapcsolati sztring az Alkalmazás Elemzések erőforrás Áttekintés szakaszában jelenik meg.

Séma

A sémaelemeket a következő szakaszok ismertetik.

Maximális hossz

A kapcsolat legfeljebb 4096 karakter hosszúságú lehet.

Kulcs-érték párok

A kapcsolati sztring a kulcs-érték párként képviselt beállítások listáját tartalmazza pontosvesszővel elválasztva:key1=value1;key2=value2;key3=value3

Syntax

• InstrumentationKey (például 000000000-0000-0000-0000-000000000). InstrumentationKeykötelező mező.
• Authorization (például ikey). Ez a beállítás nem kötelező, mert jelenleg csak az ikey-engedélyezést támogatjuk.
• EndpointSuffix (például applicationinsights.azure.cn). A végpont utótagjának beállítása azt jelzi, hogy az SDK melyik Azure-felhőhöz csatlakozik. Az SDK összeállítja a végpont többi részét az egyes szolgáltatásokhoz.
• Explicit végpontok. A kapcsolati sztring bármely szolgáltatását explicit módon felül lehet bírálni:
  • IngestionEndpoint (például: https://dc.applicationinsights.azure.com)
  • LiveEndpoint (például: https://live.applicationinsights.azure.com)
  • ProfilerEndpoint (például: https://profiler.monitor.azure.com)
  • SnapshotEndpoint (például: https://snapshot.monitor.azure.com)

Végpontséma

<prefix>.<suffix>

• Előtag: Szolgáltatás definiálása.
• Utótag: Meghatározza a közös tartománynevet.

Érvényes utótagok

• applicationinsights.azure.cn
• applicationinsights.us

További információ: Végpontmódosítást igénylő régiók.

Érvényes előtagok

• Telemetriai betöltési adatok: dc
• Élő metrikák: live
• Profilkészítő: profiler
• Pillanatkép: snapshot

A kapcsolati sztring titok?

A kapcsolati sztring egy ikey-t tartalmaz, amely egy egyedi azonosító, amelyet a betöltési szolgáltatás használ a telemetriai adatok adott alkalmazáshoz Elemzések erőforráshoz való társításához. Ezek az egyedi ikey-azonosítók nem biztonsági jogkivonatok vagy biztonsági kulcsok. Ha meg szeretné védeni az AI-erőforrást a visszaélésektől, a betöltési végpont hitelesített telemetriai betöltési lehetőségeket biztosít a Microsoft Entra ID alapján.

Feljegyzés

Az alkalmazás Elemzések JavaScript SDK megköveteli a kapcsolati sztring inicializálás és konfigurálás során. Egyszerű szövegként tekinthető meg az ügyfélböngészőkben. A Microsoft Entra ID-alapú hitelesítés nem használható könnyen a böngésző telemetriai adataihoz. Javasoljuk, hogy a szolgáltatás telemetriájának biztonságossá tételéhez fontolja meg egy külön alkalmazás-Elemzések erőforrás létrehozását a böngésző telemetriai adataihoz.

példák Csatlakozás ion sztringre

Íme néhány példa a kapcsolati sztring.

Csatlakozás ion sztring végponti utótaggal

InstrumentationKey=00000000-0000-0000-0000-000000000000;EndpointSuffix=ai.contoso.com;

Ebben a példában a kapcsolati sztring adja meg a végpont utótagját, az SDK pedig szolgáltatásvégpontokat hoz létre:

• Az engedélyezési séma alapértelmezés szerint "ikey"
• Rendszerállapot-kulcs: 000000000-0000-0000-0000-000000000
• A regionális szolgáltatás URI-jai a megadott végpont-utótagon alapulnak:
  • Lenyelés: https://dc.ai.contoso.com
  • Élő metrikák: https://live.ai.contoso.com
  • Profiler: https://profiler.ai.contoso.com
  • Hibakereső: https://snapshot.ai.contoso.com

Csatlakozás ion-sztring explicit végpont-felülbírálásokkal

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/;

Ebben a példában a kapcsolati sztring minden szolgáltatáshoz explicit felülbírálásokat határoz meg. Az SDK a módosítás nélkül megadott pontos végpontokat használja:

• Az engedélyezési séma alapértelmezés szerint "ikey"
• Rendszerállapot-kulcs: 000000000-0000-0000-0000-000000000
• A regionális szolgáltatás URI-k a explicit felülbírálási értékeken alapulnak:
  • Lenyelés: https://custom.com:111/
  • Élő metrikák: https://custom.com:222/
  • Profiler: https://custom.com:333/
  • Hibakereső: https://custom.com:444/

Csatlakozás ion sztring explicit régióval

InstrumentationKey=00000000-0000-0000-0000-000000000000;IngestionEndpoint=https://southcentralus.in.applicationinsights.azure.com/

Ebben a példában a kapcsolati sztring az USA déli középső régióját adja meg:

• Az engedélyezési séma alapértelmezés szerint "ikey"
• Rendszerállapot-kulcs: 000000000-0000-0000-0000-000000000
• A regionális szolgáltatás URI-k a explicit felülbírálási értékeken alapulnak:
  • Lenyelés: https://southcentralus.in.applicationinsights.azure.com/

Futtassa a következő parancsot az Azure CLI-ben az elérhető régiók listázásához:

az account list-locations -o table

Kapcsolati sztring beállítása

Csatlakozás ion sztringek a következő SDK-verziókban támogatottak:

• .NET v2.12.0
• Java v2.5.1 és Java 3.0
• JavaScript v2.3.0
• NodeJS 1.5.0-s verzió
• Python 1.0.0-s verzió

Beállíthat egy kapcsolati sztring kódban, vagy környezeti változó vagy konfigurációs fájl használatával.

Környezeti változó

Csatlakozás ion sztring:APPLICATIONINSIGHTS_CONNECTION_STRING

Kódminták

.NET 5.0+

1. Állítsa be a kapcsolati sztring a appsettings.json fájlban:

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

2. A szolgáltatás regisztrálásakor ApplicationInsightsTelemetry kérje le a kapcsolati sztringProgram.cs:

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

.NET-keretrendszer

A TelemetryConfiguration.Csatlakozás tulajdonság beállításaionString vagy Application Elemzések ServiceOptions.CsatlakozásionString.

Explicit módon állítsa be a kapcsolati sztring a kódban:

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/"
};

Állítsa be a kapcsolati sztring egy konfigurációs fájl használatával:

<?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

A kapcsolati sztring a applicationinsights.json konfigurációs fájlban állíthatja be:

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

További információ: Csatlakozás ion sztringkonfiguráció.

JavaScript

A JavaScript nem támogatja a környezeti változók használatát. Két lehetőség áll rendelkezésre:

• A JavaScript (webes) SDK loader szkript használatához lásd : JavaScript (Web) SDK Loader Script.
• Manuális beállítás:

  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

Javasoljuk, hogy a felhasználók állítsa be a környezeti változót.

A kapcsolati sztring explicit beállítása:

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

Gyakori kérdések

Ez a szakasz választ ad a gyakori kérdésekre.

Az új Azure-régiók megkövetelik a kapcsolati sztring használatát?

Az új Azure-régiókhoz a rendszerállapotkulcsok helyett kapcsolati sztring kell használni. Csatlakozás ion sztring azonosítja a telemetriai adatokhoz társítani kívánt erőforrást. Azt is lehetővé teszi, hogy módosítsa azokat a végpontokat, amelyet az erőforrás a telemetria célhelyeként használ. Másolja ki a kapcsolati sztring, és adja hozzá az alkalmazás kódjához vagy egy környezeti változóhoz.

Használjon kapcsolati sztring vagy rendszerállapot-kulcsokat?

Javasoljuk, hogy a rendszerállapot-kulcsok helyett kapcsolati sztring használjon.

Következő lépések

Első lépések futtatáskor:

• Azure-beli virtuális gép és Azure Virtual Machine Scale Sets IIS által üzemeltetett alkalmazások
• IIS-kiszolgáló
• A Azure-alkalmazás Service Web Apps szolgáltatása

Első lépések fejlesztéskor:

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