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

string

问题发生的位置。

根据类型，这可以是以下任一内容：

  • APPLICATION_NOT_RESPONDING：停止响应的 activity 或服务的名称。
  • CRASH：可能导致错误的方法名称。
errorReportCount

string (int64 format)

此问题中的错误报告总数（仅考虑与过滤条件匹配且在请求的时间段内发生的情况）。
distinctUsers

string (int64 format)

遇到此问题的唯一身份用户数量的估计值（仅考虑与过滤条件匹配且在请求的时间段内发生的情况）。
distinctUsersPercent

object (Decimal)

受任何问题影响的用户中受此问题影响的用户所占的估计百分比（仅考虑与过滤条件匹配且在请求的时间段内发生的情况）。
lastErrorReportTime

string (Timestamp format)

此问题中最后一个错误报告发生的小时的开始时间。

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 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

包含注释消息的内容。

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