REST Resource: vitals.errors.issues

Tài nguyên: ErrorIssue

Một nhóm các 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 với nhau thành các vấn đề có cùng một 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. Điều này cũng có thể khiến một số vấn đề hoàn toàn biến mất và được thay thế bằng những 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

Giá trị 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, đây có thể là:

  • APPLICATION_NOT_RESPONDING: loại lỗi ANR đã xảy ra, ví dụ: "Hết thời gian chờ truyền dữ liệu đầu vào".
  • CRASH: đối với lỗi ngoại lệ chưa 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 tăng lên, ví dụ: SIGSEGV.
location

string

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

Tuỳ thuộc vào loại, đây 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ó khả năng 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 những lần xuất hiện khớp với bộ lọc và trong khoảng thời gian được yêu cầu).

distinctUsers

string (int64 format)

Số người dùng riêng biệt ước tính gặp phải vấn đề này (chỉ xem xét những 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 số người dùng bị ảnh hưởng bởi vấn đề này trong số những người dùng bị ảnh hưởng bởi bất kỳ vấn đề nào (chỉ xem xét những 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.

Sử dụng RFC 3339, trong đó đầ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 độ 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 trên 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 những 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 những 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 những lần xuất hiện khớ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 những lần xuất hiện khớ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êm thông tin 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 ErrorIssue này. Lưu ý: hiện tại, mỗi ErrorIssue chỉ hỗ trợ tối đa 1. Định dạng: "apps/{app}/{report}"

IssueAnnotation

Hình minh hoạ 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 chứa chú thích. Mỗi chú thích sẽ thuộc về một danh mục. Ví dụ về các danh mục: "Giải pháp tiềm năng", "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.