Raport dotyczący kondycji
Raport Kondycja w Centrum partnerskim umożliwia pobieranie danych związanych z wydajnością i jakością aplikacji, w tym awariami i zdarzeniami braku odpowiedzi. Możesz wyświetlić te dane w Centrum partnerskim lub pobrać raport, aby wyświetlić go w trybie offline. Jeśli ma to zastosowanie, można wyświetlić ślady stosu i/lub pliki CAB w celu dalszego debugowania.
Alternatywnie możesz programowo pobrać dane w tym raporcie przy użyciu interfejsu API REST analizy sklepu Microsoft Store.
Zmiany kategoryzacji błędów awarii dla wydawców aplikacji i gier
Aby zwiększyć dokładność i jakość śledzenia awarii, planowane są zmiany kategoryzacji awarii. Wymienione zmiany będą miały zastosowanie do szczegółowych informacji o zestawie danych kondycji od 15 października 2024 r.
Uwaga
Szczegółowe informacje dotyczące 15 października 2024 r. rozpoczną się 15 października 2024 r. W przypadku szczegółowych informacji wcześniej niż 15 października 2024 r. nie będzie żadnych zmian.
Ponieważ zestawy danych kondycji wyświetlają szczegółowe informacje z ostatnich 30 dni, między 15 października a 15 listopada 2024 r. nastąpi okres przejściowy, w którym współistnieją stare i nowe zasobniki danych.
Te zmiany miałyby wpływ na zestaw danych kondycji dostępny w centrum pobierania, publicznych interfejsach API, interfejsach API centrum partnerskiego i interfejsach API programowych w celu uzyskania dostępu do zestawów danych centrum pobierania.
Następujące zmiany dotyczą kategorii poprzedzających nazwy błędów:
Kategorie | Zmiany |
---|---|
- INVALID_POINTER_READ - INVALID_POINTER_WRITE - INVALID_POINTER_EXECUTE - BAD_INSTRUCTION_PTR - NULL_INSTRUCTION_PTR - SOFTWARE_NX_FAULT - ACCESS_VIOLATION_ACCESS_VIOLATION_ |
Wszystkie kategorie wymienione po lewej stronie są pogrupowane w ramach nowej kategorii ACCESS_VIOLATION. |
- ACCESS_VIOLATION_FAIL_FAST | Nazwy błędów rozpoczynających się od kategorii są zmieniane na FAIL_FAST. |
- STACK_BUFFER_OVERRUN_STACK_BUFFER_OVERRUN | Zmieniono nazwę na STACK_BUFFER_OVERRUN |
- MISSING_GSFRAME_ - GS_FALSE_POSITIVE_ - GS_POSITIVE_ - GS_NOT_UP2DATE_ - GS_UP2DATE_NOT_KNOWN_ - GS_UNKNOWN_ - GS_COOKIE_INIT_ - GS_SUSPECT_ - ZERO_CANARY_WITH_SE - MINGLY_INTACT_BP_ - NO_MODULE_ -KOD_ - PROBABLY_NOT_USING_GS_ - STACK_COOKIE_CHECK_FAILURE - GLOBAL_COOKIE_CORRUPT_ - INCORRECT_STACK_ - COOKIES_MATCH_ - RUNNING_ON_STACK_ - STRING_DEREFERENCE_ |
Wymienione kategorie są usuwane z nazw błędów. |
Zastosuj filtry
W górnej części strony możesz wybrać okres, dla którego chcesz wyświetlić dane. Domyślnym wyborem jest 72H (72 godziny), ale zamiast tego możesz wybrać opcję 30D , aby wyświetlić dane w ciągu ostatnich 30 dni. Dane są wyświetlane w lokalnej strefie czasowej dla widoku 72H i w formacie UTC dla widoku 30D .
Możesz również rozwinąć filtry , aby filtrować wszystkie dane na tej stronie według wersji pakietu, rynku i/lub typu urządzenia.
- Wersja pakietu: ustawienie domyślne to Wszystkie. Jeśli aplikacja zawiera więcej niż jeden pakiet, możesz wybrać konkretny pakiet tutaj.
- Rynek: domyślny filtr to Wszystkie rynki, ale można ograniczyć dane do co najmniej jednego rynku.
- Typ urządzenia: ustawienie domyślne to Wszystkie, ale można wybrać wyświetlanie danych tylko dla jednego określonego typu urządzenia. Kategoria Inne obejmuje urządzenia, na których rozpoznano make/model, ale nie możemy dołączyć go do jednej ze wstępnie zdefiniowanych kategorii pokazanych w tym filtrze. W przypadku tych urządzeń model urządzenia można wyświetlić w sekcji Dziennik błędów raportu Szczegóły błędu.
- Wersja systemu operacyjnego: wartość domyślna to Wszystkie wersje systemu operacyjnego, ale można wybrać określoną wersję systemu operacyjnego.
- Wersja wydania systemu operacyjnego: domyślnie jest to Wszystkie wersje wersji systemu operacyjnego, ale możesz wybrać określoną wersję wersji wybranej wersji systemu operacyjnego.
- Piaskownica: wartość domyślna to Sprzedaż detaliczna, ale w przypadku produktów korzystających z wielu piaskownic programistycznych (takich jak gry integrujące się z usługą Xbox Live) możesz wybrać określoną w tym miejscu. (Jeśli produkt nie używa piaskownic, ten filtr będzie wyświetlany tylko Sprzedaż detaliczna i nie będzie mieć zastosowania).
- Architektura: wartość domyślna to Wszystkie architektury, ale można wybrać określony typ architektury systemu. Ten filtr jest dostępny tylko wtedy, gdy wybrano opcję 30D .
- PRAID: Ustawieniem domyślnym jest Wszystkie, ale jeśli zdefiniowano wiele identyfikatorów aplikacji względnych pakietów (PRAID) podczas tworzenia pakietu aplikacji, możesz wybrać wyświetlanie tylko danych powiązanych z jednym identyfikatorem PRAID. Ten filtr nie będzie wyświetlany, jeśli nie zdefiniowano wielu identyfikatorów PRAID.
Informacje we wszystkich wykresach wymienionych poniżej odzwierciedlają zakres dat i wszystkie wybrane filtry. Niektóre sekcje umożliwiają również stosowanie dodatkowych filtrów.
Błędy trafień
Wykres Niepowodzenie osiąga liczbę codziennych awarii i zdarzeń, które klienci napotykali podczas korzystania z aplikacji w wybranym przedziale czasu. Każdy typ zdarzenia, które napotkano w aplikacji, jest śledzony oddzielnie: awarie, zawieszanie się, wyjątki języka JavaScript i błędy pamięci.
Po wybraniu okresu 30D może zostać wyświetlony znaczniki okręgu. Stanowią one znaczący wzrost lub spadek danej wartości, o której myślimy, że warto o tym wiedzieć. Data, w której pojawia się okrąg, reprezentuje koniec tygodnia, w którym wykryliśmy znaczny wzrost lub spadek w porównaniu z tygodniem wcześniej. Aby wyświetlić więcej szczegółów na temat tego, co się zmieniło, umieść kursor nad okręgiem.
Napiwek
Więcej szczegółowych informacji dotyczących znaczących zmian w ciągu ostatnich 30 dni można wyświetlić w raporcie szczegółowych informacji.
Niepowodzenie trafień według rynku
Wykres Niepowodzeń trafień według rynku pokazuje łączną liczbę awarii i zdarzeń w wybranym okresie według rynku.
Te dane można wyświetlić w formularzu Tabela . Formularz tabeli będzie zawierać pięć rynków jednocześnie posortowanych alfabetycznie lub według najwyższej/najniższej liczby sesji użytkowników. Możesz również pobrać dane, aby wyświetlić informacje dotyczące wszystkich rynków razem.
Wersja pakietu
Wykres Wersja pakietu przedstawia łączną liczbę awarii i zdarzeń w wybranym przedziale czasu według wersji pakietu. Domyślnie pokazujemy wersję pakietu, która miała najwięcej trafień na górze i kontynuować w dół z tego miejsca. Tę kolejność można cofnąć, przełączając strzałkę w kolumnie Hits tego wykresu.
Błędy
Wykres Błędy przedstawia łączną liczbę awarii i zdarzeń w wybranym przedziale czasu według nazwy błędu. Każda nazwa błędu składa się z czterech części: co najmniej jednej klasy problemu, kodu sprawdzania wyjątku/błędu, nazwy obrazu/sterownika, w którym wystąpił błąd i skojarzonej nazwy funkcji. Domyślnie pokazujemy awarię, która miała największe trafienia na górze i kontynuować w dół z tego miejsca. Tę kolejność można cofnąć, przełączając strzałkę w kolumnie Hits tego wykresu. Dla każdego błędu pokazujemy również jego wartość procentową całkowitej liczby awarii.
Napiwek
Czasami w tej sekcji może zostać wyświetlony wpis Nieznany . Dzieje się tak, gdy pomimo naszych najlepszych wysiłków nie możemy zebrać pełnych szczegółów dla co najmniej jednego błędu, które zostaną zgrupowane razem w obszarze Nieznane. Najczęściej występuje to z powodu ograniczeń magazynu, ale może to być również spowodowane ustawieniami prywatności urządzenia, problemami z połączeniem sieciowym, częściowymi/złymi zrzutami awaryjnymi i innymi czynnikami.
Jeśli w nazwie błędu jest wyświetlana wartość !unknown , oznacza to, że symbole nie były obecne, więc nie można zidentyfikować nazwy błędu. Pamiętaj, aby uwzględnić symbole w pakiecie, aby uzyskać dokładną analizę błędów. Zobacz Konfigurowanie pakietu aplikacji. Z kolei nazwy błędów, które zawierają !unknown_error_in_ i !unknown_function , oznaczają, że nie można zebrać pełnych szczegółów z różnych innych powodów.
Aby wyświetlić raport Szczegóły błędu dla określonego błędu, wybierz nazwę błędu. Jeśli dołączono pliki symboli, raport Szczegóły błędu zawiera liczbę trafień awarii w ciągu ostatniego miesiąca oraz dziennik błędów zawierający szczegółowe informacje o wystąpieniu (data, wersja pakietu, typ urządzenia, model urządzenia, kompilacja systemu operacyjnego) oraz link do pliku śledzenia stosu i/lub PLIKU CAB, jeśli jest dostępny.
Napiwek
Pliki CAB będą dostępne tylko wtedy, gdy wystąpił błąd na komputerze przy użyciu kompilacji niejawnego programu testów systemu Windows, więc nie wszystkie błędy będą zawierać opcję pobierania cab. Aby wyświetlić tylko błędy z plikami CAB, wybierz pozycję Błędy z pobieraniem w filtrze sekcji. Możesz również kliknąć nagłówek Linki w dzienniku błędów, aby posortować wyniki, aby błędy zawierające pliki CAB pojawiały się w górnej części listy.
Na stronie Szczegóły błędu zobaczysz również wykres częstości występowania stosu, który przedstawia najważniejsze stosy, które przyczyniły się do awarii, uporządkowane według wartości procentowej, oraz wykres Konfiguracja urządzenia (30D), który zawiera szczegółowe informacje o konfiguracji urządzeń, które napotkały awarię.
Sesje i urządzenia bez awarii (30D)
Wykres sesji bez awarii i urządzeń przedstawia procent sesji urządzeń lub użytkowników, które nie uległy awarii w ciągu ostatnich 30 dni. Te informacje pomagają zrozumieć, jak szeroko twoje awarie wpływają na użytkowników. Na przykład aplikacja może mieć 10 000 awarii w ciągu jednego dnia. Jeśli dotyczy to 90% urządzeń, prawdopodobnie sklasyfikowalibyśmy je jako krytyczne i działają, aby naprawić je od razu. Jeśli jednak reprezentuje to tylko 5% urządzeń korzystających z aplikacji, priorytet może być niższy.
Ten wykres ma dwie karty:
- Urządzenia bez awarii: przedstawia procent unikatowych urządzeń, które nie doświadczyły awarii każdego dnia (w ciągu ostatnich 30 dni).
- Sesje wolne od awarii: przedstawia procent unikatowych sesji użytkownika, które nie wystąpiły awarii każdego dnia (w ciągu ostatnich 30 dni).
Współczynnik awarii
Współczynnik awarii jest definiowany jako suma awarii w przypadku gry podzielonej przez sumę aktywacji, dla określonego przedziału czasu, dla wszystkich użytkowników grających w grę. Za każdym razem, gdy gra jest otwarta/świeżo uruchomiona/uruchomiona do gry, jest liczone jako jedna aktywacja. Oś czasu aktywacji i awarii mogą się różnić. Może się zdarzyć, że aktywacja miała miejsce dzisiaj, ale następnego dnia doszło do awarii. Współczynnik awarii jest liowany tylko w określonym przedziale czasu. Nie zawiera informacji o tym, o czym aktywacja doprowadziła do awarii.