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

Application Insights se mění z globálních koncových bodů příjmu dat na regionální koncové body, které používají připojovací řetězce, které poskytují další možnosti.

Scénáře nejvíce ovlivněné touto změnou:

Výjimky brány firewall nebo přesměrování proxy – v případech, kdy je vyžadováno monitorování intranetového webového serveru, naše dřívější řešení vyžadovalo přidání jednotlivých koncových bodů služby do konfigurace. Další informace najdete v tématu Můžu monitorovat intranetový webový server? Připojovací řetězce nabízejí lepší alternativu snížením tohoto úsilí na jedno nastavení. Jednoduchá úprava předpony a přípony umožňuje automatické vyplnění a přesměrování všech koncových bodů na správné služby.
Suverénní nebo hybridní cloudová prostředí – Uživatelé můžou odesílat data do definované oblasti Azure Government. Pomocí připojovacích řetězců můžete definovat nastavení koncového bodu pro intranetové servery nebo nastavení hybridního cloudu.

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

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ích řetězců.

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 SDK nebo agentu pro Application Insights.

Chcete-li nastavit připojovací řetězec prostřednictvím proměnné prostředí, umístěte hodnotu připojovacího řetězce 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 Azure App 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')]"
            }
        }
    ]
}

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émů

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

Upozornění: Přechod na používání připojovacích řetězců 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 současně nenastavujete instrumentační klíč i připojovací řetězec. Nastavení instrumentačního klíče by se mělo z konfigurace odebrat.
Ověřte, že je váš připojovací řetězec přesně uvedený 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 připojovací řetězec?

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

Jaký vliv to má na autoinstrumentaci?

Scénáře automatické instrumentace nejsou ovlivněné.

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

Pro scénáře automatického monitorování 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ý vliv mají připojovací řetězce na fakturaci?

Fakturace není ovlivněná.

Microsoft Q&A

Zveřejnit otázky ve fóru odpovědí.

Last updated on 2024-10-10

Sdílet prostřednictvím