Migrera från Application Insights-instrumentationsnycklar till anslutningssträngar
Den här artikeln går igenom migrering från instrumentationsnycklar till anslutningssträng.
Förutsättningar
- En SDK-version som stöds
- En befintlig Application Insights-resurs
Migrering
Gå till fönstret Översikt för din Application Insights-resurs.
Hitta anslutningssträngen som visas till höger.
Hovra över anslutningssträng och välj ikonen Kopiera till Urklipp.
Konfigurera Application Insights SDK genom att följa Så här anger du anslutningssträng s.
Viktigt!
Använd inte både en anslutningssträng och en instrumentationsnyckel. Den senare uppsättningen ersätter den andra och kan leda till att telemetri inte visas på portalen. Se saknade data.
Migrering i stor skala
Använd miljövariabler för att skicka en anslutningssträng till Application Insights SDK eller agenten.
Om du vill ange en anslutningssträng via en miljövariabel placerar du värdet för anslutningssträng i en miljövariabel med namnet APPLICATIONINSIGHTS_CONNECTION_STRING.
Den här processen kan automatiseras i dina Azure-distributioner. Följande Azure Resource Manager-mall visar till exempel hur du automatiskt kan inkludera rätt anslutningssträng med en Azure App Service-distribution. Se till att inkludera andra appinställningar som din app kräver:
{
"$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')]"
}
}
]
}
Nya funktioner
Anslutningssträngar ger en enda konfigurationsinställning och eliminerar behovet av flera proxyinställningar.
- Tillförlitlighet: Anslutningssträngar gör telemetriinmatningen mer tillförlitlig genom att ta bort beroenden på globala inmatningsslutpunkter.
- Säkerhet: Anslutningssträngar tillåter autentiserad telemetriinmatning med hjälp av Microsoft Entra-autentisering för Application Insights.
- Anpassade slutpunkter (nationella miljöer eller hybridmolnmiljöer): Slutpunktsinställningar tillåter att data skickas till en specifik Azure Government-region. (Se exempel.)
- Sekretess (regionala slutpunkter): Anslutningssträngar underlättar sekretessproblem genom att skicka data till regionala slutpunkter, vilket säkerställer att data inte lämnar en geografisk region.
SDK-versioner som stöds
- .NET och .NET Core v2.12.0+
- Java v2.5.1 och Java 3.0+
- JavaScript v2.3.0+
- NodeJS v1.5.0+
- Python v1.0.0+
Felsökning
Det här avsnittet innehåller felsökningslösningar.
Avisering: "Övergå till att använda anslutningssträng för datainmatning"
Följ migreringsstegen i den här artikeln för att lösa den här aviseringen.
Data saknas
- Bekräfta att du använder en SDK-version som stöds. Om du använder Application Insights-integrering i ett annat Azure-produkterbjudande kan du läsa dokumentationen om hur du konfigurerar en anslutningssträng korrekt.
- Bekräfta att du inte anger både en instrumentationsnyckel och anslutningssträng samtidigt. Inställningar för instrumenteringsnyckeln bör tas bort från konfigurationen.
- Bekräfta att din anslutningssträng är exakt som i Azure Portal.
Miljövariabler fungerar inte
Om du hårdkodar en instrumentationsnyckel i programkoden kan programmeringen ha företräde framför miljövariabler.
Vanliga frågor och svar
Det här avsnittet innehåller svar på vanliga frågor.
Var hittar jag annars mina anslutningssträng?
Anslutningssträng ingår också i Resource Manager-resursegenskaperna för din Application Insights-resurs under fältnamnet ConnectionString.
Hur påverkar detta autoinstrumentation?
Scenarier för automatisk instrumentering påverkas inte.
Kan jag använda Microsoft Entra-autentisering med autoinstrumentation?
Du kan inte aktivera Microsoft Entra-autentisering för scenarier med automatisk instrumentering . Vi har planer på att åtgärda den här begränsningen i framtiden.
Vad är skillnaden mellan global och regional inmatning?
Global inmatning skickar alla telemetridata till en enda slutpunkt, oavsett var dessa data lagras. Med regional inmatning kan du definiera specifika slutpunkter per region för datainmatning. Den här funktionen säkerställer att data stannar inom en viss region under bearbetningen och lagringen.
Hur påverkar anslutningssträng faktureringen?
Faktureringen påverkas inte.