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" в Play Console.

firstOsVersion

object ( OsVersion )

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

lastOsVersion

object ( OsVersion )

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

firstAppVersion

object ( AppVersion )

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

lastAppVersion

object ( AppVersion )

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

annotations[]

object ( IssueAnnotation )

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

sampleErrorReports[]

string

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

Аннотация к проблеме

Представление аннотации к проблеме.

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

string

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

title

string

Заголовок для аннотации.

body

string

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

Методы

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