Dodawanie usługi aplikacja systemu Azure Insights przy użyciu usług połączonych programu Visual Studio
Za pomocą programu Visual Studio można połączyć dowolną z następujących funkcji, aby aplikacja systemu Azure Insights, korzystając z funkcji Połączonych usług:
- Aplikacja konsolowa .NET Framework
- ASP.NET Model-View-Controller (MVC) (.NET Framework)
- ASP.NET Core
- .NET Core (w tym aplikacja konsolowa, WPF, Windows Forms, biblioteka klas)
- Rola procesu roboczego platformy .NET Core
- Azure Functions
- aplikacja platforma uniwersalna systemu Windows
- Xamarin
- Cordova
Funkcja połączonej usługi dodaje wszystkie wymagane odwołania i kod połączenia do projektu oraz odpowiednio modyfikuje pliki konfiguracji.
Wymagania wstępne
- Program Visual Studio z zainstalowanym obciążeniem platformy Azure.
- Projekt jednego z obsługiwanych typów
- Konto Azure. Jeśli nie masz konta platformy Azure, aktywuj korzyści platformy Azure dla subskrybentów programu Visual Studio lub zarejestruj się w celu uzyskania bezpłatnej wersji próbnej.
Nawiązywanie połączenia z usługą aplikacja systemu Azure Insights przy użyciu połączonych usług
Otwórz projekt w programie Visual Studio.
W Eksplorator rozwiązań kliknij prawym przyciskiem myszy węzeł Usługi połączone, a następnie z menu kontekstowego wybierz polecenie Dodaj połączoną usługę.
Na karcie Usługi połączone wybierz ikonę + dla pozycji Zależności usług.
Jeśli nie widzisz węzła Usługi połączone, wybierz pozycję Project Connected Services Add (Dodaj połączone usługi>projektu).>
Na stronie Dodawanie zależności wybierz pozycję aplikacja systemu Azure Insights.
Jeśli jeszcze nie zalogowałeś się, zaloguj się do swojego konta platformy Azure. Jeśli nie masz konta platformy Azure, możesz skorzystać z bezpłatnej wersji próbnej.
Na ekranie Konfigurowanie aplikacja systemu Azure Insights wybierz istniejący składnik aplikacja systemu Azure Insights, a następnie wybierz pozycję Dalej.
Jeśli musisz utworzyć nowy składnik, przejdź do następnego kroku. W przeciwnym razie przejdź do kroku 7.
Aby utworzyć składnik usługi Application Insights:
Wybierz pozycję Utwórz nowy składnik usługi Application Insights w dolnej części ekranu.
Wypełnij pole Application Insights: Utwórz nowy ekran, a następnie wybierz pozycję Utwórz.
Po wyświetleniu ekranu Configure aplikacja systemu Azure Insights (Konfigurowanie usługi aplikacja systemu Azure Insights) nowy składnik zostanie wyświetlony na liście. Wybierz nowy składnik z listy, a następnie wybierz pozycję Dalej.
Wprowadź nazwę klucza instrumentacji lub wybierz wartość domyślną, a następnie wybierz, czy chcesz, aby parametry połączenia przechowywany w lokalnym pliku wpisów tajnych, czy w usłudze Azure Key Vault.
Na ekranie Podsumowanie zmian zostaną wyświetlone wszystkie modyfikacje wprowadzone w projekcie w przypadku ukończenia procesu. Jeśli zmiany wyglądają ok, wybierz przycisk Zakończ.
Połączenie jest wyświetlane w sekcji Zależności usług na karcie Połączone usługi .
Nawiązywanie połączenia z usługą aplikacja systemu Azure Insights przy użyciu połączonych usług
Uwaga
W przypadku projektów .NET Framework interfejs użytkownika połączonych usług jest nieco inny. Aby zobaczyć różnice, porównaj z wersją programu Visual Studio 2019 tej strony.
Otwórz projekt w programie Visual Studio.
W Eksplorator rozwiązań kliknij prawym przyciskiem myszy węzeł Usługi połączone, a następnie z menu kontekstowego wybierz polecenie Dodaj, aby otworzyć menu dostępnych usług.
Jeśli nie widzisz węzła Usługi połączone, wybierz pozycję Project Connected Services Add (Dodaj połączone usługi>projektu).>
Wybierz pozycję aplikacja systemu Azure Insights. Zostanie wyświetlona strona Łączenie z zależnością . Powinny zostać wyświetlone dwie opcje: jedna dla lokalnego emulatora, zestawu SDK usługi Application Insights (lokalnego) i jednej na potrzeby nawiązywania połączenia z usługą live aplikacja systemu Azure Insights. Możesz obniżyć koszty i uprościć wczesne programowanie, zaczynając od lokalnego emulatora. Możesz przeprowadzić migrację do usługi na żywo później, powtarzając te kroki i wybierając drugą opcję.
Jeśli zdecydujesz się używać zestawu SDK usługi Application Insights lokalnie, kliknij przycisk Dalej , aby wyświetlić ekran Podsumowanie zmian , który pokazuje sposób modyfikacji projektu. Odwołanie do pakietu NuGet jest dodawane do projektu, a kod połączenia dla lokalnego emulatora zostanie dodany do projektu.
Jeśli chcesz nawiązać połączenie z usługą platformy Azure, przejdź do następnego kroku lub jeśli jeszcze nie zalogowałeś się, zaloguj się do swojego konta platformy Azure przed kontynuowaniem. Jeśli nie masz konta platformy Azure, możesz skorzystać z bezpłatnej wersji próbnej.
Na ekranie Konfigurowanie aplikacja systemu Azure Insights wybierz istniejący składnik aplikacja systemu Azure Insights, a następnie wybierz pozycję Dalej.
Jeśli musisz utworzyć nowy składnik, przejdź do następnego kroku. W przeciwnym razie przejdź do kroku 7.
Aby utworzyć składnik usługi Application Insights:
Wybierz pozycję Utwórz nowy składnik usługi Application Insights w dolnej części ekranu.
Wypełnij pole Application Insights: Utwórz nowy ekran, a następnie wybierz pozycję Utwórz.
Po wyświetleniu ekranu Configure aplikacja systemu Azure Insights (Konfigurowanie usługi aplikacja systemu Azure Insights) nowy składnik zostanie wyświetlony na liście. Wybierz nowy składnik z listy, a następnie wybierz pozycję Dalej.
Wprowadź nazwę ustawienia połączenia i nazwę klucza instrumentacji lub zaakceptuj wartości domyślne.
Uwaga
Aby zwiększyć bezpieczeństwo, w programie Visual Studio 17.12 lub nowszym ten krok tworzy nazwę ustawienia połączenia; poprzednie wersje tworzą parametry połączenia. Parametry połączenia przechowywane w lokalnym systemie plików mogą prowadzić do zagrożenia bezpieczeństwa, jeśli są przypadkowo uwidocznione.
Kliknij pozycję Dodatkowe ustawienia i wybierz, czy parametry połączenia przechowywany w lokalnym pliku wpisów tajnych, czy w usłudze Azure Key Vault.
Na ekranie Podsumowanie zmian zostaną wyświetlone wszystkie modyfikacje wprowadzone w projekcie w przypadku ukończenia procesu. Jeśli zmiany wyglądają ok, wybierz przycisk Zakończ.
W Eksplorator rozwiązań kliknij dwukrotnie węzeł Usługi połączone, aby otworzyć kartę Usługi połączone. Połączenie zostanie wyświetlone w sekcji Zależności usługi:
Jeśli klikniesz trzy kropki obok dodanej zależności, zobaczysz różne opcje, takie jak Połącz , aby ponownie otworzyć kreatora i zmienić połączenie. Możesz również kliknąć trzy kropki w prawym górnym rogu okna, aby wyświetlić opcje uruchamiania zależności lokalnych, zmiany ustawień i nie tylko.
Otwórz plik kodu uruchamiania (Program.cs w szablonach) i zwróć uwagę, że dodano wiersz podobny do następującego:
builder.Services.AddApplicationInsightsTelemetry(builder.Configuration["APPLICATIONINSIGHTS_CONNECTION_STRING"]);
Następne kroki
W przypadku projektów ASP.NET Core dowiedz się, jak włączyć monitorowanie aplikacji w usłudze Application Insights dla aplikacji ASP.NET Core.
Aby zapoznać się z projektami ASP.NET, zobacz Konfigurowanie usługi Application Insights dla witryny internetowej ASP.NET.
Linki prowadzą do sekcji artykułów po początkowych krokach konfiguracji, które zostały już wykonane.