REST Resource: vitals.errors.issues

Tài nguyên: ErrorIssue

Một nhóm ErrorReport liên quan nhận được cho một ứng dụng.

Các báo cáo lỗi tương tự được nhóm lại thành các vấn đề có thể có cùng nguyên nhân gốc.

Xin lưu ý: tài nguyên này hiện đang ở giai đoạn Alpha. Có thể có những thay đổi đối với việc nhóm vấn đề, dẫn đến việc các báo cáo lỗi tương tự nhưng gần đây hơn được chỉ định cho các vấn đề khác nhau. Điều này cũng có thể khiến một số vấn đề biến mất hoàn toàn và được thay thế bằng các vấn đề mới.

Quyền bắt buộc: để truy cập vào tài nguyên này, người dùng gọi cần có quyền Xem thông tin ứng dụng (chỉ có thể đọc) cho ứng dụng.

Biểu diễn dưới dạng 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
  ]
}
Trường
name

string

Số nhận dạng. Tên tài nguyên của vấn đề.

Định dạng: apps/{app}/{issue}
type

enum (ErrorType)

Loại lỗi được nhóm trong vấn đề này.
cause

string

Nguyên nhân gây ra vấn đề.

Tuỳ thuộc vào loại, nguyên nhân có thể là:

  • APPLICATION_NOT_RESPONDING: loại lỗi ANR đã xảy ra, ví dụ: "Input dispatching timed out" (Đã hết thời gian truyền dữ liệu đầu vào).
  • CRASH: đối với các lỗi ngoại lệ không được xử lý của Java, loại ngoại lệ trong cùng đã được gửi, ví dụ: IllegalArgumentException. Đối với các tín hiệu trong mã gốc, tín hiệu đã được gửi, ví dụ: SIGSEGV.
location

string

Vị trí xảy ra vấn đề.

Tuỳ thuộc vào loại, vị trí có thể là:

  • APPLICATION_NOT_RESPONDING: tên của hoạt động hoặc dịch vụ đã ngừng phản hồi.
  • CRASH: tên phương thức có thể gây ra lỗi.
errorReportCount

string (int64 format)

Tổng số báo cáo lỗi trong vấn đề này (chỉ xem xét các lần xuất hiện phù hợp với bộ lọc và trong khoảng thời gian được yêu cầu).
distinctUsers

string (int64 format)

Số lượng người dùng riêng biệt ước tính đã gặp phải vấn đề này (chỉ xem xét các lần xuất hiện phù hợp với bộ lọc và trong khoảng thời gian được yêu cầu).
distinctUsersPercent

object (Decimal)

Tỷ lệ phần trăm ước tính của người dùng bị ảnh hưởng bởi bất kỳ vấn đề nào bị ảnh hưởng bởi vấn đề này (chỉ xem xét các lần xuất hiện phù hợp với bộ lọc và trong khoảng thời gian được yêu cầu).
lastErrorReportTime

string (Timestamp format)

Thời điểm bắt đầu giờ mà báo cáo lỗi gần đây nhất trong vấn đề này xảy ra.

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
issueUri

string

Đường liên kết đến vấn đề trong Android vitals trong Play Console.
firstOsVersion

object (OsVersion)

Phiên bản hệ điều hành nhỏ nhất mà cụm lỗi này đã xảy ra trong khoảng thời gian được yêu cầu (chỉ xem xét các lần xuất hiện phù hợp với bộ lọc và trong khoảng thời gian được yêu cầu).
lastOsVersion

object (OsVersion)

Phiên bản hệ điều hành mới nhất mà cụm lỗi này đã xảy ra trong khoảng thời gian được yêu cầu (chỉ xem xét các lần xuất hiện phù hợp với bộ lọc và trong khoảng thời gian được yêu cầu).
firstAppVersion

object (AppVersion)

Phiên bản ứng dụng sớm nhất (bao gồm) xuất hiện trong ErrorIssue này trong khoảng thời gian được yêu cầu (chỉ xem xét các lần xuất hiện phù hợp với bộ lọc).
lastAppVersion

object (AppVersion)

Phiên bản ứng dụng mới nhất (bao gồm) xuất hiện trong ErrorIssue này trong khoảng thời gian được yêu cầu (chỉ xem xét các lần xuất hiện phù hợp với bộ lọc).
annotations[]

object (IssueAnnotation)

Danh sách chú thích cho một vấn đề. Chú thích cung cấp thông tin bổ sung có thể giúp chẩn đoán và khắc phục vấn đề.
sampleErrorReports[]

string

Chỉ có đầu ra. Báo cáo lỗi mẫu thuộc về ErrorIssue này. Lưu ý: hiện tại, hệ thống hỗ trợ tối đa 1 báo cáo lỗi mẫu cho mỗi ErrorIssue. Định dạng: "apps/{app}/{report}"

IssueAnnotation

Biểu diễn thông báo chú thích cho một vấn đề.

Biểu diễn dưới dạng JSON 
{
  "category": string,
  "title": string,
  "body": string
}
Trường
category

string

Danh mục mà chú thích thuộc về. Một chú thích sẽ thuộc về một danh mục. Danh mục ví dụ: "Potential fix" (Giải pháp tiềm năng), "Insight" (Thông tin chi tiết).
title

string

Tiêu đề cho chú thích.
body

string

Chứa nội dung của thông báo chú thích.

Phương thức
Tìm kiếm tất cả các vấn đề về lỗi mà báo cáo đã được nhóm.