REST Resource: vitals.errors.issues

Ресурс: ErrorIssue

Группа связанных отчетов об ошибках, полученных для приложения.

Похожие отчеты об ошибках группируются в проблемы с вероятной одинаковой причиной.

Обратите внимание: этот ресурс находится в стадии альфа-тестирования. Возможны изменения в группировке проблем, которые приведут к назначению похожих, но более свежих отчётов об ошибках разным проблемам. Это также может привести к полному исчезновению некоторых проблем и их замене новыми.

Требуемые разрешения : для доступа к этому ресурсу вызывающему пользователю необходимо разрешение «Просмотр информации о приложении (только чтение)» для приложения.

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
  ]
}
Поля
name

string

Идентификатор. Имя ресурса, к которому относится проблема.

Формат: apps/{app}/{issue}

type

enum ( ErrorType )

Тип ошибок, сгруппированных в этой проблеме.

cause

string

Причина проблемы.

В зависимости от типа это может быть:

  • APPLICATION_NOT_RESPONDING: тип возникшей ошибки ANR, например, «Истекло время ожидания отправки входных данных».
  • CRASH: для необработанных исключений Java — тип самого внутреннего исключения, которое было сгенерировано, например, IllegalArgumentException. Для сигналов в машинном коде — тип сгенерированного сигнала, например, SIGSEGV.
location

string

Место, где возникла проблема.

В зависимости от типа это может быть:

  • APPLICATION_NOT_RESPONDING: имя действия или службы, которые перестали отвечать.
  • CRASH: вероятное имя метода, вызвавшего ошибку.
errorReportCount

string ( int64 format)

Общее количество сообщений об ошибках в этой проблеме (с учетом только случаев, соответствующих фильтрам и запрошенный период времени).

distinctUsers

string ( int64 format)

Оценка количества уникальных пользователей, столкнувшихся с этой проблемой (с учетом только случаев, соответствующих фильтрам и запрошенный период времени).

distinctUsersPercent

object ( Decimal )

Предполагаемый процент пользователей, затронутых любой проблемой, которых коснулась данная проблема (с учетом только случаев, соответствующих фильтрам и находящихся в запрошенном периоде времени).

lastErrorReportTime

string ( Timestamp format)

Начало часа, в течение которого произошел последний отчет об ошибке в этой проблеме.

Использует RFC 3339, согласно которому сгенерированный вывод всегда будет нормализован по оси Z и будет содержать 0, 3, 6 или 9 знаков после запятой. Также допускаются смещения, отличные от «Z». Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

issueUri

string

Ссылка на проблему в Android Vitals в Play Console.

firstOsVersion

object ( OsVersion )

Наименьшая версия ОС, в которой этот кластер ошибок возник за запрошенный период времени (с учетом только событий, соответствующих фильтрам и находящихся в запрошенном периоде времени).

lastOsVersion

object ( OsVersion )

Последняя версия ОС, в которой произошел этот кластер ошибок в запрошенный период времени (с учетом только событий, соответствующих фильтрам и в пределах запрошенного периода времени).

firstAppVersion

object ( AppVersion )

Самая ранняя (включительная) версия приложения, появляющаяся в этой ErrorIssue за запрошенный период времени (с учетом только случаев, соответствующих фильтрам).

lastAppVersion

object ( AppVersion )

Последняя (включительная) версия приложения, появляющаяся в этой ErrorIssue за запрошенный период времени (с учетом только случаев, соответствующих фильтрам).

annotations[]

object ( IssueAnnotation )

Список аннотаций к проблеме. Аннотации содержат дополнительную информацию, которая может помочь в диагностике и устранении проблемы.

sampleErrorReports[]

string

Только вывод. Примеры отчётов об ошибках, относящихся к этой ошибке. Примечание: в настоящее время поддерживается не более одного отчёта на одну ошибку. Формат: "apps/{app}/{report}".

ВыпускАннотация

Представление аннотационного сообщения для проблемы.

JSON-представление 
{
  "category": string,
  "title": string,
  "body": string
}
Поля
category

string

Категория, к которой принадлежит аннотация. Аннотация будет принадлежать к одной категории. Примеры категорий: «Потенциальное решение», «Проницательность».

title

string

Название аннотации.

body

string

Содержит содержимое аннотационного сообщения.

Методы

Поиск всех ошибок, по которым были сгруппированы отчеты.