REST Resource: vitals.crashrate

Tài nguyên: CrashRateMetricSet

Tài nguyên đơn lẻ đại diện cho tập hợp các chỉ số về tỷ lệ gặp sự cố.

Tập hợp chỉ số này chứa dữ liệu về sự cố kết hợp với dữ liệu sử dụng để tạo ra một chỉ số chuẩn hoá độ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: các chỉ số được tổng hợp theo khoảng thời gian ngày dương lịch. Do các hạn chế trước đây, múi giờ duy nhất được hỗ trợ là America/Los_Angeles.
  • HOURLY: các chỉ số được tổng hợp theo khoảng thời gian tính theo 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 số người dùng riêng biệt gặp phải ít nhất một sự cố trong khoảng thời gian tổng hợp.
  • crashRate7dUserWeighted (google.type.Decimal): Giá trị trung bình luân phiên của crashRate trong 7 ngày qua. Các giá trị hằng ngày được tính theo số lượng người dùng riêng biệt trong ngày. Không được hỗ trợ ở độ chi tiết HÀNG GIỜ.
  • crashRate28dUserWeighted (google.type.Decimal): Giá trị trung bình luân phiên của crashRate trong 28 ngày qua. Các giá trị hằng ngày được tính theo số lượng người dùng riêng biệt trong ngày. Không được hỗ trợ ở độ chi tiết HÀNG GIỜ.
  • userPerceivedCrashRate (google.type.Decimal): Tỷ lệ phần trăm số 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ố khi họ chủ động dùng ứng dụng của bạn (một sự cố mà người dùng nhận thấy). Một ứng dụng được coi là đang có người sử dụng nếu ứng dụng đó hiển thị hoạt động bất kỳ hoặc thực thi dịch vụ trên nền trước bất kỳ.
  • userPerceivedCrashRate7dUserWeighted (google.type.Decimal): Giá trị trung bình luân phiên của userPerceivedCrashRate trong 7 ngày qua. Các giá trị hằng ngày được tính theo số lượng người dùng riêng biệt trong ngày. Không được hỗ trợ ở độ chi tiết HÀNG GIỜ.
  • userPerceivedCrashRate28dUserWeighted (google.type.Decimal): Giá trị trung bình luân phiên của userPerceivedCrashRate trong 28 ngày qua. Các giá trị hằng ngày được tính theo số lượng người dùng riêng biệt trong ngày. Không được hỗ trợ ở độ chi tiết HÀNG GIỜ.
  • distinctUsers (google.type.Decimal): Số lượng người dùng riêng biệt trong khoảng thời gian tổng hợp được dùng làm giá trị chuẩn hoá cho các chỉ số crashRate và userPerceivedCrashRate. Người dùng được tính vào chỉ số này nếu họ tích cực sử dụng ứng dụng trong khoảng thời gian tổng hợp. Một ứng dụng được coi là đang có người sử dụng nếu ứng dụng đó hiển thị hoạt động bất kỳ hoặc thực thi dịch vụ trên nền trước bất kỳ. Bạn phải cẩn thận để không tổng hợp thêm số lượt này, vì điều đó 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, tuỳ thuộc vào độ lớn của giá trị.

Các phương diệ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 đang 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ị mà người dùng sử dụng. Mã nhận dạng có dạng "deviceBrand/device", trong đó deviceBrand tương ứng với Build.BRAND và device 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 gọi là kiểu dáng) 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 của thiết bị mà người dùng đang sử dụng dựa trên địa chỉ IP của họ, được biểu thị dưới dạng mã ISO-3166 gồm 2 chữ cái (ví dụ: US cho Hoa Kỳ).
  • deviceRamBucket (int64): RAM của thiết bị, tính bằng MB, theo nhóm (3 GB, 4 GB, v.v.).
  • deviceSocMake (string): Thương hiệu của hệ thống trên vi mạch chính của thiết bị, ví dụ: Samsung. Tài liệu tham khảo
  • deviceSocModel (string): Mẫu hệ thống trên vi mạch chính của thiết bị, ví dụ: "Exynos 2100". Tài liệu tham khảo
  • deviceCpuMake (string): Thương hiệu CPU của thiết bị, ví dụ: Qualcomm.
  • deviceCpuModel (string): Mẫu CPU của thiết bị, ví dụ: "Kryo 240".
  • deviceGpuMake (string): Nhà sản xuất GPU của thiết bị, ví dụ: ARM.
  • deviceGpuModel (string): Mô hình 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 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.

Các nhóm chỉ số liên quan:

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

string

Giá trị nhận dạng. Tên tài nguyên.

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

object (FreshnessInfo)

Thông tin 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 bộ chỉ số.

query

 Truy vấn các chỉ số trong tập hợp chỉ số.