1<html><body> 2<style> 3 4body, h1, h2, h3, div, span, p, pre, a { 5 margin: 0; 6 padding: 0; 7 border: 0; 8 font-weight: inherit; 9 font-style: inherit; 10 font-size: 100%; 11 font-family: inherit; 12 vertical-align: baseline; 13} 14 15body { 16 font-size: 13px; 17 padding: 1em; 18} 19 20h1 { 21 font-size: 26px; 22 margin-bottom: 1em; 23} 24 25h2 { 26 font-size: 24px; 27 margin-bottom: 1em; 28} 29 30h3 { 31 font-size: 20px; 32 margin-bottom: 1em; 33 margin-top: 1em; 34} 35 36pre, code { 37 line-height: 1.5; 38 font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace; 39} 40 41pre { 42 margin-top: 0.5em; 43} 44 45h1, h2, h3, p { 46 font-family: Arial, sans serif; 47} 48 49h1, h2, h3 { 50 border-bottom: solid #CCC 1px; 51} 52 53.toc_element { 54 margin-top: 0.5em; 55} 56 57.firstline { 58 margin-left: 2 em; 59} 60 61.method { 62 margin-top: 1em; 63 border: solid 1px #CCC; 64 padding: 1em; 65 background: #EEE; 66} 67 68.details { 69 font-weight: bold; 70 font-size: 14px; 71} 72 73</style> 74 75<h1><a href="toolresults_v1beta3.html">Cloud Tool Results API</a> . <a href="toolresults_v1beta3.projects.html">projects</a> . <a href="toolresults_v1beta3.projects.histories.html">histories</a> . <a href="toolresults_v1beta3.projects.histories.executions.html">executions</a> . <a href="toolresults_v1beta3.projects.histories.executions.steps.html">steps</a> . <a href="toolresults_v1beta3.projects.histories.executions.steps.perfMetricsSummary.html">perfMetricsSummary</a></h1> 76<h2>Instance Methods</h2> 77<p class="toc_element"> 78 <code><a href="#close">close()</a></code></p> 79<p class="firstline">Close httplib2 connections.</p> 80<p class="toc_element"> 81 <code><a href="#create">create(projectId, historyId, executionId, stepId, body=None, x__xgafv=None)</a></code></p> 82<p class="firstline">Creates a PerfMetricsSummary resource. Returns the existing one if it has already been created. May return any of the following error code(s): - NOT_FOUND - The containing Step does not exist</p> 83<h3>Method Details</h3> 84<div class="method"> 85 <code class="details" id="close">close()</code> 86 <pre>Close httplib2 connections.</pre> 87</div> 88 89<div class="method"> 90 <code class="details" id="create">create(projectId, historyId, executionId, stepId, body=None, x__xgafv=None)</code> 91 <pre>Creates a PerfMetricsSummary resource. Returns the existing one if it has already been created. May return any of the following error code(s): - NOT_FOUND - The containing Step does not exist 92 93Args: 94 projectId: string, The cloud project (required) 95 historyId: string, A tool results history ID. (required) 96 executionId: string, A tool results execution ID. (required) 97 stepId: string, A tool results step ID. (required) 98 body: object, The request body. 99 The object takes the form of: 100 101{ # A summary of perf metrics collected and performance environment info 102 "appStartTime": { 103 "fullyDrawnTime": { # A Duration represents a signed, fixed-length span of time represented as a count of seconds and fractions of seconds at nanosecond resolution. It is independent of any calendar and concepts like "day" or "month". It is related to Timestamp in that the difference between two Timestamp values is a Duration and it can be added or subtracted from a Timestamp. Range is approximately +-10,000 years. # Optional. The time from app start to reaching the developer-reported "fully drawn" time. This is only stored if the app includes a call to Activity.reportFullyDrawn(). See https://developer.android.com/topic/performance/launch-time.html#time-full 104 "nanos": 42, # Signed fractions of a second at nanosecond resolution of the span of time. Durations less than one second are represented with a 0 `seconds` field and a positive or negative `nanos` field. For durations of one second or more, a non-zero value for the `nanos` field must be of the same sign as the `seconds` field. Must be from -999,999,999 to +999,999,999 inclusive. 105 "seconds": "A String", # Signed seconds of the span of time. Must be from -315,576,000,000 to +315,576,000,000 inclusive. Note: these bounds are computed from: 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years 106 }, 107 "initialDisplayTime": { # A Duration represents a signed, fixed-length span of time represented as a count of seconds and fractions of seconds at nanosecond resolution. It is independent of any calendar and concepts like "day" or "month". It is related to Timestamp in that the difference between two Timestamp values is a Duration and it can be added or subtracted from a Timestamp. Range is approximately +-10,000 years. # The time from app start to the first displayed activity being drawn, as reported in Logcat. See https://developer.android.com/topic/performance/launch-time.html#time-initial 108 "nanos": 42, # Signed fractions of a second at nanosecond resolution of the span of time. Durations less than one second are represented with a 0 `seconds` field and a positive or negative `nanos` field. For durations of one second or more, a non-zero value for the `nanos` field must be of the same sign as the `seconds` field. Must be from -999,999,999 to +999,999,999 inclusive. 109 "seconds": "A String", # Signed seconds of the span of time. Must be from -315,576,000,000 to +315,576,000,000 inclusive. Note: these bounds are computed from: 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years 110 }, 111 }, 112 "executionId": "A String", # A tool results execution ID. @OutputOnly 113 "graphicsStats": { # Graphics statistics for the App. The information is collected from 'adb shell dumpsys graphicsstats'. For more info see: https://developer.android.com/training/testing/performance.html Statistics will only be present for API 23+. # Graphics statistics for the entire run. Statistics are reset at the beginning of the run and collected at the end of the run. 114 "buckets": [ # Histogram of frame render times. There should be 154 buckets ranging from [5ms, 6ms) to [4950ms, infinity) 115 { 116 "frameCount": "A String", # Number of frames in the bucket. 117 "renderMillis": "A String", # Lower bound of render time in milliseconds. 118 }, 119 ], 120 "highInputLatencyCount": "A String", # Total "high input latency" events. 121 "jankyFrames": "A String", # Total frames with slow render time. Should be <= total_frames. 122 "missedVsyncCount": "A String", # Total "missed vsync" events. 123 "p50Millis": "A String", # 50th percentile frame render time in milliseconds. 124 "p90Millis": "A String", # 90th percentile frame render time in milliseconds. 125 "p95Millis": "A String", # 95th percentile frame render time in milliseconds. 126 "p99Millis": "A String", # 99th percentile frame render time in milliseconds. 127 "slowBitmapUploadCount": "A String", # Total "slow bitmap upload" events. 128 "slowDrawCount": "A String", # Total "slow draw" events. 129 "slowUiThreadCount": "A String", # Total "slow UI thread" events. 130 "totalFrames": "A String", # Total frames rendered by package. 131 }, 132 "historyId": "A String", # A tool results history ID. @OutputOnly 133 "perfEnvironment": { # Encapsulates performance environment info # Describes the environment in which the performance metrics were collected 134 "cpuInfo": { # CPU related environment info 135 "cpuProcessor": "A String", # description of the device processor ie '1.8 GHz hexa core 64-bit ARMv8-A' 136 "cpuSpeedInGhz": 3.14, # the CPU clock speed in GHz 137 "numberOfCores": 42, # the number of CPU cores 138 }, 139 "memoryInfo": { # Memory related environment info 140 "memoryCapInKibibyte": "A String", # Maximum memory that can be allocated to the process in KiB 141 "memoryTotalInKibibyte": "A String", # Total memory available on the device in KiB 142 }, 143 }, 144 "perfMetrics": [ # Set of resource collected 145 "A String", 146 ], 147 "projectId": "A String", # The cloud project @OutputOnly 148 "stepId": "A String", # A tool results step ID. @OutputOnly 149} 150 151 x__xgafv: string, V1 error format. 152 Allowed values 153 1 - v1 error format 154 2 - v2 error format 155 156Returns: 157 An object of the form: 158 159 { # A summary of perf metrics collected and performance environment info 160 "appStartTime": { 161 "fullyDrawnTime": { # A Duration represents a signed, fixed-length span of time represented as a count of seconds and fractions of seconds at nanosecond resolution. It is independent of any calendar and concepts like "day" or "month". It is related to Timestamp in that the difference between two Timestamp values is a Duration and it can be added or subtracted from a Timestamp. Range is approximately +-10,000 years. # Optional. The time from app start to reaching the developer-reported "fully drawn" time. This is only stored if the app includes a call to Activity.reportFullyDrawn(). See https://developer.android.com/topic/performance/launch-time.html#time-full 162 "nanos": 42, # Signed fractions of a second at nanosecond resolution of the span of time. Durations less than one second are represented with a 0 `seconds` field and a positive or negative `nanos` field. For durations of one second or more, a non-zero value for the `nanos` field must be of the same sign as the `seconds` field. Must be from -999,999,999 to +999,999,999 inclusive. 163 "seconds": "A String", # Signed seconds of the span of time. Must be from -315,576,000,000 to +315,576,000,000 inclusive. Note: these bounds are computed from: 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years 164 }, 165 "initialDisplayTime": { # A Duration represents a signed, fixed-length span of time represented as a count of seconds and fractions of seconds at nanosecond resolution. It is independent of any calendar and concepts like "day" or "month". It is related to Timestamp in that the difference between two Timestamp values is a Duration and it can be added or subtracted from a Timestamp. Range is approximately +-10,000 years. # The time from app start to the first displayed activity being drawn, as reported in Logcat. See https://developer.android.com/topic/performance/launch-time.html#time-initial 166 "nanos": 42, # Signed fractions of a second at nanosecond resolution of the span of time. Durations less than one second are represented with a 0 `seconds` field and a positive or negative `nanos` field. For durations of one second or more, a non-zero value for the `nanos` field must be of the same sign as the `seconds` field. Must be from -999,999,999 to +999,999,999 inclusive. 167 "seconds": "A String", # Signed seconds of the span of time. Must be from -315,576,000,000 to +315,576,000,000 inclusive. Note: these bounds are computed from: 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years 168 }, 169 }, 170 "executionId": "A String", # A tool results execution ID. @OutputOnly 171 "graphicsStats": { # Graphics statistics for the App. The information is collected from 'adb shell dumpsys graphicsstats'. For more info see: https://developer.android.com/training/testing/performance.html Statistics will only be present for API 23+. # Graphics statistics for the entire run. Statistics are reset at the beginning of the run and collected at the end of the run. 172 "buckets": [ # Histogram of frame render times. There should be 154 buckets ranging from [5ms, 6ms) to [4950ms, infinity) 173 { 174 "frameCount": "A String", # Number of frames in the bucket. 175 "renderMillis": "A String", # Lower bound of render time in milliseconds. 176 }, 177 ], 178 "highInputLatencyCount": "A String", # Total "high input latency" events. 179 "jankyFrames": "A String", # Total frames with slow render time. Should be <= total_frames. 180 "missedVsyncCount": "A String", # Total "missed vsync" events. 181 "p50Millis": "A String", # 50th percentile frame render time in milliseconds. 182 "p90Millis": "A String", # 90th percentile frame render time in milliseconds. 183 "p95Millis": "A String", # 95th percentile frame render time in milliseconds. 184 "p99Millis": "A String", # 99th percentile frame render time in milliseconds. 185 "slowBitmapUploadCount": "A String", # Total "slow bitmap upload" events. 186 "slowDrawCount": "A String", # Total "slow draw" events. 187 "slowUiThreadCount": "A String", # Total "slow UI thread" events. 188 "totalFrames": "A String", # Total frames rendered by package. 189 }, 190 "historyId": "A String", # A tool results history ID. @OutputOnly 191 "perfEnvironment": { # Encapsulates performance environment info # Describes the environment in which the performance metrics were collected 192 "cpuInfo": { # CPU related environment info 193 "cpuProcessor": "A String", # description of the device processor ie '1.8 GHz hexa core 64-bit ARMv8-A' 194 "cpuSpeedInGhz": 3.14, # the CPU clock speed in GHz 195 "numberOfCores": 42, # the number of CPU cores 196 }, 197 "memoryInfo": { # Memory related environment info 198 "memoryCapInKibibyte": "A String", # Maximum memory that can be allocated to the process in KiB 199 "memoryTotalInKibibyte": "A String", # Total memory available on the device in KiB 200 }, 201 }, 202 "perfMetrics": [ # Set of resource collected 203 "A String", 204 ], 205 "projectId": "A String", # The cloud project @OutputOnly 206 "stepId": "A String", # A tool results step ID. @OutputOnly 207}</pre> 208</div> 209 210</body></html>