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:no momento, 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).

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 dos erros agrupados neste problema.
cause

string

Causa do problema.

Dependendo do tipo, pode ser:

  • APPLICATION_NOT_RESPONDING: o tipo de ANR que ocorreu, por exemplo, "O despacho de entrada expirou".
  • CRASH: para erros de exceção não processada do Java, o tipo da exceção mais interna que foi gerada, por exemplo, IllegalArgumentException. Para indicadores em código nativo, o indicador que foi gerado, por exemplo, SIGSEGV.
location

string

Local onde o problema ocorreu.

Dependendo do tipo, pode ser:

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

string (int64 format)

O número total de relatórios de erros neste problema (considerando apenas as 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 as ocorrências que correspondem aos filtros e estão dentro do período solicitado).
distinctUsersPercent

object (Decimal)

Uma porcentagem estimada de usuários afetados por qualquer problema que também foram afetados por este problema (considerando apenas as ocorrências que correspondem aos filtros e estão dentro do período solicitado).
lastErrorReportTime

string (Timestamp format)

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

Usa RFC 3339, em que a saída gerada é sempre normalizada em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Outros ajustes também são aceitos. Por exemplo, "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30";
issueUri

string

Vincule ao 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 as ocorrências que correspondem aos filtros e estão 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 as ocorrências que correspondem aos filtros e estão dentro do período solicitado).
firstAppVersion

object (AppVersion)

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

object (AppVersion)

A versão mais recente (inclusive) do app que aparece neste ErrorIssue no período solicitado (considerando apenas as 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 este ErrorIssue. Observação:no momento, é aceito no máximo um 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 erro em que os relatórios foram agrupados.