OLD | NEW |
1 <!-- Copyright 2016 The Chromium Authors. All rights reserved. | 1 <!-- Copyright 2016 The Chromium Authors. All rights reserved. |
2 Use of this source code is governed by a BSD-style license that can be | 2 Use of this source code is governed by a BSD-style license that can be |
3 found in the LICENSE file. | 3 found in the LICENSE file. |
4 --> | 4 --> |
5 | 5 |
6 # HistogramSet JSON Format | 6 # HistogramSet JSON Format |
7 | 7 |
8 This document assumes familiarity with the concepts introduced in | 8 This document assumes familiarity with the concepts introduced in |
9 [how-to-write-metrics](/docs/how-to-write-metrics.md). | 9 [how-to-write-metrics](/docs/how-to-write-metrics.md). |
10 | 10 |
(...skipping 115 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
126 ## Diagnostics | 126 ## Diagnostics |
127 | 127 |
128 The only field that is required for all Diagnostics, `type`, must be one of | 128 The only field that is required for all Diagnostics, `type`, must be one of |
129 * `GenericSet` | 129 * `GenericSet` |
130 * `RelatedEventSet` | 130 * `RelatedEventSet` |
131 * `Breakdown` | 131 * `Breakdown` |
132 * `RelatedHistogramSet` | 132 * `RelatedHistogramSet` |
133 * `RelatedHistogramMap` | 133 * `RelatedHistogramMap` |
134 * `RelatedHistogramBreakdown` | 134 * `RelatedHistogramBreakdown` |
135 * `TelemetryInfo` | 135 * `TelemetryInfo` |
136 * `DeviceInfo` | |
137 * `RevisionInfo` | 136 * `RevisionInfo` |
138 * `BuildbotInfo` | 137 * `BuildbotInfo` |
139 * `Scalar` | 138 * `Scalar` |
140 | 139 |
141 If a Diagnostic is in the root array of the JSON, then it is shared, so it may b
e | 140 If a Diagnostic is in the root array of the JSON, then it is shared, so it may b
e |
142 referenced by multiple Histograms. Shared Diagnostics must contain a string | 141 referenced by multiple Histograms. Shared Diagnostics must contain a string |
143 field `guid` containing a UUID. | 142 field `guid` containing a UUID. |
144 | 143 |
145 If a Diagnostic is contained in a Histogram, then it must not have a `guid` | 144 If a Diagnostic is contained in a Histogram, then it must not have a `guid` |
146 field. | 145 field. |
(...skipping 20 matching lines...) Expand all Loading... |
167 | 166 |
168 * `chromiumCommitPosition`: optional integer | 167 * `chromiumCommitPosition`: optional integer |
169 * `v8CommitPosition`: optional integer | 168 * `v8CommitPosition`: optional integer |
170 * `chromium`: array of 1 or 2 strings | 169 * `chromium`: array of 1 or 2 strings |
171 * `v8`: array of 1 or 2 strings | 170 * `v8`: array of 1 or 2 strings |
172 * `catapult`: array of 1 or 2 strings | 171 * `catapult`: array of 1 or 2 strings |
173 * `angle`: array of 1 or 2 strings | 172 * `angle`: array of 1 or 2 strings |
174 * `skia`: array of 1 or 2 strings | 173 * `skia`: array of 1 or 2 strings |
175 * `webrtc`: array of 1 or 2 strings | 174 * `webrtc`: array of 1 or 2 strings |
176 | 175 |
177 ### DeviceInfo | |
178 | |
179 This tracks information about the device that was used to produce the Histogram | |
180 to allow users to compare or merge results across similar devices. | |
181 | |
182 * `chromeVersion`: string | |
183 * `osName`: one of | |
184 * `mac` | |
185 * `android` | |
186 * `linux` | |
187 * `chrome` | |
188 * `win` | |
189 * `osVersion`: string | |
190 * `arch`: not yet specified, but will contain bittiness (32-bit vs 64-bit) | |
191 * `gpuInfo`: not yet specified, but will contain information about the GPU | |
192 * `ram`: number of bytes of RAM | |
193 | |
194 ### BuildbotInfo | 176 ### BuildbotInfo |
195 | 177 |
196 This tracks buildbot parameters when the Histogram was produced to allow users | 178 This tracks buildbot parameters when the Histogram was produced to allow users |
197 to compare or merge results across similar bots. | 179 to compare or merge results across similar bots. |
198 | 180 |
199 * `displayMasterName`: string | 181 * `displayMasterName`: string |
200 * `displayBotName`: string | 182 * `displayBotName`: string |
201 * `buildbotMasterName`: string | 183 * `buildbotMasterName`: string |
202 * `buildbotName`: string | 184 * `buildbotName`: string |
203 * `buildNumber`: number | 185 * `buildNumber`: number |
(...skipping 50 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
254 | 236 |
255 * `events`: array of dictionaries containing `stableId`, `title`, `start`, | 237 * `events`: array of dictionaries containing `stableId`, `title`, `start`, |
256 `duration` fields of Events | 238 `duration` fields of Events |
257 | 239 |
258 ### DateRange | 240 ### DateRange |
259 | 241 |
260 This is a Range of Dates. | 242 This is a Range of Dates. |
261 | 243 |
262 * `min`: Unix timestamp in ms | 244 * `min`: Unix timestamp in ms |
263 * `max`: optional Unix timestamp in ms | 245 * `max`: optional Unix timestamp in ms |
OLD | NEW |