Share via

Funkcje diagnostyczne

  • Artykuł

Ważne

Program Visual Studio App Center ma zostać wycofany 31 marca 2025 r. Chociaż możesz nadal używać programu Visual Studio App Center do momentu jego pełnego wycofania, istnieje kilka zalecanych alternatyw, do których można rozważyć migrację.

Dowiedz się więcej o osiach czasu pomocy technicznej i alternatywach.

W tej sekcji dowiesz się więcej o zestawie funkcji dostępnym dla usługi diagnostyki Centrum aplikacji.

Analiza awarii i błędów

W obszarze Diagnostyka centrum aplikacji możesz wyświetlić dane analityczne generowane automatycznie przez centrum aplikacji, aby zrozumieć, kiedy w aplikacji wystąpi awaria lub błąd.

Domyślnie usługa App Center wyświetla awarie i błędy aplikacji dziennie w widoku równoległym.

Korzystając z kart w lewym górnym rogu, przejdź do szczegółów awarii i błędów. Gdy to zrobisz, lewy wykres wskazuje liczbę awarii/błędów dziennie, a prawy wykres przedstawia liczbę użytkowników, których dotyczy problem. Filtruj wykresy według wersji aplikacji, przedziału czasu i stanu, aby uzyskać bardziej skoncentrowany widok.

Uwaga

Usługa App Center filtruje potencjalnie poufne informacje. Przykłady poufnych informacji, które będą filtrowane, to adresy URL, ciągi JSON i identyfikatory żądań.

Usługa App Center pokazuje analizę awarii i błędów

Grupowanie

Grupy diagnostyczne usługi App Center ulegają awarii i błędom według podobieństw, takich jak przyczyna problemu i miejsce wystąpienia problemu w aplikacji. Dla każdej grupy awarii i błędów usługa App Center wyświetla wiersz kodu, który uległ awarii, nazwę klasy lub metody, nazwę pliku, numer wiersza, awarię lub typ błędu oraz komunikat, aby lepiej zrozumieć te grupy na pierwszy rzut oka. Wybierz grupę, aby wyświetlić więcej informacji i uzyskać dostęp do listy szczegółowych raportów i dzienników problemów. Dzięki temu możesz dokładniej poznać nasz zestaw funkcji, aby lepiej zrozumieć zachowanie aplikacji podczas awarii lub błędu.

Jeśli awaria jest spowodowana niepowodzeniem wywołania adresu URL (na przykład "Błąd podczas wywoływania azure.com lub google.com") usługa App Center może grupować awarie według tego adresu URL (na przykład wszystkie nie powiodły się wywołanie azure.com zostaną zgrupowane razem i nie można wywołać google.com zostaną zgrupowane razem). Jednak ponieważ usuwamy adresy URL prepended z dziennika awarii HTTP lub HTTPS, to grupowanie będzie działać tylko w przypadku uniknięcia tej składni na przykład: "Błąd podczas wywoływania http://azure.com" Nie będzie grupowany z innymi wywołaniami platformy Azure, ale "Błąd podczas wywoływania azure.com" zostanie pogrupowany z podobnymi raportami o błędach.

Grupy usługi App Center ulegają awarii i błędom na podstawie podobieństw

Identyfikacja użytkownika

Diagnostyka usługi App Center umożliwia dołączenie identyfikatora użytkownika do awarii i błędów. W tym celu użyj zestawu SDK centrum aplikacji w docelowej platformie Android, Apache Cordova, iOS, macOS, React Native, tvOS, Unity, UWP, WPF/WinForms i MAUI/Xamarin. Identyfikator użytkownika skojarzony z awarią lub błędem można znaleźć po kliknięciu problemu w grupie.

Po dołączeniu identyfikatora użytkownika możesz użyć funkcji wyszukiwania centrum aplikacji, aby wyszukać awarie z określonym identyfikatorem. Dowiedz się, jak to zrobić, postępując zgodnie z dokumentacją usługi App Center dotyczącą wyszukiwania.

Załączniki

W interfejsie użytkownika diagnostyki centrum aplikacji możesz wyświetlać i pobierać załączniki binarne i tekstowe raportów o awarii i błędach.

Aby dowiedzieć się, jak dodawać załączniki do raportów awarii, zapoznaj się z dokumentacją dotyczącą awarii zestawu SDK dla aplikacji android, iOS, macOS, React Native, UWP, WPF/WinForms i MAUI/Xamarin.

