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).InstrumentationKey
kö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
- Lenyelés:
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/
- Lenyelés:
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/
- Lenyelés:
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
Á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/" } }
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);
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: