Add ExponentialHistogram to Metrics data model#1935
Conversation
|
@open-telemetry/specs-metrics-approvers this is ready for review. |
…ication into jmacd/expohistomodel
|
FYI I have posted reference implementations that calculate bucket indexes described by the formulas here. These were captured from the review thread of open-telemetry/opentelemetry-proto#322 here, now available: |
…ication into jmacd/expohistomodel
|
@jmacd all looks good now. |
|
@jmacd "the lower-boundary of index -68 cannot be represented using a double". Similarly, to be bullet proof, we need guard against overflow at the high end of "double": Not sure it is worth mentioning such extreme cases in the spec though. Maybe it is, spec has to be bullet proof. "Should the producer bother to check that an index can be reverse-mapped before using it?" And I assume you are talking about the exponent extraction method. The log method generally does not work well in the subnormal range. I had to skip it in subnormal tests (https://github.com/newrelic-experimental/newrelic-sketch-java/blob/main/src/test/java/com/newrelic/nrsketch/indexer/BucketIndexerTest.java#L400) |
reyang
left a comment
There was a problem hiding this comment.
LGTM assuming the broken link will be fixed. https://github.com/open-telemetry/opentelemetry-specification/pull/1935/files#r723471163
Co-authored-by: Reiley Yang <[email protected]>
…ication into jmacd/expohistomodel
Co-authored-by: Aaron Abbott <[email protected]>
* Add ExponentialHistogram to Metrics data model * draft expectations * toc * remove one 'exponential' * mention the use of logarithm and inexact computation * manual edit TOC * typo * reduce precision * from Yuke's feedback * mapping methods * several fixes from yzhuge * lint * update links * Changelog * mention min/max * let consumers deal with overflow and underflow * yzhuge's remarks * whitespace * Apply suggestions from code review Co-authored-by: Reiley Yang <[email protected]> * revert TOC trouble etc * upcase * Update specification/metrics/datamodel.md Co-authored-by: Aaron Abbott <[email protected]> Co-authored-by: Reiley Yang <[email protected]> Co-authored-by: Aaron Abbott <[email protected]>
Fixes #1932.
Changes
Adds statements describing the ExponentialHistogram data point introduced by open-telemetry/opentelemetry-proto#322.
This is meant to capture details about acceptable precision limits, how to handle out-of-range values for producers and consumers. See open-telemetry/opentelemetry-proto#322 (comment)
Related OTEPs:
https://github.com/open-telemetry/oteps/blob/main/text/0149-exponential-histogram.md