Migrera från Application Insights-instrumentationsnycklar till anslutningssträngar

2024-10-10

Application Insights ändras från slutpunkter för global inmatning till regionala slutpunkter som använder anslutningssträngar, vilket ger ytterligare funktioner.

Scenarier som påverkas mest av den här ändringen:

Brandväggsfel eller proxyomdirigeringar – I de fall där övervakning för intranätwebbserver krävs bad vår tidigare lösning dig att lägga till enskilda tjänstslutpunkter i konfigurationen. Mer information finns i Kan jag övervaka en intranätwebbserver?. Anslutningssträngar erbjuder ett bättre alternativ genom att minska ansträngningen till en enda inställning. Ett enkelt prefix, suffixändring, tillåter automatisk population och omdirigering av alla slutpunkter till rätt tjänster.
Nationella miljöer eller hybridmolnmiljöer – Användare kan skicka data till en definierad Azure Government-region. Genom att använda anslutningssträngar kan du definiera slutpunktsinställningar för intranätservrar eller hybridmolninställningar.

Den här artikeln går igenom migrering från instrumentationsnycklar till anslutningssträngar.

Förutsättningar

En SDK-version som stöds
En befintlig Application Insights-resurs

Migration

Gå till Översikt-fönstret 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ängar.

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 även saknade data.

Migrering i stor skala

Använd miljövariabler för att skicka en anslutningssträng till Application Insights SDK eller agent.

Om du vill ange en anslutningssträng via en miljövariabel placerar du värdet för anslutningssträngen 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')]"
            }
        }
    ]
}

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ängar 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 ställer in både en instrumentationsnyckel och en anslutningssträng samtidigt. Inställningar för instrumenteringsnyckeln bör tas bort från konfigurationen.
Bekräfta att anslutningssträngen är exakt som i Azure-portalen.

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

Den här sektionen ger svar på vanliga frågor.

Var annars hittar jag min anslutningssträng?

Anslutningssträngen ingår också i Resource Manager-resursegenskaperna för din Application Insights-resurs under fältnamnet ConnectionString.

Hur påverkar detta autoinstrumentering?

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ängar faktureringen?

Faktureringen påverkas inte.

Microsoft Q&A

Skicka frågor till svarsforumet.

Dela via