Megosztás a következőn keresztül:

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.

Fontos

A kapcsolati sztring tartalmaz egy eszközkulcsot (ikey) és egy ApplicationId azonosítót.

Az ikey egy egyedi azonosító, amelyet a betöltési szolgáltatás használ a telemetriai adatok adott Application Insights-erőforráshoz való társításához. Az ikey egyedi azonosítók nem biztonsági jogkivonatok vagy biztonsági kulcsok, és nem számítanak titkos kulcsnak. A kapcsolati sztringek az ApplicationId érték hozzáadásával bővülnek. Ez a frissítés egy új funkció, amely támogatja az Open Telemetry SDK-t használó forgatókönyvek automatikus rendszerezését. Ha meg szeretné védeni az Application Insights-erőforrást a visszaéléstől, a betöltési végpont hitelesített telemetriai betöltési lehetőségeket biztosít a Microsoft Entra ID alapján.

Megjegyzé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 karakterláncokra az új képességek kihasználásához.

A kapcsolatkarakterlánc 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 Insights esetében a 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 karakterlánc megkeresése

A kapcsolati sztring az Application Insights erőforrás Áttekintés szakaszában jelenik meg.

Képernyőkép az Application Insights áttekintéséről és a kapcsolati karakterláncról.

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

Tipp

A konfigurálható kulcs-érték párokat ez a dokumentum ismerteti. Egyes kulcs-érték párok nem konfigurálhatók, és automatikusan vannak beállítva, például ApplicationId. Ezek a párok biztonsággal figyelmen kívül hagyhatók, ha megfigyelhetők a környezetében.

Szintaxis

  • InstrumentationKey (például 00000000-0000-0000-0000-000000000000). 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. Bármely szolgáltatás explicit felülírható a kapcsolati karakterláncban.

    • 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 az általános domainnevet.

É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

Kapcsolati sztringek példái

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

Kapcsolati string végpont 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"
  • Instrumentációs kulcs: 00000000-0000-0000-0000-000000000000
  • 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 karakterlánc 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 lánc 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"
  • Instrumentációs kulcs: 00000000-0000-0000-0000-000000000000
  • 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 karakterlánc 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"
  • Instrumentációs kulcs: 00000000-0000-0000-0000-000000000000
  • 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 szolgáltatása és az alábbi SDK-verzióktól kezdődően támogatják a kapcsolati sztringeket.

  • .NET v2.12.0
  • JavaScript v2.3.0
  • NodeJS 1.5.0-s verzió
  • Java v3.1.1

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

Környezeti változó

Kapcsolati string: APPLICATIONINSIGHTS_CONNECTION_STRING

Kódrészletek

Nyelv Klasszikus API OpenTelemetria
ASP.NET Core Application Insights SDK AzMon OTel disztribúció
.NET-keretrendszer Application Insights SDK AzMon-exportőr
Java N/A Java-ügynök
JavaScript JavaScript (webes) SDK betöltési parancsfájl N/A
Node.js Application Insights SDK AzMon OTel disztribúció
Python Az OpenCensus Python SDK megszűnt. AzMon OTel disztribúció

Következő lépések

A gyakori kérdések áttekintése (GYIK):

Indítsa el futásidőben a következőkkel:

Első lépések fejlesztéskor:

  • Last updated on