diff --git a/CHANGELOG.md b/CHANGELOG.md index 4b4691192ab..5ef1d9b6200 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -13,8 +13,12 @@ release. ### Metrics +- Change the exemplar behavior to be on by default. + ([#3994](https://github.com/open-telemetry/opentelemetry-specification/pull/3994)) - Add name suggestion for option to apply resource attributes as metric attributes in Prometheus exporter. ([#3837](https://github.com/open-telemetry/opentelemetry-specification/pull/3837)) +- Mark Exemplars as stable. + ([#3870](https://github.com/open-telemetry/opentelemetry-specification/pull/3870)) ### Logs @@ -51,8 +55,6 @@ release. ([#3872](https://github.com/open-telemetry/opentelemetry-specification/pull/3872)) - Add synchronous gauge entry to sum monotonic table. ([#3977](https://github.com/open-telemetry/opentelemetry-specification/pull/3977)) -- Change the exemplar behavior to be on by default. - ([#3994](https://github.com/open-telemetry/opentelemetry-specification/pull/3994)) ### Logs diff --git a/spec-compliance-matrix.md b/spec-compliance-matrix.md index 1a754c380c9..37ca67e2860 100644 --- a/spec-compliance-matrix.md +++ b/spec-compliance-matrix.md @@ -201,8 +201,8 @@ formats is required. Implementing more than one format is optional. | Exemplars retain any attributes available in the measurement that are not preserved by aggregation or view configuration. | | | + | | - | | + | | | | - | | | Exemplars contain the associated trace id and span id of the active span in the Context when the measurement was taken. | | | + | | - | | + | | | | - | | | Exemplars contain the timestamp when the measurement was taken. | | | + | | - | | + | | | | - | | -| The metrics SDK provides an `ExemplarReservoir` interface or extension point. | X | | - | | - | | + | + | | | - | | -| An `ExemplarReservoir` has an `offer` method with access to the measurement value, attributes, `Context` and timestamp. | X | | - | | - | | + | + | | | - | | +| The metrics SDK provides an `ExemplarReservoir` interface or extension point. | | | - | | - | | + | + | | | - | | +| An `ExemplarReservoir` has an `offer` method with access to the measurement value, attributes, `Context` and timestamp. | | | - | | - | | + | + | | | - | | | The metrics SDK provides a `SimpleFixedSizeExemplarReservoir` that is used by default for all aggregations except `ExplicitBucketHistogram`. | | | + | | - | | + | + | | | - | | | The metrics SDK provides an `AlignedHistogramBucketExemplarReservoir` that is used by default for `ExplicitBucketHistogram` aggregation. | | | + | | - | | + | | | | - | | | A metric Producer accepts an optional metric Filter | | | | | | | - | | | | | | diff --git a/specification/metrics/sdk.md b/specification/metrics/sdk.md index 1b46a38e2e0..4c50c4d8428 100644 --- a/specification/metrics/sdk.md +++ b/specification/metrics/sdk.md @@ -382,7 +382,7 @@ The SDK MUST accept the following stream configuration parameters: user does not provide an `aggregation` value, the `MeterProvider` MUST apply a [default aggregation](#default-aggregation) configurable on the basis of instrument type according to the [MetricReader](#metricreader) instance. -* **Status**: [Experimental, Feature-freeze](../document-status.md) - `exemplar_reservoir`: A +* `exemplar_reservoir`: A functional type that generates an exemplar reservoir a `MeterProvider` will use when storing exemplars. This functional type needs to be a factory or callback similar to aggregation selection functionality which allows @@ -957,7 +957,7 @@ series and the topic requires further analysis. ## Exemplar -**Status**: [Experimental, Feature-freeze](../document-status.md) +**Status**: [Stable](../document-status.md) Exemplars are example data points for aggregated data. They provide specific context to otherwise general aggregations. Exemplars allow correlation between