Migrowanie z kluczy instrumentacji usługi Application Insights do parametrów połączenia

W tym artykule opisano migrację z kluczy instrumentacji do parametry połączenia.

Wymagania wstępne

• Obsługiwana wersja zestawu SDK
• Istniejący zasób Szczegółowe informacje aplikacji

Migracja

1. Przejdź do okienka Przegląd zasobu Application Szczegółowe informacje.

2. Znajdź ciąg Połączenie ion wyświetlany po prawej stronie.

3. Umieść kursor na parametry połączenia i wybierz ikonę Kopiuj do schowka.

4. Skonfiguruj zestaw SDK usługi Application Szczegółowe informacje, wykonując czynności opisane w sekcji How to set parametry połączenia s (Jak ustawić zestaw parametry połączenia).

Ważne

Nie używaj zarówno parametry połączenia, jak i klucza instrumentacji. Drugi zestaw zastępuje drugą i może spowodować, że dane telemetryczne nie pojawią się w portalu. Zobacz brakujące dane.

Migracja na dużą skalę

Użyj zmiennych środowiskowych, aby przekazać parametry połączenia do zestawu SDK lub agenta usługi Application Szczegółowe informacje.

Aby ustawić parametry połączenia za pomocą zmiennej środowiskowej, umieść wartość parametry połączenia w zmiennej środowiskowej o nazwie APPLICATIONINSIGHTS_CONNECTION_STRING.

Ten proces można zautomatyzować we wdrożeniach platformy Azure. Na przykład poniższy szablon usługi Azure Resource Manager pokazuje, jak można automatycznie uwzględnić poprawne parametry połączenia z wdrożeniem usługi aplikacja systemu Azure Service. Pamiętaj, aby uwzględnić inne ustawienia aplikacji wymagane przez aplikację:

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

Nowe możliwości

ciągi Połączenie ion zapewniają jedno ustawienie konfiguracji i eliminują potrzebę wielu ustawień serwera proxy.

• Niezawodność: ciągi Połączenie ion sprawiają, że pozyskiwanie danych telemetrycznych jest bardziej niezawodne, usuwając zależności od globalnych punktów końcowych pozyskiwania.
• Zabezpieczenia: ciągi Połączenie ion umożliwiają uwierzytelnione pozyskiwanie danych telemetrycznych przy użyciu uwierzytelniania Microsoft Entra dla usługi Application Szczegółowe informacje.
• Niestandardowe punkty końcowe (suwerenne lub hybrydowe środowiska chmury): ustawienia punktu końcowego umożliwiają wysyłanie danych do określonego regionu usługi Azure Government. (Zobacz przykłady).
• Prywatność (regionalne punkty końcowe): ciągi Połączenie ion ułatwiają problemy z prywatnością, wysyłając dane do regionalnych punktów końcowych, zapewniając, że dane nie opuszczają regionu geograficznego.

Obsługiwane wersje zestawu SDK

• .NET i .NET Core w wersji 2.12.0 lub nowszej
• Java w wersji 2.5.1 i Java 3.0 lub nowszej
• JavaScript w wersji 2.3.0 lub nowszej
• NodeJS w wersji 1.5.0 lub nowszej
• Python w wersji 1.0.0 lub nowszej

Rozwiązywanie problemów

Ta sekcja zawiera rozwiązania do rozwiązywania problemów.

Alert: "Przejście do korzystania z parametry połączenia na potrzeby pozyskiwania danych"

Postępuj zgodnie z instrukcjami migracji w tym artykule, aby rozwiązać ten alert.

Brakujące dane

• Upewnij się, że używasz obsługiwanej wersji zestawu SDK. Jeśli używasz integracji usługi Application Szczegółowe informacje w innej ofercie produktów platformy Azure, zapoznaj się z dokumentacją dotyczącą prawidłowego konfigurowania parametry połączenia.
• Upewnij się, że nie ustawiasz jednocześnie zarówno klucza instrumentacji, jak i parametry połączenia. Ustawienia klucza instrumentacji należy usunąć z konfiguracji.
• Upewnij się, że parametry połączenia jest dokładnie tak jak w witrynie Azure Portal.

Zmienne środowiskowe nie działają

Jeśli kodujesz na stałe klucz instrumentacji w kodzie aplikacji, programowanie może mieć pierwszeństwo przed zmiennymi środowiskowymi.

Często zadawane pytania

Ta sekcja zawiera odpowiedzi na typowe pytania.

Gdzie mogę znaleźć moje parametry połączenia?

Parametry połączenia znajduje się również we właściwościach zasobów usługi Resource Manager dla zasobu application Szczegółowe informacje pod nazwą ConnectionStringpola .

Jak to wpływa na autoinstrumentację?

Nie ma to wpływu na scenariusze automatycznegoinstrumentacji.

Czy mogę używać uwierzytelniania entra firmy Microsoft z autoinstrumentacją?

Nie można włączyć uwierzytelniania entra firmy Microsoft dla scenariuszy autoinstrumentacji . Mamy plany rozwiązania tego ograniczenia w przyszłości.

Jaka jest różnica między pozyskiwaniem globalnym i regionalnym?

Globalne pozyskiwanie wysyła wszystkie dane telemetryczne do pojedynczego punktu końcowego, niezależnie od tego, gdzie te dane będą przechowywane. Pozyskiwanie danych regionalnych umożliwia zdefiniowanie określonych punktów końcowych na region na potrzeby pozyskiwania danych. Ta funkcja zapewnia, że dane pozostają w określonym regionie podczas przetwarzania i przechowywania.

Jak parametry połączenia wpływają na rozliczenia?

Nie ma to wpływu na rozliczenia.

Pytania i odpowiedzi Microsoft

Opublikuj pytania na forum odpowiedzi.