Migreren van Application Insights-instrumentatiesleutels naar verbindingsreeksen

  • Artikel

In dit artikel wordt uitgelegd hoe u van instrumentatiesleutels naar verbindingsreeks s migreert.

Vereisten

Migratie

Screenshot that shows Application Insights overview and connection string.

  1. Ga naar het deelvenster Overzicht van uw Application Insights-resource.

  2. Zoek de Verbinding maken iontekenreeks aan de rechterkant.

  3. Beweeg de muisaanwijzer over de verbindingsreeks en selecteer het pictogram Kopiëren naar klembord.

  4. Configureer de Application Insights-SDK door verbindingsreeks s in te stellen.

Belangrijk

Gebruik niet zowel een verbindingsreeks als een instrumentatiesleutel. De laatste set vervangt de andere set en kan ertoe leiden dat telemetrie niet wordt weergegeven in de portal. Ontbrekende gegevens zien.

Migratie op schaal

Gebruik omgevingsvariabelen om een verbindingsreeks door te geven aan de Application Insights-SDK of -agent.

Als u een verbindingsreeks wilt instellen via een omgevingsvariabele, plaatst u de waarde van de verbindingsreeks in een omgevingsvariabele met de naam APPLICATIONINSIGHTS_CONNECTION_STRING.

Dit proces kan worden geautomatiseerd in uw Azure-implementaties. In de volgende Azure Resource Manager-sjabloon ziet u bijvoorbeeld hoe u automatisch de juiste verbindingsreeks kunt opnemen met een Azure-app Service-implementatie. Zorg ervoor dat u andere app-instellingen opneemt die uw app nodig heeft:

{
    "$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')]"
            }
        }
    ]
}

Nieuwe mogelijkheden

Verbinding maken iontekenreeksen bieden één configuratie-instelling en elimineren de noodzaak van meerdere proxyinstellingen.

  • Betrouwbaarheid: Verbinding maken iontekenreeksen maken telemetrieopname betrouwbaarder door afhankelijkheden van globale opname-eindpunten te verwijderen.
  • Beveiliging: Verbinding maken iontekenreeksen staan geverifieerde telemetrieopname toe met behulp van Microsoft Entra-verificatie voor Application Insights.
  • Aangepaste eindpunten (onafhankelijke of hybride cloudomgevingen): met eindpuntinstellingen kunnen gegevens worden verzonden naar een specifieke Azure Government-regio. (Zie voorbeelden.)
  • Privacy (regionale eindpunten): Verbinding maken tekenreeksen vereenvoudigen privacyproblemen door gegevens naar regionale eindpunten te verzenden, zodat gegevens geen geografische regio verlaten.

Ondersteunde SDK-versies

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

Problemen oplossen

Deze sectie bevat oplossingen voor probleemoplossing.

Waarschuwing: 'Overstappen op het gebruik van verbindingsreeks s voor gegevensopname'

Volg de migratiestappen in dit artikel om deze waarschuwing op te lossen.

Ontbrekende gegevens

  • Controleer of u een ondersteunde SDK-versie gebruikt. Als u Application Insights-integratie in een ander Azure-productaanbod gebruikt, raadpleegt u de documentatie over het correct configureren van een verbindingsreeks.
  • Controleer of u niet tegelijkertijd een instrumentatiesleutel en verbindingsreeks instelt. Instrumentatiesleutelinstellingen moeten worden verwijderd uit uw configuratie.
  • Controleer of uw verbindingsreeks precies is zoals opgegeven in Azure Portal.

Omgevingsvariabelen werken niet

Als u een instrumentatiesleutel in uw toepassingscode hardcodeert, heeft dat programmeren mogelijk voorrang vóór omgevingsvariabelen.

Veelgestelde vragen

In deze sectie vindt u antwoorden op veelgestelde vragen.

Waar vind ik mijn verbindingsreeks?

De verbindingsreeks is ook opgenomen in de resource-eigenschappen van Resource Manager voor uw Application Insights-resource, onder de veldnaamConnectionString.

Hoe is dit van invloed op auto-instrumentatie?

Scenario's voor auto-instrumentatie worden niet beïnvloed.

Kan ik Microsoft Entra-verificatie gebruiken met automatische instrumentatie?

U kunt Microsoft Entra-verificatie niet inschakelen voor auto-instrumentatiescenario's. We zijn van plan om deze beperking in de toekomst aan te pakken.

Wat is het verschil tussen wereldwijde en regionale opname?

Globale opname verzendt alle telemetriegegevens naar één eindpunt, ongeacht waar deze gegevens worden opgeslagen. Met regionale opname kunt u specifieke eindpunten per regio definiëren voor gegevensopname. Deze mogelijkheid zorgt ervoor dat gegevens binnen een specifieke regio blijven tijdens de verwerking en opslag.

Hoe beïnvloeden verbindingsreeks s de facturering?

Facturering wordt niet beïnvloed.

Microsoft Q&A

Stel vragen op het antwoordenforum.