REST Resource: vitals.crashrate

資源：CrashRateMetricSet

代表當機指標組合的單例資源。

這個指標集包含當機資料與使用資料，以產生正規化的使用者人數，而不會影響使用者人數。

支援的匯總週期：

  • DAILY：指標按照日曆日期間隔匯總。基於歷來限制，目前唯一支援的時區為 America/Los_Angeles。
  • HOURLY：以每小時間隔匯總指標。預設和唯一支援的時區為 UTC。

支援的指標：

  • crashRate (google.type.Decimal)：匯總資料中至少有一次當機的不重複使用者百分比。
  • crashRate7dUserWeighted (google.type.Decimal)：過去 7 天內的crashRate平均累計值。每日值是以當日不重複使用者人數為依據進行加權計算。不支援 HOUR 精細程度。
  • crashRate28dUserWeighted (google.type.Decimal)：過去 28 天內的crashRate平均累計值。每日值是以當日不重複使用者人數為依據進行加權計算。不支援 HOUR 精細程度。
  • userPerceivedCrashRate (google.type.Decimal)：匯總資料中，在主動使用應用程式時遇到至少 1 次當機的不重複使用者人數百分比 (使用者感知的當機事件)。如果應用程式顯示任何活動或執行任何前景服務，系統會將應用程式視為處於主動使用狀態。
  • userPerceivedCrashRate7dUserWeighted (google.type.Decimal)：過去 7 天內的userPerceivedCrashRate平均累計值。每日值是以當日不重複使用者人數為依據進行加權計算。不支援 HOUR 精細程度。
  • userPerceivedCrashRate28dUserWeighted (google.type.Decimal)：過去 28 天內的userPerceivedCrashRate平均累計值。每日值是以當日不重複使用者人數為依據進行加權計算。不支援 HOUR 精細程度。
  • distinctUsers (google.type.Decimal)：在匯總期間，crashRate 和 userPerceivedCrashRate 指標正規化處理的不重複使用者人數數量。如果使用者在匯總期間內主動使用應用程式，系統就會計入這項指標。如果應用程式顯示任何活動或執行任何前景服務，系統會將應用程式視為處於主動使用狀態。請小心不要匯總計算，以免造成使用者重複計算。這個值會四捨五入至最接近的 10、100、1,000 或 1,000,000 倍數 (視這個值的規模而定)。

支援的維度：

  • apiLevel (string)：在使用者裝置上執行的 Android API 級別，例如26.
  • versionCode (int64)：在使用者裝置上執行的應用程式版本。
  • deviceModel (string)：使用者裝置型號的專屬 ID。ID 的格式為「deviceBrand/device」，其中 deviceBrand 與 Build.BRAND 對應，裝置則與 Build.DEVICE 對應，例如 google/coral。
  • deviceBrand (string)：使用者裝置品牌的專屬 ID，例如「google」。
  • deviceType (string)：使用者裝置的類型 (也稱為板型規格)，例如：手機。
  • countryCode (string)：根據使用者的裝置 IP 位址，所在的國家/地區表示，格式為 2 個字母的 ISO-3166 代碼 (例如美國代表 US)。
  • deviceRamBucket (int64)：裝置的 RAM (以 MB 為單位，單位為 3 GB、4 GB 等)。
  • deviceSocMake (string)：使用裝置的主要晶片系統 (例如：Samsung。參考資料
  • deviceSocModel (string)：裝置主要晶片系統的模型，例如：「Exynos 2100」。參考資料
  • deviceCpuMake (string)：裝置的 CPU 百分比，例如Qualcomm。
  • deviceCpuModel (string)：裝置的 CPU 型號，例如「Kryo 240」。
  • deviceGpuMake (string)：裝置的 GPU 組成，例如：ARM：
  • deviceGpuModel (string)：裝置的 GPU 型號，例如：馬利。
  • 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

資源名稱。

格式：apps/{app}/crashRateMetricSet
freshnessInfo

object (FreshnessInfo)

這項資源的資料更新頻率摘要。

方法

get

 說明指標集的屬性。

query

 查詢指標組合中的指標。