Udostępnij za pośrednictwem


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.

Uwaga

Ten temat dotyczy programu Visual Studio w systemie Windows. Aby uzyskać Visual Studio dla komputerów Mac, zobacz Połączone usługi w Visual Studio dla komputerów Mac.

Wymagania wstępne

Nawiązywanie połączenia z usługą aplikacja systemu Azure Insights przy użyciu połączonych usług

  1. Otwórz projekt w programie Visual Studio.

  2. 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ę.

  3. Na karcie Usługi połączone wybierz ikonę + dla pozycji Zależności usług.

    Zrzut ekranu przedstawiający ekran

    Jeśli nie widzisz węzła Usługi połączone, wybierz pozycję Project Connected Services Add (Dodaj połączone usługi>projektu).>

  4. Na stronie Dodawanie zależności wybierz pozycję aplikacja systemu Azure Insights.

    Zrzut ekranu przedstawiający ekran

    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.

  5. 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.

    Zrzut ekranu przedstawiający ekran

  6. Aby utworzyć składnik usługi Application Insights:

    1. Wybierz pozycję Utwórz nowy składnik usługi Application Insights w dolnej części ekranu.

    2. Wypełnij pole Application Insights: Utwórz nowy ekran, a następnie wybierz pozycję Utwórz.

      Zrzut ekranu przedstawiający ekran

    3. 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.

  7. 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.

    Zrzut ekranu przedstawiający ekran

  8. 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.

    Zrzut ekranu przedstawiający ekran

  9. Połączenie jest wyświetlane w sekcji Zależności usług na karcie Połączone usługi .

    Zrzut ekranu przedstawiający ekran

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.

  1. Otwórz projekt w programie Visual Studio.

  2. 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.

    Zrzut ekranu przedstawiający opcje menu kontekstowego usług połączonych.

    Jeśli nie widzisz węzła Usługi połączone, wybierz pozycję Project Connected Services Add (Dodaj połączone usługi>projektu).>

  3. 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ę.

    Zrzut ekranu przedstawiający opcje usługi Application Insights.

    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.

  4. 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.

    Zrzut ekranu przedstawiający ekran

  5. Aby utworzyć składnik usługi Application Insights:

    1. Wybierz pozycję Utwórz nowy składnik usługi Application Insights w dolnej części ekranu.

    2. Wypełnij pole Application Insights: Utwórz nowy ekran, a następnie wybierz pozycję Utwórz.

      Zrzut ekranu przedstawiający ekran

    3. 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.

  6. 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.

    Zrzut ekranu przedstawiający ekran

  7. 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.

    Zrzut ekranu przedstawiający ekran

  8. 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:

    Zrzut ekranu przedstawiający sekcję

    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.

  9. 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.