REST Resource: vitals.errors.issues

Zasób: ErrorIssue

Grupa powiązanych raportów o błędach otrzymanych w przypadku aplikacji.

Podobne raporty o błędach są grupowane w problemy o prawdopodobnie identycznej głównej przyczynie.

Uwaga: ten zasób jest obecnie w wersji alfa. Może dojść do zmian w grupowaniu problemów, w wyniku których podobne, ale nowsze raporty o błędach zostaną przypisane do innych problemów. Może to również spowodować, że niektóre problemy całkowicie znikną i zostaną zastąpione nowymi.

Wymagane uprawnienia: aby uzyskać dostęp do tego zasobu, użytkownik wywołujący musi mieć uprawnienie Wyświetlanie informacji o aplikacji (tylko do odczytu) w przypadku aplikacji.

Zapis JSON 
{
  "name": string,
  "type": enum (ErrorType),
  "cause": string,
  "location": string,
  "errorReportCount": string,
  "distinctUsers": string,
  "distinctUsersPercent": {
    object (Decimal)
  },
  "lastErrorReportTime": string,
  "issueUri": string,
  "firstOsVersion": {
    object (OsVersion)
  },
  "lastOsVersion": {
    object (OsVersion)
  },
  "firstAppVersion": {
    object (AppVersion)
  },
  "lastAppVersion": {
    object (AppVersion)
  },
  "annotations": [
    {
      object (IssueAnnotation)
    }
  ],
  "sampleErrorReports": [
    string
  ]
}
Pola
name

string

Identyfikator. Nazwa zasobu problemu.

Format: apps/{app}/{issue}
type

enum (ErrorType)

Typ błędów zgrupowanych w tym problemie.
cause

string

Przyczyna problemu.

W zależności od typu może to być:

  • APPLICATION_NOT_RESPONDING: typ błędu ANR, np. „Input dispatching timed out” (Przekroczono limit czasu wysyłania danych wejściowych).
  • CRASH: w przypadku błędów nieobsługiwanych wyjątków w Javie typ najbardziej wewnętrznego wyjątku, który został zgłoszony, np. IllegalArgumentException. W przypadku sygnałów w kodzie natywnym jest to sygnał, który został wywołany, np. SIGSEGV.
location

string

Miejsce, w którym wystąpił problem.

W zależności od typu może to być:

  • APPLICATION_NOT_RESPONDING: nazwa aktywności lub usługi, która przestała odpowiadać.
  • CRASH: prawdopodobna nazwa metody, która spowodowała błąd.
errorReportCount

string (int64 format)

Łączna liczba raportów o błędach w tym problemie (uwzględniane są tylko wystąpienia pasujące do filtrów i w wybranym okresie).
distinctUsers

string (int64 format)

Szacunkowa liczba unikalnych użytkowników, u których wystąpił ten problem (uwzględniane są tylko wystąpienia zgodne z filtrami i w wybranym okresie).
distinctUsersPercent

object (Decimal)

Szacunkowy odsetek użytkowników, u których występuje dowolny problem, a u których występuje ten problem (bierzemy pod uwagę tylko wystąpienia zgodne z filtrami i w żądanym okresie).
lastErrorReportTime

string (Timestamp format)

Początek godziny, w której wystąpił ostatni raport o błędzie dotyczący tego problemu.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".
issueUri

string

Link do problemu w Android Vitals w Konsoli Play.
firstOsVersion

object (OsVersion)

Najmniejsza wersja systemu operacyjnego, w której wystąpił ten klaster błędów w wybranym okresie (pod uwagę brane są tylko wystąpienia pasujące do filtrów i w wybranym okresie).
lastOsVersion

object (OsVersion)

Najnowsza wersja systemu operacyjnego, w której wystąpił ten klaster błędów w żądanym okresie (pod uwagę brane są tylko wystąpienia pasujące do filtrów i w żądanym okresie).
firstAppVersion

object (AppVersion)

Najstarsza (włącznie) wersja aplikacji, która występuje w tym błędzie w żądanym okresie (uwzględniane są tylko wystąpienia zgodne z filtrami).
lastAppVersion

object (AppVersion)

Najnowsza (włącznie) wersja aplikacji, która występuje w tym błędzie w żądanym okresie (uwzględniane są tylko wystąpienia pasujące do filtrów).
annotations[]

object (IssueAnnotation)

Lista adnotacji dotyczących problemu. Adnotacje zawierają dodatkowe informacje, które mogą pomóc w diagnozowaniu i rozwiązywaniu problemu.
sampleErrorReports[]

string

Tylko dane wyjściowe. Przykładowe raporty o błędach należące do tego problemu z błędem. Uwaga: obecnie obsługiwana jest maksymalnie 1 wartość na element ErrorIssue. Format: „apps/{app}/{report}”

IssueAnnotation

Prezentacja wiadomości z adnotacją dotyczącą problemu.

Zapis JSON 
{
  "category": string,
  "title": string,
  "body": string
}
Pola
category

string

Kategoria, do której należy adnotacja. Adnotacja będzie należeć do jednej kategorii. Przykładowe kategorie: „Potencjalna poprawka”, „Statystyki”.
title

string

Tytuł adnotacji.
body

string

Zawiera treść wiadomości z adnotacją.

Metody
Przeszukuje wszystkie problemy z błędami, w których zgrupowano raporty.