Migreren van Application Insights-instrumentatiesleutels naar verbindingsreeksen

Application Insights verandert van globale opname-eindpunten in regionale eindpunten die gebruikmaken van verbindingsreeksen, die extra mogelijkheden bieden.

Scenario's die het meest worden beïnvloed door deze wijziging:

• Firewall-uitzonderingen of proxyomleidingen : in gevallen waarin bewaking voor intranetwebserver vereist is, heeft onze eerdere oplossing u gevraagd om afzonderlijke service-eindpunten toe te voegen aan uw configuratie. Zie de pagina Kan ik een intranetwebserver bewaken voor meer informatie. Verbindingsreeksen bieden een beter alternatief door deze inspanning tot één instelling te verminderen. Een eenvoudig voorvoegsel, achtervoegselwijziging, maakt automatische populatie en omleiding van alle eindpunten naar de juiste services mogelijk.

• Onafhankelijke of hybride cloudomgevingen : gebruikers kunnen gegevens verzenden naar een gedefinieerde Azure Government-regio. Met behulp van verbindingsreeksen kunt u eindpuntinstellingen definiëren voor uw intranetservers of hybride cloudinstellingen.

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

Vereiste voorwaarden

Migratie

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

2. Zoek de verbindingsreeks die aan de rechterkant wordt weergegeven.

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

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

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

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+

Probleemoplossingsproces

Deze sectie bevat oplossingen voor probleemoplossing.

Waarschuwing: 'Overgang naar het gebruik van verbindingsreeksen 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 kan ik anders mijn verbindingsreeks vinden?

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

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 zijn verbindingsreeksen van invloed op de facturering?

Facturering wordt niet beïnvloed.

Microsoft Q&A

Stel vragen op het antwoordenforum.