Funkcje diagnostyczne
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.
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ń.
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.
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.
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.
Ś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ń.
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.
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 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.
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.
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:
- Zaloguj się do Centrum aplikacji i wybierz aplikację
- W menu po lewej stronie przejdź do pozycji Ustawienia
- Kliknij pozycję powiadomienia Email
- Wybierz pozycję Natychmiast, Codziennie lub Nigdy. Domyślna konfiguracja jest ustawiona na Wartość Nigdy.
Więcej informacji na temat powiadomień można uzyskać w dokumentacji pulpitu nawigacyjnego centrum aplikacji.
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ę.
Dokumentacja dotycząca przekazywania awarii za pośrednictwem interfejsu API została przeniesiona.