REST Resource: vitals.crashrate

Tài nguyên: CrashRateMetricSet

Tài nguyên Singleton, đại diện cho tập hợp các chỉ số tỷ lệ sự cố.

Bộ chỉ số này chứa dữ liệu sự cố được kết hợp với dữ liệu sử dụng để tạo ra chỉ số chuẩn hóa độc lập với số lượng người dùng.

Khoảng thời gian tổng hợp được hỗ trợ:

  • DAILY: chỉ số được tổng hợp trong khoảng thời gian theo lịch. Do những ràng buộc trước đây, múi giờ duy nhất được hỗ trợ là America/Los_Angeles.
  • HOURLY: chỉ số được tổng hợp theo khoảng thời gian hằng giờ. Múi giờ mặc định và duy nhất được hỗ trợ là UTC.

Các chỉ số được hỗ trợ:

  • crashRate (google.type.Decimal): Tỷ lệ phần trăm người dùng riêng biệt trong khoảng thời gian tổng hợp đã gặp phải ít nhất một sự cố.
  • crashRate7dUserWeighted (google.type.Decimal): Giá trị trung bình luân phiên của crashRate trong 7 ngày qua. Giá trị hàng ngày được tính trọng số theo số lượng người dùng riêng biệt cho ngày đó. Không được hỗ trợ chi tiết HOURLY.
  • crashRate28dUserWeighted (google.type.Decimal): Giá trị trung bình luân phiên của crashRate trong 28 ngày qua. Giá trị hàng ngày được tính trọng số theo số lượng người dùng riêng biệt cho ngày đó. Không được hỗ trợ chi tiết HOURLY.
  • userPerceivedCrashRate (google.type.Decimal): Tỷ lệ phần trăm người dùng riêng biệt trong giai đoạn tổng hợp gặp phải ít nhất một sự cố khi họ sử dụng ứng dụng của bạn (một sự cố mà người dùng nhận thấy). Ứng dụng được coi là đang được sử dụng nếu đang hiển thị bất kỳ hoạt động nào hoặc thực thi bất kỳ dịch vụ trên nền trước nào.
  • userPerceivedCrashRate7dUserWeighted (google.type.Decimal): Giá trị trung bình luân phiên của userPerceivedCrashRate trong 7 ngày qua. Giá trị hàng ngày được tính trọng số theo số lượng người dùng riêng biệt cho ngày đó. Không được hỗ trợ chi tiết HOURLY.
  • userPerceivedCrashRate28dUserWeighted (google.type.Decimal): Giá trị trung bình luân phiên của userPerceivedCrashRate trong 28 ngày qua. Giá trị hàng ngày được tính trọng số theo số lượng người dùng riêng biệt cho ngày đó. Không được hỗ trợ chi tiết HOURLY.
  • distinctUsers (google.type.Decimal): Số lượng người dùng riêng biệt trong giai đoạn tổng hợp được dùng làm giá trị chuẩn hóa cho các chỉ số crashRate và userPerceivedCrashRate. Người dùng được tính trong chỉ số này nếu họ đã sử dụng ứng dụng một cách chủ động trong giai đoạn tổng hợp. Ứng dụng được coi là đang được sử dụng nếu đang hiển thị bất kỳ hoạt động nào hoặc thực thi bất kỳ dịch vụ trên nền trước nào. Bạn phải cẩn thận khi tổng hợp số lượng này nhiều hơn, vì điều này có thể khiến người dùng được tính nhiều lần. Giá trị được làm tròn đến bội số gần nhất của 10, 100, 1.000 hoặc 1.000.000, tùy thuộc vào độ lớn của giá trị.

Các thứ nguyên được hỗ trợ:

  • apiLevel (string): cấp độ API của Android đang chạy trên thiết bị của người dùng, ví dụ: 26.
  • versionCode (int64): phiên bản ứng dụng đã chạy trên thiết bị của người dùng.
  • deviceModel (string): giá trị nhận dạng duy nhất của mẫu thiết bị của người dùng. Dạng của mã nhận dạng là 'deviceBrand/device', trong đó deviceBrand tương ứng với Build.BRAND và thiết bị tương ứng với Build.DEVICE, ví dụ: google/coral.
  • deviceBrand (string): giá trị nhận dạng duy nhất của thương hiệu thiết bị của người dùng, ví dụ: google.
  • deviceType (string): loại (còn được gọi là hệ số hình dạng) của thiết bị của người dùng, ví dụ: ĐIỆN THOẠI.
  • countryCode (string): quốc gia hoặc khu vực trên thiết bị của người dùng dựa trên địa chỉ IP của họ, được thể hiện dưới dạng mã ISO-3166 gồm 2 chữ cái (ví dụ: Hoa Kỳ).
  • deviceRamBucket (int64): RAM của thiết bị, tính bằng MB, theo bộ chứa (3GB, 4GB, v.v.).
  • deviceSocMake (string): Cấu hình hệ thống trên chip chính của thiết bị, ví dụ: Samsung. Thông tin tham khảo
  • deviceSocModel (string): Mô hình hệ thống trên chip chính của thiết bị, ví dụ: "Exynos 2100". Thông tin tham khảo
  • deviceCpuMake (string): Cấu hình CPU của thiết bị, ví dụ: Qualcomm.
  • deviceCpuModel (string): Kiểu CPU của thiết bị, ví dụ: "Kryo 240").
  • deviceGpuMake (string): Cấu hình GPU của thiết bị, ví dụ: Hàm ARM.
  • deviceGpuModel (string): Mẫu GPU của thiết bị, ví dụ: Mali.
  • deviceGpuVersion (string): Phiên bản GPU của thiết bị, ví dụ: T750.
  • deviceVulkanVersion (string): Phiên bản Vulkan của thiết bị, ví dụ: "4198400".
  • deviceGlEsVersion (string): Phiên bản OpenGL ES của thiết bị, ví dụ: "196610".
  • deviceScreenSize (string): Kích thước màn hình của thiết bị, ví dụ: BÌNH THƯỜNG, LỚN.
  • deviceScreenDpi (string): Mật độ màn hình của thiết bị, ví dụ: mdpi, hdpi.

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

Các bộ chỉ số có liên quan:

  • vitals.errors chứa phiên bản không chuẩn hóa (số lượng tuyệt đối) của sự cố.
  • vitals.errors chứa các chỉ số chuẩn hoá về ANR, một chỉ số ổn định khác.
Biểu diễn dưới dạng JSON 
{
  "name": string,
  "freshnessInfo": {
    object (FreshnessInfo)
  }
}
Các trường
name

string

Tên tài nguyên.

Định dạng: apps/{app}/crashRateMetricSet
freshnessInfo

object (FreshnessInfo)

Tóm tắt về độ mới của dữ liệu trong tài nguyên này.

Phương thức

get

 Mô tả các thuộc tính của tập hợp chỉ số.

query

 Truy vấn các chỉ số trong nhóm chỉ số.