Skip to content

Commit da4048f

Browse files
jack-bergreyang
andauthored
Clarify that exemplar reservoir default may change in a minor version (open-telemetry#3943)
Related to open-telemetry#3756. See this [conversation](open-telemetry#3870 (comment)) for context. --------- Co-authored-by: Reiley Yang <reyang@microsoft.com>
1 parent 7db3c50 commit da4048f

2 files changed

Lines changed: 8 additions & 0 deletions

File tree

CHANGELOG.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -13,6 +13,9 @@ release.
1313

1414
### Metrics
1515

16+
- Clarify that exemplar reservoir default may change in a minor version.
17+
([#3943](https://github.com/open-telemetry/opentelemetry-specification/pull/3943))
18+
1619
### Logs
1720

1821
- Refine description of Instrumentation Scope.

specification/metrics/sdk.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1052,6 +1052,11 @@ use `AlignedHistogramBucketExemplarReservoir`.
10521052
twenty (e.g. `min(20, max_buckets)`).
10531053
- All other aggregations will use `SimpleFixedSizeExemplarReservoir`.
10541054

1055+
Exemplar default reservoirs MAY change in
1056+
a [minor version bump](./../versioning-and-stability.md#minor-version-bump). No
1057+
guarantees are made on the shape or statistical properties of returned
1058+
exemplars.
1059+
10551060
#### SimpleFixedSizeExemplarReservoir
10561061

10571062
This reservoir MUST use an uniformly-weighted sampling algorithm based on the

0 commit comments

Comments
 (0)