Debugowanie opublikowanej usługi w chmurze platformy Azure za pomocą programu Visual Studio i funkcji IntelliTrace

Uwaga

Ten artykuł dotyczy usług Azure Cloud Services (wersja klasyczna), która jest obecnie przestarzała dla nowych klientów i zostanie wycofana 31 sierpnia 2024 r. Istniejące usługi utworzone za pomocą tej technologii są nadal obsługiwane za pośrednictwem usług Azure Cloud Services (wsparcie dodatkowe). W przypadku nowego programowania zalecamy użycie nowszego typu usługi przeznaczonego do określonego celu, takiego jak aplikacja systemu Azure Service, Azure Functions lub Azure Container Apps. Aby uzyskać najnowszą listę dostępnych usług, zobacz Katalog produktów platformy Azure.

Dzięki funkcji IntelliTrace można rejestrować obszerne informacje debugowania dla wystąpienia roli, gdy jest ono uruchamiane na platformie Azure. Jeśli potrzebujesz znaleźć przyczynę problemu, możesz użyć dzienników IntelliTrace, aby przejść przez kod z programu Visual Studio tak, jakby był uruchomiony na platformie Azure. W efekcie intelliTrace rejestruje kluczowe wykonywanie kodu i dane środowiska, gdy aplikacja platformy Azure działa jako usługa w chmurze na platformie Azure i umożliwia odtwarzanie zarejestrowanych danych z programu Visual Studio.

Możesz użyć narzędzia IntelliTrace, jeśli masz zainstalowany program Visual Studio Enterprise, a aplikacja platformy Azure jest przeznaczona dla platformy .NET Framework 4 lub nowszej wersji. Funkcja IntelliTrace zbiera informacje dotyczące ról platformy Azure. Maszyny wirtualne dla tych ról zawsze działają w 64-bitowych systemach operacyjnych.

Alternatywnie możesz użyć zdalnego debugowania , aby dołączyć bezpośrednio do usługi w chmurze uruchomionej na platformie Azure.

Ważne

Funkcja IntelliTrace jest przeznaczona tylko dla scenariuszy debugowania i nie powinna być używana do wdrożenia produkcyjnego.

Wymagania wstępne

Konfigurowanie aplikacji platformy Azure dla środowiska IntelliTrace

Aby włączyć funkcję IntelliTrace dla aplikacji platformy Azure, należy utworzyć i opublikować aplikację w projekcie platformy Azure programu Visual Studio. Przed opublikowaniem jej na platformie Azure należy skonfigurować funkcję IntelliTrace dla aplikacji platformy Azure. Jeśli publikujesz aplikację bez konfigurowania funkcji IntelliTrace, musisz ponownie opublikować projekt. Aby uzyskać więcej informacji, zobacz Publikowanie projektów usług Azure Cloud Services przy użyciu programu Visual Studio.

  1. Gdy wszystko będzie gotowe do wdrożenia aplikacji platformy Azure, sprawdź, czy cele kompilacji projektu są ustawione na debugowanie.

  2. W Eksplorator rozwiązań kliknij prawym przyciskiem myszy projekt, a następnie z menu kontekstowego wybierz pozycję Publikuj.

  3. W oknie dialogowym Publikowanie aplikacja systemu Azure wybierz subskrypcję platformy Azure, a następnie wybierz pozycję Dalej.

  4. Na stronie Ustawienia wybierz kartę Zaawansowane Ustawienia.

  5. Włącz opcję Włącz funkcję IntelliTrace, aby zbierać dzienniki IntelliTrace dla aplikacji po jej opublikowaniu w chmurze.

  6. Aby dostosować podstawową konfigurację intelliTrace, wybierz pozycję Ustawienia obok pozycji Włącz intelliTrace.

    Link ustawień funkcji IntelliTrace

  7. W oknie dialogowym Ustawienia IntelliTrace można określić, które zdarzenia mają być rejestrowane, czy zbierać informacje o wywołaniu, które moduły i procesy zbierać dzienniki oraz ile miejsca do przydzielenia do nagrania. Aby uzyskać więcej informacji na temat funkcji IntelliTrace, zobacz Debugowanie za pomocą funkcji IntelliTrace.

    Ustawienia funkcji IntelliTrace

Dziennik IntelliTrace to plik dziennika cyklicznego o maksymalnym rozmiarze określonym w ustawieniach intelliTrace (domyślny rozmiar to 250 MB). Dzienniki intelliTrace są zbierane do pliku w systemie plików maszyny wirtualnej. Gdy zażądasz dzienników, migawka zostanie wykonana w tym momencie i pobrana na komputer lokalny.

Po opublikowaniu usługi w chmurze platformy Azure na platformie Azure możesz określić, czy funkcja IntelliTrace została włączona z poziomu węzła platformy Azure w Eksploratorze serwera, jak pokazano na poniższej ilustracji:

Eksplorator serwera — włączono funkcję IntelliTrace

Pobieranie dzienników IntelliTrace dla wystąpienia roli

Za pomocą programu Visual Studio możesz pobrać dzienniki IntelliTrace dla wystąpienia roli, wykonując następujące kroki:

  1. W Eksploratorze serwera rozwiń węzeł Cloud Services i znajdź wystąpienie roli, którego dzienniki chcesz pobrać.

  2. Kliknij prawym przyciskiem myszy wystąpienie roli, a następnie z menu kontekstowego wybierz pozycję Wyświetl dzienniki IntelliTrace.

    Opcja menu Wyświetl dzienniki IntelliTrace

  3. Dzienniki IntelliTrace są pobierane do pliku w katalogu na komputerze lokalnym. Za każdym razem, gdy zażądasz dzienników IntelliTrace, zostanie utworzona nowa migawka. Podczas pobierania dzienników program Visual Studio wyświetla postęp operacji w oknie Dziennik aktywności platformy Azure. Jak pokazano na poniższym rysunku, możesz rozwinąć element wiersza operacji, aby wyświetlić więcej szczegółów.

VST_IntelliTraceDownloadProgress

Możesz nadal pracować w programie Visual Studio, gdy dzienniki IntelliTrace są pobierane. Po zakończeniu pobierania dziennika zostanie on otwarty w programie Visual Studio.

Uwaga

Dzienniki IntelliTrace mogą zawierać wyjątki, które platforma generuje i obsługuje później. Kod struktury wewnętrznej generuje te wyjątki jako normalną część uruchamiania roli, dzięki czemu można je bezpiecznie zignorować.