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

  • Článek

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

Požadavky

Migrace

Screenshot that shows Application Insights overview and connection string.

  1. Přejděte do podokna Přehled prostředku Přehledy aplikace.

  2. Najděte řetězec Připojení ionu zobrazený na pravé straně.

  3. Najeďte myší na připojovací řetězec a vyberte ikonu Kopírovat do schránky.

  4. Nakonfigurujte sadu Application Přehledy 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 do sady Application Přehledy SDK nebo agenta.

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řipojení ionové řetězce poskytují jedno nastavení konfigurace a eliminují potřebu více nastavení proxy serveru.

  • Spolehlivost: řetězce Připojení ion usnadňují příjem telemetrie odebráním závislostí na globálních koncových bodech příjmu dat.
  • Zabezpečení: řetězce Připojení umožňují ingestování ověřené telemetrie pomocí ověřování Microsoft Entra pro službu Application Přehledy.
  • 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řipojení ionové řetězce usnadňují obavy ohledně ochrany osobních údajů tím, že odesílají data do regionálních koncových bodů a zajišťují, ž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 služby Application Přehledy 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?

Tato připojovací řetězec je také zahrnuta ve vlastnostech prostředku Resource Manageru pro prostředek Přehledy aplikace 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 – otázky&odpovědi

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