REST Resource: vitals.errors.issues

資源：ErrorIssue

應用程式收到的一組相關錯誤報告。

系統會將類似的錯誤報告歸類為問題，這些問題可能源於相同的根本原因。

請注意：這項資源目前為 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

ID。問題的資源名稱。

格式：apps/{app}/{issue}
type

enum (ErrorType)

這個問題中歸類的錯誤類型。
cause

string

問題原因。

視類型而定，這可以是：

  • APPLICATION_NOT_RESPONDING：發生 ANR 的類型，例如 「輸入分派作業逾時」。
  • 當 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

連結至 Play 管理中心 Android Vitals 中的問題。
firstOsVersion

object (OsVersion)

這個錯誤叢集在要求時間範圍內發生的最小作業系統版本 (只會考量符合篩選條件且在要求時間範圍內發生的錯誤)。
lastOsVersion

object (OsVersion)

在要求時間範圍內發生此錯誤叢集的最新 OS 版本 (僅考量符合篩選條件且在要求時間範圍內發生的情況)。
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

包含註解訊息的內容。

方法
搜尋報告中已分組的所有錯誤問題。