| 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 * `RevisionInfo` | |
| 137 * `BuildbotInfo` | 136 * `BuildbotInfo` |
| 138 * `Scalar` | 137 * `Scalar` |
| 139 | 138 |
| 140 If a Diagnostic is in the root array of the JSON, then it is shared, so it may b
e | 139 If a Diagnostic is in the root array of the JSON, then it is shared, so it may b
e |
| 141 referenced by multiple Histograms. Shared Diagnostics must contain a string | 140 referenced by multiple Histograms. Shared Diagnostics must contain a string |
| 142 field `guid` containing a UUID. | 141 field `guid` containing a UUID. |
| 143 | 142 |
| 144 If a Diagnostic is contained in a Histogram, then it must not have a `guid` | 143 If a Diagnostic is contained in a Histogram, then it must not have a `guid` |
| 145 field. | 144 field. |
| 146 | 145 |
| 147 The other fields of Diagnostic dictionaries depend on `type`. | 146 The other fields of Diagnostic dictionaries depend on `type`. |
| 148 | 147 |
| 149 ### TelemetryInfo | 148 ### TelemetryInfo |
| 150 | 149 |
| 151 This tracks telemetry parameters when the Histogram was produced to allow users | 150 This tracks telemetry parameters when the Histogram was produced to allow users |
| 152 to compare or merge results across similar telemetry story runs. | 151 to compare or merge results across similar telemetry story runs. |
| 153 | 152 |
| 154 * `benchmarkName`: string | 153 * `benchmarkName`: string |
| 155 * `benchmarkStartMs`: number of ms since unix epoch | 154 * `benchmarkStartMs`: number of ms since unix epoch |
| 156 * `label`: string | 155 * `label`: string |
| 157 * `legacyTIRLabel`: string | 156 * `legacyTIRLabel`: string |
| 158 * `storyDisplayName`: string | 157 * `storyDisplayName`: string |
| 159 * `storyGroupingKeys`: dictionary mapping from strings to strings | 158 * `storyGroupingKeys`: dictionary mapping from strings to strings |
| 160 * `storysetRepeatCounter`: number | 159 * `storysetRepeatCounter`: number |
| 161 | 160 |
| 162 ### RevisionInfo | |
| 163 | |
| 164 This tracks revisions of the software under test to allow users to compare or | |
| 165 merge results across revisions. | |
| 166 | |
| 167 * `chromiumCommitPosition`: optional integer | |
| 168 * `v8CommitPosition`: optional integer | |
| 169 * `chromium`: array of 1 or 2 strings | |
| 170 * `v8`: array of 1 or 2 strings | |
| 171 * `catapult`: array of 1 or 2 strings | |
| 172 * `angle`: array of 1 or 2 strings | |
| 173 * `skia`: array of 1 or 2 strings | |
| 174 * `webrtc`: array of 1 or 2 strings | |
| 175 | |
| 176 ### BuildbotInfo | 161 ### BuildbotInfo |
| 177 | 162 |
| 178 This tracks buildbot parameters when the Histogram was produced to allow users | 163 This tracks buildbot parameters when the Histogram was produced to allow users |
| 179 to compare or merge results across similar bots. | 164 to compare or merge results across similar bots. |
| 180 | 165 |
| 181 * `displayMasterName`: string | 166 * `displayMasterName`: string |
| 182 * `displayBotName`: string | 167 * `displayBotName`: string |
| 183 * `buildbotMasterName`: string | 168 * `buildbotMasterName`: string |
| 184 * `buildbotName`: string | 169 * `buildbotName`: string |
| 185 * `buildNumber`: number | 170 * `buildNumber`: number |
| (...skipping 50 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 236 | 221 |
| 237 * `events`: array of dictionaries containing `stableId`, `title`, `start`, | 222 * `events`: array of dictionaries containing `stableId`, `title`, `start`, |
| 238 `duration` fields of Events | 223 `duration` fields of Events |
| 239 | 224 |
| 240 ### DateRange | 225 ### DateRange |
| 241 | 226 |
| 242 This is a Range of Dates. | 227 This is a Range of Dates. |
| 243 | 228 |
| 244 * `min`: Unix timestamp in ms | 229 * `min`: Unix timestamp in ms |
| 245 * `max`: optional Unix timestamp in ms | 230 * `max`: optional Unix timestamp in ms |
| OLD | NEW |