| 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 # How to Write Metrics | 6 # How to Write Metrics |
| 7 | 7 |
| 8 Timeline-Based Measurement v2 is a system for computing metrics from traces. | 8 Timeline-Based Measurement v2 is a system for computing metrics from traces. |
| 9 | 9 |
| 10 A TBM2 metric is a Javascript function that takes a trace Model and produces | 10 A TBM2 metric is a Javascript function that takes a trace Model and produces |
| (...skipping 170 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 181 * [TelemetryInfo](/tracing/tracing/value/diagnostics/telemetry_info.html): | 181 * [TelemetryInfo](/tracing/tracing/value/diagnostics/telemetry_info.html): |
| 182 This is automatically attached to every Histogram produced by telemetry. | 182 This is automatically attached to every Histogram produced by telemetry. |
| 183 Structurally, it's a class with explicit named fields. | 183 Structurally, it's a class with explicit named fields. |
| 184 Conceptually, it contains information about the origins of the trace that was | 184 Conceptually, it contains information about the origins of the trace that was |
| 185 consumed by the metric that produced the Histogram, such as the benchmark | 185 consumed by the metric that produced the Histogram, such as the benchmark |
| 186 name, story name, benchmark start timestamp, etc. | 186 name, story name, benchmark start timestamp, etc. |
| 187 Visually, TelemetryInfos are displayed as a table. | 187 Visually, TelemetryInfos are displayed as a table. |
| 188 | 188 |
| 189  | 189  |
| 190 | 190 |
| 191 * [RevisionInfo](/tracing/tracing/value/diagnostics/revision_info.html): | |
| 192 This is automatically attached to every Histogram produced by telemetry. | |
| 193 Structurally, it's a class with explicit named fields. Conceptually, it | |
| 194 contains ranges of revisions of the software used to produce the trace that | |
| 195 was consumed by the metric that produced the Histogram, such as the Chromium | |
| 196 revision, v8 revision, and catapult revision. Visually, RevisionInfos are | |
| 197 displayed as a table. | |
| 198 | |
| 199  | |
| 200 | |
| 201 * [BuildbotInfo](/tracing/tracing/value/diagnostics/buildbot_info.html): | 191 * [BuildbotInfo](/tracing/tracing/value/diagnostics/buildbot_info.html): |
| 202 This is automatically attached to every Histogram produced by Chrome's | 192 This is automatically attached to every Histogram produced by Chrome's |
| 203 performance testing buildbots. Structurally, it's a class with explicit named | 193 performance testing buildbots. Structurally, it's a class with explicit named |
| 204 fields. Conceptually, it contains information about the buildbot process that | 194 fields. Conceptually, it contains information about the buildbot process that |
| 205 ran telemetry. Visually, it is displayed as a table. | 195 ran telemetry. Visually, it is displayed as a table. |
| 206 | 196 |
| 207  | 197  |
| 208 | 198 |
| 209 ### Other Diagnostics | 199 ### Other Diagnostics |
| 210 | 200 |
| (...skipping 54 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 265 * Instead of having one category for all story grouping keys, each grouping | 255 * Instead of having one category for all story grouping keys, each grouping |
| 266 individual grouping key may be listed as a category. For example, in Page | 256 individual grouping key may be listed as a category. For example, in Page |
| 267 Cycler v2 benchmarks, the "cache_temperature" grouping key would be | 257 Cycler v2 benchmarks, the "cache_temperature" grouping key would be |
| 268 displayed as a category. | 258 displayed as a category. |
| 269 * Choosing groups builds a hierarchy of histograms that is filled in by merging | 259 * Choosing groups builds a hierarchy of histograms that is filled in by merging |
| 270 histograms from the bottom up. Expanding the rows of histogram-set-table, any | 260 histograms from the bottom up. Expanding the rows of histogram-set-table, any |
| 271 leaf nodes are histograms that were loaded, and their ancestors are computed b
y | 261 leaf nodes are histograms that were loaded, and their ancestors are computed b
y |
| 272 merging. | 262 merging. |
| 273 * histogram-set-table uses the "label" property of TelemetryInfo to define the | 263 * histogram-set-table uses the "label" property of TelemetryInfo to define the |
| 274 columns of the table. | 264 columns of the table. |
| OLD | NEW |