REST Resource: vitals.errors.issues

Recurso: ErrorIssue

Um grupo de ErrorReports relacionados recebidos para um app.

Relatórios de erros semelhantes são agrupados em problemas com uma causa raiz provavelmente idêntica.

Observação:esse recurso está na versão Alfa. Pode haver mudanças no agrupamento de problemas que resultariam em relatórios de erros semelhantes, mas mais recentes, sendo atribuídos a problemas diferentes. Isso também pode fazer com que alguns problemas desapareçam completamente e sejam substituídos por novos.

Permissões necessárias: para acessar esse recurso, o usuário que faz a chamada precisa da permissão Ver informações do app (somente leitura) para o app.

Representação 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
  ]
}
Campos
name

string

Identificador. O nome do recurso do problema.

Formato: apps/{app}/{issue}

type

enum (ErrorType)

Tipo de erros agrupados nesse problema.

cause

string

Causa do problema.

Dependendo do tipo, pode ser:

  • APPLICATION_NOT_RESPONDING: o tipo de ANR que ocorreu, por exemplo, "Tempo limite de envio de entrada".
  • CRASH: para erros de exceção não tratados em Java, o tipo de exceção mais interna que foi gerada, por exemplo, IllegalArgumentException. Para sinais em código nativo, o sinal que foi gerado, por exemplo, SIGSEGV.
location

string

Local em que o problema ocorreu.

Dependendo do tipo, pode ser:

  • APPLICATION_NOT_RESPONDING: o nome da atividade ou serviço que parou de responder.
  • CRASH: o nome do método que provavelmente causou o erro.
errorReportCount

string (int64 format)

O número total de relatórios de erros nesse problema (considerando apenas ocorrências que correspondem aos filtros e dentro do período solicitado).

distinctUsers

string (int64 format)

Uma estimativa do número de usuários únicos que tiveram esse problema (considerando apenas ocorrências que correspondem aos filtros e dentro do período solicitado).

distinctUsersPercent

object (Decimal)

Uma porcentagem estimada de usuários afetados por qualquer problema que sejam afetados por esse problema (considerando apenas ocorrências que correspondem aos filtros e dentro do período solicitado).

lastErrorReportTime

string (Timestamp format)

Início da hora em que o último relatório de erros nesse problema ocorreu.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

issueUri

string

Link para o problema no Android vitals no Play Console.

firstOsVersion

object (OsVersion)

A menor versão do SO em que esse cluster de erros ocorreu no período solicitado (considerando apenas ocorrências que correspondem aos filtros e dentro do período solicitado).

lastOsVersion

object (OsVersion)

A versão mais recente do SO em que esse cluster de erros ocorreu no período solicitado (considerando apenas ocorrências que correspondem aos filtros e dentro do período solicitado).

firstAppVersion

object (AppVersion)

A versão mais antiga (inclusiva) do app que aparece nesse ErrorIssue no período solicitado (considerando apenas ocorrências que correspondem aos filtros).

lastAppVersion

object (AppVersion)

A versão mais recente (inclusiva) do app que aparece nesse ErrorIssue no período solicitado (considerando apenas ocorrências que correspondem aos filtros).

annotations[]

object (IssueAnnotation)

Lista de anotações para um problema. As anotações fornecem informações adicionais que podem ajudar a diagnosticar e corrigir o problema.

sampleErrorReports[]

string

Apenas saída. Relatórios de erros de amostra que pertencem a esse ErrorIssue. Observação:atualmente, há suporte para no máximo 1 por ErrorIssue. Formato: "apps/{app}/{report}"

IssueAnnotation

Representação de uma mensagem de anotação para um problema.

Representação JSON
{
  "category": string,
  "title": string,
  "body": string
}
Campos
category

string

Categoria a que a anotação pertence. Uma anotação pertence a uma única categoria. Exemplos de categorias: "Possível correção", "Insight".

title

string

Título da anotação.

body

string

Contém o conteúdo da mensagem de anotação.

Métodos

Pesquisa todos os problemas de erros em que os relatórios foram agrupados.