Skip to content

Commit

Permalink
Mark exemplars as stable. (#3870)
Browse files Browse the repository at this point in the history
  • Loading branch information
jsuereth authored Apr 20, 2024
1 parent 2bbcd2d commit e6eccba
Show file tree
Hide file tree
Showing 3 changed files with 8 additions and 6 deletions.
6 changes: 4 additions & 2 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down Expand Up @@ -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

Expand Down
4 changes: 2 additions & 2 deletions spec-compliance-matrix.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 | | | | | | | - | | | | | |
Expand Down
4 changes: 2 additions & 2 deletions specification/metrics/sdk.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down Expand Up @@ -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
Expand Down

0 comments on commit e6eccba

Please sign in to comment.