REST Resource: vitals.stuckbackgroundwakelockrate

資源：StuckBackgroundWakelockRateMetricSet

代表 Stuck Background Wakelocks 指標組合的單例資源。

這個指標集包含 PowerManager 喚醒鎖定持續時間資料和程序狀態資料，以產生與使用者人數無關的正規化指標。

支援的匯總週期：

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

支援的指標：

  • stuckBgWakelockRate (google.type.Decimal)：匯總期間在 Wake Lock 持續時間超過 1 小時的不重複使用者百分比。
  • stuckBgWakelockRate7dUserWeighted (google.type.Decimal)：過去 7 天內的stuckBgWakelockRate平均累計值。每日值是以當日不重複使用者人數為依據進行加權計算。
  • stuckBgWakelockRate28dUserWeighted (google.type.Decimal)：過去 28 天內的stuckBgWakelockRate平均累計值。每日值是以當日不重複使用者人數為依據進行加權計算。
  • distinctUsers (google.type.Decimal)：匯總期間不重複使用者數 (做為 stuckBgWakelockRate 指標的正規化值)。若使用者在裝置上執行任何作業，也就是不只在前景使用前景，也適用於背景作業，則這項指標會計入這項指標。請小心不要匯總計算，以免造成使用者重複計算。這個值會四捨五入至最接近的 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。

必要權限：呼叫者需要該應用程式的查看應用程式資訊 (唯讀) 權限，才能存取這項資源。

JSON 表示法 
{
  "name": string,
  "freshnessInfo": {
    object (FreshnessInfo)
  }
}
欄位
name

string

資源名稱。

格式：apps/{app}/stuckBackgroundWakelockRateMetricSet
freshnessInfo

object (FreshnessInfo)

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

方法

get

 說明指標集的屬性。

query

 查詢指標組合中的指標。