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