Kapcsolati sztringek az Application Insightsban

A kapcsolati sztringek határozzák meg, hogy a rendszerezett alkalmazás melyik Application Insights-erőforrásnak küldjön telemetriai adatokat. A kapcsolati sztring több beállításból áll, mindegyik kulcs-érték párként jelenik meg, pontosvesszővel elválasztva. Ez az összevont konfigurációs módszer leegyszerűsíti a beállítási folyamatot azáltal, hogy nincs szükség több proxybeállításra.

Kapcsolati sztring képességei

• Megbízhatóság: A kapcsolati sztringek megbízhatóbbá teszik a telemetriai betöltést a globális betöltési végpontok függőségeinek eltávolításával.
• Biztonság: A kapcsolati sztringek lehetővé teszik a hitelesített telemetriai betöltést az Application InsightsHoz készült Microsoft Entra-hitelesítéssel.
• Testreszabott végpontok (szuverén vagy hibrid felhőkörnyezetek):: A végpontbeállítások lehetővé teszik az adatok küldését egy adott Azure Government-régióba. (Lásd a példákat.)
• Adatvédelem (regionális végpontok): A kapcsolati sztringek megkönnyítik az adatvédelmi problémákat azáltal, hogy adatokat küldenek a regionális végpontokra, biztosítva, hogy az adatok ne hagyják el a földrajzi régiót.

A kapcsolati sztring megkeresése

A kapcsolati sztring az Application Insights-erőforrás Áttekintés szakaszában jelennek 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
• Profiler a .NET-hez: profiler
• Pillanatkép: snapshot

Példa kapcsolati sztringre

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

Kapcsolati 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 egységes erőforrás-azonosítói (URI-k) a megadott végpont-utótagon alapulnak:
  • Lenyelés: https://dc.ai.contoso.com
  • Élő metrikák: https://live.ai.contoso.com
  • Profiler a .NET-hez: https://profiler.ai.contoso.com
  • Hibakereső: https://snapshot.ai.contoso.com

Kapcsolati 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 a .NET-hez: https://custom.com:333/
  • Hibakereső: https://custom.com:444/

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

Az elérhető régiók listájához futtassa a következő parancsot az Azure CLI-ben:

az account list-locations -o table

Kapcsolati sztring beállítása

Az OpenTelemetry összes ajánlata és az alábbi SDK-verziók támogatják a kapcsolati sztring:

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

A kapcsolati sztring egy környezeti változó vagy egy konfigurációs fájl használatával állíthatja be a kódban.

Környezeti változó

Kapcsolati sztring: APPLICATIONINSIGHTS_CONNECTION_STRING

Kódminták

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. A kapcsolati 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 Virtual Machine (VM) és Azure Virtual Machine Scale Sets IIS által üzemeltetett alkalmazások
• Internet Information Server (IIS) kiszolgáló
• A Azure-alkalmazás Service Web Apps szolgáltatása

Első lépések fejlesztéskor:

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