| Index: docs/how-to-write-metrics.md
|
| diff --git a/docs/how-to-write-metrics.md b/docs/how-to-write-metrics.md
|
| index ebe104096d359b8b1962d5b3fb2acb3a6821e260..ba44a85f996aae4a22339408f68c3c14f1917789 100644
|
| --- a/docs/how-to-write-metrics.md
|
| +++ b/docs/how-to-write-metrics.md
|
| @@ -149,21 +149,14 @@ histogram.addSample(number, {name: diagnostic})
|
|
|
| ### Histogram Relationship Diagnostics
|
|
|
| - * [RelatedHistogramSet](/tracing/tracing/value/diagnostics/related_histogram_set.html):
|
| - These are Sets of references to other Histograms. Visually, they are a set
|
| - of HTML links which, when clicked, select the contained Histograms. The text
|
| - content of the HTML link is the name of the referenced Histogram.
|
| -
|
| - 
|
| -
|
| * [RelatedHistogramMap](/tracing/tracing/value/diagnostics/related_histogram_map.html):
|
| These are Maps from strings to references to other Histograms. Visually, they
|
| - are a set of HTML links similar to RelatedHistogramSet, but the text content of
|
| - the link is the Map's string key instead of the Histogram's name. One example
|
| - application is when a Histogram was produced not directly by a metric, but
|
| - rather by merging together other Histograms, then it will have a
|
| - RelatedHistogramMap named 'mergedFrom' that refers to the Histograms that were
|
| - merged by their grouping key, e.g. the telemetry story name.
|
| + are a set of HTML links where the text content of the link is the Map's
|
| + string key instead of the Histogram's name. One example application is when a
|
| + Histogram was produced not directly by a metric, but rather by merging
|
| + together other Histograms, then it will have a RelatedHistogramMap named
|
| + 'mergedFrom' that refers to the Histograms that were merged by their grouping
|
| + key, e.g. the telemetry story name.
|
|
|
| 
|
|
|
| @@ -204,9 +197,9 @@ histogram.addSample(number, {name: diagnostic})
|
| unitted number. This is only to allow Histograms in other parts of the trace
|
| viewer to display number sample diagnostics more intelligently than
|
| GenericSet can. If a metric wants to display number sample diagnostics
|
| - intelligently, then it should use RelatedHistogramSet or RelatedHistogramMap;
|
| - if it does not want to monitor changes in those numbers, then the TBM2
|
| - maintainers can add a HistogramDiagnostic that supports merging.
|
| + intelligently, then it should use RelatedHistogramMap; if it does not want to
|
| + monitor changes in those numbers, then the TBM2 maintainers can add a
|
| + HistogramDiagnostic that supports merging.
|
|
|
|
|
| ## Consumers of Histograms
|
|
|