Migrace z instrumentačních klíčů Application Insights na připojovací řetězce

Článek
11/05/2024

Tento článek vás provede migrací z instrumentačních klíčů na připojovací řetězec.

Požadavky

Podporovaná verze sady SDK
Existující prostředek Application Insights

Migrace

Přejděte do podokna Přehled prostředku Application Insights.
Najděte připojovací řetězec zobrazený vpravo.
Najeďte myší na připojovací řetězec a vyberte ikonu Kopírovat do schránky.
Nakonfigurujte sadu Application Insights SDK podle postupu nastavení připojovací řetězec.

Důležité

Nepoužívejte připojovací řetězec ani instrumentační klíč. Druhá sada nahrazuje druhou a může vést k tomu, že se na portálu nezobrazuje telemetrie. Zobrazení chybějících dat

Migrace ve velkém měřítku

Pomocí proměnných prostředí předejte připojovací řetězec sadě Application Insights SDK nebo agentu.

Pokud chcete nastavit připojovací řetězec prostřednictvím proměnné prostředí, umístěte hodnotu připojovací řetězec do proměnné prostředí s názvem APPLICATIONINSIGHTS_CONNECTION_STRING.

Tento proces je možné automatizovat ve vašich nasazeních Azure. Například následující šablona Azure Resource Manageru ukazuje, jak můžete automaticky zahrnout správné připojovací řetězec s nasazením služby Aplikace Azure Service. Nezapomeňte zahrnout všechna další nastavení aplikace, která vaše aplikace vyžaduje:

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

Nové možnosti

Připojovací řetězce poskytují jedno nastavení konfigurace a eliminují potřebu více nastavení proxy serveru.

Spolehlivost: Připojovací řetězce usnadňují příjem telemetrie odebráním závislostí na globálních koncových bodech příjmu dat.
Zabezpečení: Připojovací řetězce umožňují ingestování ověřené telemetrie pomocí ověřování Microsoft Entra pro Application Insights.
Přizpůsobené koncové body (suverénní nebo hybridní cloudová prostředí):: Nastavení koncového bodu umožňují odesílat data do konkrétní oblasti Azure Government. (Viz příklady.)
Ochrana osobních údajů (regionální koncové body):: Připojovací řetězce usnadňují ochranu osobních údajů odesláním dat do regionálních koncových bodů a zajištěním, že data neopustí geografickou oblast.

Podporované verze sady SDK

.NET a .NET Core verze 2.12.0+
Java verze 2.5.1 a Java 3.0 nebo novější
JavaScript verze 2.3.0 nebo novější
NodeJS v1.5.0+
Python v1.0.0+

Řešení problému

Tato část obsahuje řešení potíží.

Upozornění: Přechod na používání připojovací řetězec pro příjem dat

Pokud chcete tuto výstrahu vyřešit, postupujte podle kroků migrace v tomto článku.

Chybějící data

Ověřte, že používáte podporovanou verzi sady SDK. Pokud používáte integraci Application Insights v jiné nabídce produktů Azure, projděte si její dokumentaci, jak správně nakonfigurovat připojovací řetězec.
Ověřte, že nenastavujete instrumentační klíč i připojovací řetězec současně. Nastavení instrumentačního klíče by se mělo z konfigurace odebrat.
Ověřte, že je připojovací řetězec přesně tak, jak je uvedeno na webu Azure Portal.

Proměnné prostředí nefungují

Pokud v kódu aplikace pevně zakódujete instrumentační klíč, může mít toto programování přednost před proměnnými prostředí.

Nejčastější dotazy

Tato část obsahuje odpovědi na běžné otázky.

Kde jinde najdu svůj připojovací řetězec?

Připojovací řetězec je také součástí vlastností prostředku Resource Manageru pro prostředek Application Insights pod názvem ConnectionStringpole .

Jaký vliv to má na automatické vytváření?

Scénáře automatického zápisu nejsou ovlivněné.

Můžu použít ověřování Microsoft Entra s automatickou opravou?

Pro scénáře automatického vytváření nemůžete povolit ověřování Microsoft Entra. V budoucnu máme v plánu toto omezení vyřešit.

Jaký je rozdíl mezi globálním a regionálním příjmem dat?

Globální příjem dat odesílá všechna telemetrická data do jednoho koncového bodu bez ohledu na to, kde se budou tato data ukládat. Regionální příjem dat umožňuje definovat konkrétní koncové body pro ingestování dat v jednotlivých oblastech. Tato funkce zajišťuje, že data zůstanou během zpracování a úložiště v určité oblasti.

Jak připojovací řetězec ovlivňují fakturaci?

Fakturace není ovlivněná.

Microsoft Q&A

Zveřet otázky na fóru pro odpovědi.

Sdílet prostřednictvím