REST Resource: projects.histories.executions.steps.perfMetricsSummary

資源:PerfMetricsSummary

收集的成效指標和效能環境資訊的摘要

JSON 表示法
{
  "projectId": string,
  "historyId": string,
  "executionId": string,
  "stepId": string,
  "perfMetrics": [
    enum (PerfMetricType)
  ],
  "perfEnvironment": {
    object (PerfEnvironment)
  },
  "appStartTime": {
    object (AppStartTime)
  },
  "graphicsStats": {
    object (GraphicsStats)
  }
}
欄位
projectId

string

Cloud 專案

注意:這個欄位僅適用於回應,系統會忽略要求中指定的任何值。

historyId

string

工具結果記錄 ID。

注意:這個欄位僅適用於回應,系統會忽略要求中指定的任何值。

executionId

string

工具結果執行作業 ID。

注意:這個欄位僅適用於回應,系統會忽略要求中指定的任何值。

stepId

string

工具結果步驟 ID。

注意:這個欄位僅適用於回應,系統會忽略要求中指定的任何值。

perfMetrics[]

enum (PerfMetricType)

收集的資源組合

perfEnvironment

object (PerfEnvironment)

說明收集效能指標的環境

appStartTime

object (AppStartTime)

graphicsStats
(deprecated)

object (GraphicsStats)

整個執行作業的圖片統計資料。統計資料會在跑步開始時重設,並在跑步結束時收集。

PerfEnvironment

封裝效能環境資訊

JSON 表示法
{
  "cpuInfo": {
    object (CPUInfo)
  },
  "memoryInfo": {
    object (MemoryInfo)
  }
}
欄位
cpuInfo

object (CPUInfo)

CPU 相關環境資訊

memoryInfo

object (MemoryInfo)

記憶體相關環境資訊

CPUInfo

JSON 表示法
{
  "cpuProcessor": string,
  "cpuSpeedInGhz": number,
  "numberOfCores": integer
}
欄位
cpuProcessor

string

裝置處理器的說明,例如「1.8 GHz 十六進位核心 64 位元 ARMv8-A」

cpuSpeedInGhz

number

CPU 時脈速度 (以 GHz 為單位)

numberOfCores

integer

CPU 核心數量

MemoryInfo

JSON 表示法
{
  "memoryTotalInKibibyte": string,
  "memoryCapInKibibyte": string
}
欄位
memoryTotalInKibibyte

string (int64 format)

裝置可用的記憶體總量 (以 KiB 為單位)

memoryCapInKibibyte

string (int64 format)

可分配給 KiB 中程序的記憶體上限

AppStartTime

JSON 表示法
{
  "initialDisplayTime": {
    object (Duration)
  },
  "fullyDrawnTime": {
    object (Duration)
  }
}
欄位
initialDisplayTime

object (Duration)

從應用程式開始到首次顯示活動所需要的時間,如 Logcat 中回報。詳情請參閱 https://developer.android.com/topic/performance/launch-time.html#time-initial

fullyDrawnTime

object (Duration)

選用設定。應用程式開始到開發人員回報「完整繪製」所需的時間讓應用程式從可以最快做出回應的位置 回應使用者要求只有當應用程式包含對 Activity.reportFullyDrawn() 的呼叫時,系統才會儲存這項資訊。詳情請參閱 https://developer.android.com/topic/performance/launch-time.html#time-full

圖形統計資料

應用程式的圖片統計資料。資訊是從「adb shell dumpsysgraphicstats」收集而來。詳情請參閱:https://developer.android.com/training/testing/performance.html 只有 API 23 以上版本才會顯示統計資料。

JSON 表示法
{
  "totalFrames": string,
  "jankyFrames": string,
  "p50Millis": string,
  "p90Millis": string,
  "p95Millis": string,
  "p99Millis": string,
  "missedVsyncCount": string,
  "highInputLatencyCount": string,
  "slowUiThreadCount": string,
  "slowBitmapUploadCount": string,
  "slowDrawCount": string,
  "buckets": [
    {
      object (Bucket)
    }
  ]
}
欄位
totalFrames

string (int64 format)

套件轉譯的影格總數。

jankyFrames

string (int64 format)

轉譯時間緩慢的影格總數。應該小於 = totalFrames。

p50Millis

string (int64 format)

第 50 個百分位數的影格轉譯時間,以毫秒為單位。

p90Millis

string (int64 format)

第 90 個百分位數的影格轉譯時間,以毫秒為單位。

p95Millis

string (int64 format)

第 95 個百分位數的影格轉譯時間,以毫秒為單位。

p99Millis

string (int64 format)

第 99 個百分位數的影格轉譯時間,以毫秒為單位。

missedVsyncCount

string (int64 format)

「missed vsync」總數事件。

highInputLatencyCount

string (int64 format)

總「輸入延遲時間過長」事件。

slowUiThreadCount

string (int64 format)

「UI 執行緒速度緩慢」總數事件。

slowBitmapUploadCount

string (int64 format)

「點陣圖上傳速度緩慢」全部事件。

slowDrawCount

string (int64 format)

「減速」總量事件。

buckets[]

object (Bucket)

影格轉譯時間直方圖。應有 154 個區間,範圍從 [5 毫秒,6 毫秒] 到 [4950 毫秒,無限大]

值區

JSON 表示法
{
  "renderMillis": string,
  "frameCount": string
}
欄位
renderMillis

string (int64 format)

轉譯時間下限 (以毫秒為單位)。

frameCount

string (int64 format)

值區中的影格數量。

方法

create

建立 PerfMetricsSummary 資源。