Załączniki do obsługiwanych błędów są obsługiwane tylko w przypadku platform Android, Unity, UWP, WPF, WinForms i Xamarin. Dowiedz się, jak dodawać załączniki do raportów o błędach w dokumentacji zestawu SDK dla aplikacji android, Unity, UWP, WPF/WinForms i MAUI/Xamarin .

Aby wyświetlić i pobrać załączniki, wybierz grupę awarii lub błędów, określony raport urządzenia, a następnie kliknij kartę załączniki.

Usługa App Center umożliwia dodawanie załączników do raportów o awarii i błędach

Zdarzenia przed awarią

Śledzenie zdarzeń prowadzących do awarii w celu przechwycenia przydatnych informacji o stanie aplikacji.

Aby zdefiniować zdarzenie niestandardowe, zapoznaj się z naszą dokumentacją zestawu SDK dla systemów Android, iOS, macOS, React Native, Windows i MAUI/Xamarin.

Aby wyświetlić zdarzenia przed awarią, wybierz grupę awarii, określony raport urządzenia, a następnie kliknij kartę zdarzeń.

Usługa App Center umożliwia śledzenie zdarzeń prowadzących do awarii

Pary klucz-wartość

Możesz dostosować raporty o błędach wysyłane do centrum aplikacji, aby uwzględnić dodatkowy kontekst błędu, przekazując do metody słownik wartości ciągu (jako pary klucz/wartość).TrackError Te właściwości są opcjonalne. Aby ustawić pary klucz-wartość, zapoznaj się z naszą dokumentacją systemów Android, MAUI/Xamarin, Unity, UWP i WPF/WinForms .

Uwaga

Ta funkcja jest obsługiwana tylko w przypadku błędów systemów Android, iOS, Xamarin, React Native, Unity, UWP, WinForms i WPF.

Eksportowanie danych diagnostycznych

Usługa App Center może eksportować dane pierwotne diagnostyki (awarie i błędy) na platformę Azure. Eksportowanie danych diagnostycznych do usługi Blob Storage w celu dostosowania danych.

Aby wyeksportować awarie, załączniki i błędy, należy wywołać interfejs API eksportowania konfiguracji:

POST /v0.1/apps/{owner_name}/{app_name}/export_configurations

exportEntities W polu właściwości interfejsu API musisz wskazać typ danych, które chcesz wyeksportować: awarie, błędy, załączniki. W tym celu zostaną wyeksportowane pełne symboliczne awarie i odpowiednie ślady stosu.

Dowiedz się więcej o korzyściach i sposobach eksportowania danych w dokumentacji eksportu.

Wątki

W raporcie o awarii można zobaczyć bieżące wątki, które były aktywne, gdy aplikacja uległa awarii. Wątek, który uległ awarii, został wyróżniony na czerwono, aby lepiej zrozumieć stan aplikacji.

W usłudze App Center są wyświetlane bieżące wątki w momencie awarii

Uwaga

W systemie Windows raport przedstawia tylko ślad stosu z wątku, który uległ awarii. Wyświetlanie stanu innych wątków w momencie awarii nie jest obsługiwane w systemie Windows.

Konfigurowanie alertów

Bądź na bieżąco z awariami, konfigurując ustawienia definicji aplikacji Centrum aplikacji w celu wysyłania powiadomień e-mail. To ustawienie można skonfigurować dla każdej aplikacji tak, aby wysyłała wiadomość e-mail natychmiast po utworzeniu nowej grupy awarii lub wysyłać codzienne wiadomości e-mail z podsumowaniem z największymi awariami aplikacji. Aby skonfigurować te alerty:

  1. Zaloguj się do Centrum aplikacji i wybierz aplikację
  2. W menu po lewej stronie przejdź do pozycji Ustawienia
  3. Kliknij pozycję powiadomienia Email
  4. Wybierz pozycję Natychmiast, Codziennie lub Nigdy. Domyślna konfiguracja jest ustawiona na Wartość Nigdy.

Zrzut ekranu przedstawiający ustawienie Częstotliwość powiadamiania e-mail o awarii

Więcej informacji na temat powiadomień można uzyskać w dokumentacji pulpitu nawigacyjnego centrum aplikacji.

Tworzenie monitora usterek

Możesz zintegrować narzędzia do śledzenia usterek innych firm z usługą App Center, aby być na bieżąco i lepiej zarządzać awariami. Przeczytaj dokumentację trackera błędów , aby dowiedzieć się, jak rozpocząć pracę.

Przekazywanie raportów do Centrum aplikacji

Dokumentacja dotycząca przekazywania awarii za pośrednictwem interfejsu API została przeniesiona.