Skip to content

Add normative language for metrics API/SDK concurrency #4868

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
reyang merged 5 commits into from
Feb 10, 2026
Merged

Add normative language for metrics API/SDK concurrency #4868

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
e87fb34
add normative language for metrics API/SDK concurrency
reyang Feb 4, 2026
9aa7332
changelog
reyang Feb 4, 2026
790c40c
adjust the wording based on PR feedback
reyang Feb 10, 2026
810b78d
Merge branch 'main' into reyang/concurrency
cijothomas Feb 10, 2026
18207e7
fix typo
reyang Feb 10, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 3 additions & 0 deletions CHANGELOG.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -18,6 +18,9 @@ release.

### Metrics

- Add normative language to the Metrics API/SDK spec concurrency requirements.
([#4868](https://github.com/open-telemetry/opentelemetry-specification/pull/4868))

### Logs

- Add optional `Exception` parameter to Emit LogRecord.
Expand Down
10 changes: 6 additions & 4 deletions specification/metrics/api.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -1342,12 +1342,14 @@ APIs without introducing breaking changes, if possible.
For languages which support concurrent execution the Metrics APIs provide
specific guarantees and safeties.

**MeterProvider** - all methods are safe to be called concurrently.
**MeterProvider** - all methods MUST be documented that implementations need to
be safe for concurrent use by default.

**Meter** - all methods are safe to be called concurrently.
**Meter** - all methods MUST be documented that implementations need to be safe
for concurrent use by default.

**Instrument** - All methods of any Instrument are safe to be called
concurrently.
**Instrument** - all methods MUST be documented that implementations need to be
safe for concurrent use by default.

## References

Expand Down
10 changes: 5 additions & 5 deletions specification/metrics/sdk.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -1847,15 +1847,15 @@ existing methods without introducing breaking changes, if possible.
For languages which support concurrent execution the Metrics SDKs provide
specific guarantees and safeties.

**MeterProvider** - Meter creation, `ForceFlush` and `Shutdown` are safe to be
called concurrently.
**MeterProvider** - Meter creation, `ForceFlush` and `Shutdown` MUST be safe
to be called concurrently.

**ExemplarReservoir** - all methods are safe to be called concurrently.
**ExemplarReservoir** - all methods MUST be safe to be called concurrently.

**MetricReader** - `Collect`, `ForceFlush` (for periodic exporting MetricReader)
and `Shutdown` are safe to be called concurrently.
and `Shutdown` MUST be safe to be called concurrently.

**MetricExporter** - `ForceFlush` and `Shutdown` are safe to be called
**MetricExporter** - `ForceFlush` and `Shutdown` MUST be safe to be called
concurrently.

## References
Expand Down
Loading