Migrate from Application Insights instrumentation keys to connection strings

  • Cikk

Ez a cikk végigvezeti a rendszerállapot-kulcsokról a kapcsolati sztring való migrálásra.

Előfeltételek

Áttelepítés

Screenshot that shows Application Insights overview and connection string.

  1. Nyissa meg az alkalmazás Elemzések erőforrás Áttekintés panelét.

  2. Keresse meg a jobb oldalon megjelenő Csatlakozás ion-sztringet.

  3. Vigye az egérmutatót a kapcsolati sztring, és válassza a Vágólapra másolás ikont.

  4. Konfigurálja az alkalmazás Elemzések SDK-t a kapcsolati sztring beállításának követésével.

Fontos

Ne használjon kapcsolati sztring és instrumentációs kulcsot sem. Az utóbbi készlet felülírja a másikat, és azt eredményezheti, hogy a telemetriai adatok nem jelennek meg a portálon. Hiányzó adatok megtekintése.

Nagy léptékű migrálás

Környezeti változókkal kapcsolati sztring továbbíthat az alkalmazásnak Elemzések SDK-nak vagy ügynöknek.

Ha környezeti változón keresztül szeretne beállítani egy kapcsolati sztring, helyezze a kapcsolati sztring értékét egy nevesített APPLICATIONINSIGHTS_CONNECTION_STRINGkörnyezeti változóba.

Ez a folyamat automatizálható az Azure-üzemelő példányokban. Az alábbi Azure Resource Manager-sablon például azt mutatja be, hogyan vehet fel automatikusan a megfelelő kapcsolati sztring egy Azure-alkalmazás-szolgáltatás üzembe helyezésével. Mindenképpen adja meg az alkalmazás által igényelt egyéb alkalmazásbeállításokat:

{
    "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "appServiceName": {
            "type": "string",
            "metadata": {
                "description": "Name of the App Services resource"
            }
        },
        "appServiceLocation": {
            "type": "string",
            "metadata": {
                "description": "Location to deploy the App Services resource"
            }
        },
        "appInsightsName": {
            "type": "string",
            "metadata": {
                "description": "Name of the existing Application Insights resource to use with this App Service. Expected to be in the same Resource Group."
            }
        }
    },
    "resources": [
        {
            "apiVersion": "2016-03-01",
            "name": "[parameters('appServiceName')]",
            "type": "microsoft.web/sites",
            "location": "[parameters('appServiceLocation')]",
            "properties": {
                "siteConfig": {
                    "appSettings": [
                        {
                            "name": "APPLICATIONINSIGHTS_CONNECTION_STRING",
                            "value": "[reference(concat('microsoft.insights/components/', parameters('appInsightsName')), '2015-05-01').ConnectionString]"
                        }
                    ]
                },
                "name": "[parameters('appServiceName')]"
            }
        }
    ]
}

Új képességek

Csatlakozás ion sztringek egyetlen konfigurációs beállítást biztosítanak, és nem igényelnek több proxybeállítást.

  • Megbízhatóság: Csatlakozás ion 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 Csatlakozás ion sztringek lehetővé teszik a hitelesített telemetriai adatok betöltését az Alkalmazás Elemzések Microsoft Entra-hitelesítésével.
  • 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):Csatlakozás ion sztringek megkönnyítik az adatvédelmi aggályokat azáltal, hogy adatokat küldenek a regionális végpontoknak, biztosítva, hogy az adatok ne hagyják el a földrajzi régiót.

Támogatott SDK-verziók

  • .NET és .NET Core v2.12.0+
  • Java v2.5.1 és Java 3.0+
  • JavaScript v2.3.0+
  • NodeJS v1.5.0+
  • Python v1.0.0+

Hibaelhárítás

Ez a szakasz hibaelhárítási megoldásokat tartalmaz.

Riasztás: "Váltás az adatbetöltési kapcsolati sztring használatára"

A riasztás megoldásához kövesse a jelen cikkben ismertetett migrálási lépéseket .

Hiányzó adatok

  • Ellenőrizze, hogy támogatott SDK-verziót használ-e. Ha alkalmazás-Elemzések integrációt használ egy másik Azure-termékajánlatban, tekintse meg a kapcsolati sztring megfelelő konfigurálásával kapcsolatos dokumentációját.
  • Győződjön meg arról, hogy nem egyszerre állít be rendszerállapotkulcsot és kapcsolati sztring. A rendszerállapotkulcs-beállításokat el kell távolítani a konfigurációból.
  • Győződjön meg arról, hogy a kapcsolati sztring pontosan az Azure Portalon megadottak szerint működik.

A környezeti változók nem működnek

Ha az alkalmazáskódban egy rendszerállapotkulcsot keményen kódol, ez a programozás elsőbbséget élvezhet a környezeti változók előtt.

Gyakori kérdések

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

Hol találhatom meg a kapcsolati sztring?

A kapcsolati sztring az alkalmazás Elemzések erőforrás Resource Manager-erőforrástulajdonságai is tartalmazzák a mezőnév ConnectionStringalatt.

Ez hogyan befolyásolja az automatikus beléptetést?

Az autoinstrumentációs forgatókönyvekre nincs hatással.

Használhatom a Microsoft Entra-hitelesítést autoinstrumentációval?

Autoinstrumentációs forgatókönyvekhez nem engedélyezheti a Microsoft Entra-hitelesítést. A jövőben tervezzük kezelni ezt a korlátozást.

Mi a különbség a globális és a regionális betöltés között?

A globális betöltés az összes telemetriai adatot egyetlen végpontra küldi, függetlenül attól, hogy hol tárolják ezeket az adatokat. A regionális betöltéssel régiónként meghatározott végpontokat határozhat meg az adatbetöltéshez. Ez a funkció biztosítja, hogy az adatok egy adott régión belül maradnak a feldolgozás és a tárolás során.

Hogyan befolyásolják a kapcsolati sztring a számlázást?

A számlázásra nincs hatással.

Microsoft Q&A

Kérdéseket tehet fel a válaszok fórumára.