REST Resource: vitals.crashrate

資源:CrashRateMetricSet

代表當機率指標集的單例資源。

這組指標包含當機資料和使用資料,可產生與使用者人數無關的正規化指標。

支援的匯總期間:

  • DAILY:指標會以日曆日期間隔匯總。由於歷史限制,目前僅支援 America/Los_Angeles 時區。
  • HOURLY:指標會以每小時為間隔匯總。預設時區為 UTC,且僅支援此時區。

支援的指標:

  • crashRate (google.type.Decimal):匯總期間內,至少發生一次當機的獨立使用者百分比。
  • crashRate7dUserWeighted (google.type.Decimal):過去 7 天的crashRate累計平均值。每日值會根據當天的不重複使用者人數加權計算。不支援「每小時」細分。
  • crashRate28dUserWeighted (google.type.Decimal):過去 28 天的crashRate累計平均值。每日值會根據當天的不重複使用者人數加權計算。不支援「每小時」細分。
  • userPerceivedCrashRate (google.type.Decimal):在彙整期間,主動使用應用程式時至少發生一次使用者感知當機事件的獨立使用者百分比。如果應用程式顯示任何活動或執行任何前景服務,系統會將應用程式視為處於主動使用狀態。
  • userPerceivedCrashRate7dUserWeighted (google.type.Decimal):過去 7 天的userPerceivedCrashRate累計平均值。每日值會根據當天的不重複使用者人數加權計算。不支援「每小時」細分。
  • userPerceivedCrashRate28dUserWeighted (google.type.Decimal):過去 28 天的userPerceivedCrashRate累計平均值。每日值會根據當天的不重複使用者人數加權計算。不支援「每小時」細分。
  • distinctUsers (google.type.Decimal):匯總期間內的不重複使用者人數,用來做為 crashRateuserPerceivedCrashRate 指標的正規化值。如果使用者在匯總期間積極使用應用程式,系統就會將他們計入這項指標。如果應用程式顯示任何活動或執行任何前景服務,系統會將應用程式視為處於主動使用狀態。請務必不要進一步匯總這項計數,否則可能會重複計算使用者。系統會根據值的大小,將值四捨五入至最接近的 10、100、1,000 或 1,000,000 倍數。

支援的尺寸:

  • apiLevel (string):使用者裝置上執行的 Android API 級別,例如 26。
  • versionCode (int64):使用者裝置上執行的應用程式版本。
  • deviceModel (string):使用者裝置型號的專屬 ID。識別碼格式為「deviceBrand/device」,其中 deviceBrand 對應於 Build.BRAND,device 對應於 Build.DEVICE,例如「google/coral」。
  • deviceBrand (string):使用者裝置品牌的專屬 ID,例如 google。
  • deviceType (string):使用者裝置的類型 (也稱為板型規格),例如 PHONE。
  • countryCode (string):使用者裝置的國家/地區,以 IP 位址為準,並以 2 個字母的 ISO-3166 代碼表示 (例如美國為「US」)。
  • deviceRamBucket (int64):裝置的 RAM,以 MB 為單位,並以區間表示 (例如 1024 代表 1 到 1.5 GB,4096 代表 4 到 6 GB)。
  • deviceSocMake (string):裝置主要系統單晶片的製造商,例如 Samsung。參考資料
  • deviceSocModel (string):裝置主要系統單晶片的型號,例如「Exynos 2100」。參考資料
  • deviceCpuMake (string):裝置 CPU 的製造商,例如 Qualcomm。
  • deviceCpuModel (string):裝置 CPU 的型號,例如「Kryo 240」。
  • deviceGpuMake (string):裝置 GPU 的製造商,例如 ARM。
  • deviceGpuModel (string):裝置的 GPU 型號,例如 Mali。
  • deviceGpuVersion (string):裝置 GPU 的版本,例如 T750。
  • deviceVulkanVersion (string):裝置的 Vulkan 版本,例如「4198400」。
  • deviceGlEsVersion (string):裝置的 OpenGL ES 版本,例如「196610」。
  • deviceScreenSize (string):裝置的螢幕大小,例如 NORMAL、LARGE。
  • deviceScreenDpi (string):裝置的螢幕密度,例如 mdpi、hdpi。

必要權限:如要存取這項資源,呼叫使用者必須具備應用程式的「查看應用程式資訊 (唯讀)」權限。

相關指標組合:

  • vitals.errors 包含未標準化的當機版本 (絕對計數)。
  • vitals.errors 包含有關 ANR 的正規化指標,這是另一個穩定性指標。
JSON 表示法
{
  "name": string,
  "freshnessInfo": {
    object (FreshnessInfo)
  }
}
欄位
name

string

ID。資源名稱。

格式:apps/{app}/crashRateMetricSet

freshnessInfo

object (FreshnessInfo)

這項資源的資料更新間隔摘要。

方法

get

說明指標集的屬性。

query

查詢指標集中的指標。