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 usługi Application Insights
Migracja
Przejdź do okienka Przegląd zasobu usługi Application Insights.
Znajdź parametry połączenia wyświetlane po prawej stronie.
Umieść kursor na parametry połączenia i wybierz ikonę Kopiuj do schowka.
Skonfiguruj zestaw SDK usługi Application Insights, wykonując czynności opisane w sekcji Jak ustawić 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 Insights.
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
Parametry połączenia zapewniają jedno ustawienie konfiguracji i eliminują potrzebę wielu ustawień serwera proxy.
- Niezawodność: Parametry połączenia sprawiają, że pozyskiwanie danych telemetrycznych jest bardziej niezawodne, usuwając zależności od globalnych punktów końcowych pozyskiwania.
- Zabezpieczenia: Parametry połączenia umożliwiają uwierzytelnione pozyskiwanie danych telemetrycznych przy użyciu uwierzytelniania firmy Microsoft Entra dla usługi Application Insights.
- 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): Parametry połączenia 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 Insights z inną ofertą 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 usługi Application Insights 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.
Microsoft Q&A
Opublikuj pytania na forum odpowiedzi.