REST Resource: vitals.errors.issues

资源：ErrorIssue

针对某个应用收到的一组相关 ErrorReport。

系统会将相似的错误报告归为一组，这些错误报告可能具有相同的根本原因。

请注意：此资源目前处于 Alpha 版测试阶段。问题分组可能会发生变化，导致类似但更新近的错误报告被分配给不同的问题。这还可能导致某些问题完全消失并被新问题取代。

所需权限：如需访问此资源，调用用户需要拥有应用的查看应用信息（只读）权限。

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 类型，例如“输入调度超时”。
  • 崩溃：对于 Java 未处理的异常错误，抛出的最内层异常的类型，例如IllegalArgumentException。对于原生代码中的信号，指引发的信号，例如 SIGSEGV。
location

string

问题发生的位置。

根据类型的不同，这可以是：

  • APPLICATION_NOT_RESPONDING：停止响应的 activity 或服务的名称。
  • 崩溃：可能导致错误的方法名称。
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

指向 Play 管理中心内 Android Vitals 中的问题的链接。
firstOsVersion

object (OsVersion)

相应错误聚类在所请求的时间段内出现过的最小操作系统版本（仅考虑与过滤条件匹配且在所请求的时间段内发生的错误）。
lastOsVersion

object (OsVersion)

在请求的时间段内，相应错误集群发生的最新操作系统版本（仅考虑符合过滤条件且在请求的时间段内发生的错误）。
firstAppVersion

object (AppVersion)

相应 ErrorIssue 在所请求时间段内出现的最早（含）应用版本（仅考虑与过滤条件匹配的出现次数）。
lastAppVersion

object (AppVersion)

相应 ErrorIssue 在所请求时间段内出现的最新（含）应用版本（仅考虑与过滤条件匹配的出现次数）。
annotations[]

object (IssueAnnotation)

问题的注释列表。注释可提供有助于诊断和解决问题的其他信息。
sampleErrorReports[]

string

仅限输出。属于相应 ErrorIssue 的示例错误报告。注意：目前，每个 ErrorIssue 最多支持 1 个。格式：“apps/{app}/{report}”

IssueAnnotation

问题的注释消息的表示形式。

JSON 表示法 
{
  "category": string,
  "title": string,
  "body": string
}
字段
category

string

注释所属的类别。注释只能属于一个类别。示例类别：“潜在修复”“数据洞见”。
title

string

注释的标题。
body

string

包含注释消息的内容。

方法
搜索报告已分组的所有错误问题。