-
Notifications
You must be signed in to change notification settings - Fork 965
Open
Labels
area:configurationRelated to configuring the SDKRelated to configuring the SDKsig-issueA specific SIG should look into this before discussing at the specA specific SIG should look into this before discussing at the specspec:miscellaneousFor issues that don't match any other spec labelFor issues that don't match any other spec label
Description
What are you trying to achieve?
Define a language-neutral ConfigProvider API contract that allows instrumentation
and other components to observe runtime changes to declarative configuration.
Today, declarative configuration is effectively consumed at initialization time.
To support runtime policy/config evolution (including work discussed in
OTEP: Telemetry Policy),
the configuration API needs a standardized callback/listener capability.
Proposed scope (phase 1)
Add normative API requirements for:
- listener registration/unregistration on
ConfigProvider - watched path semantics (path format + exact matching)
- callback payload semantics (
path, updated config, behavior when removed/unset) - delivery semantics (ordering/coalescing expectations)
- error handling (listener throws, provider failures)
- lifecycle and close semantics (idempotent close, behavior after close)
- behavior when provider does not support runtime notifications
Non-goals (phase 1)
- defining a full transactional/diff model for config updates
- requiring SDKs to support remote config transports/protocols
- mandating strict global ordering across multiple changed paths
Prior art / context
- Add a ConfigProvider callback for runtime instrumentation option changes opentelemetry-java#8076
- Making "methods" instrumentation dynamically updateable opentelemetry-java-instrumentation#15228
Definition of done
- Spec PR merged in
specification/configuration/api.mdwith normative language
forConfigProviderchange-listener behavior.
Reactions are currently unavailable
Metadata
Metadata
Assignees
Labels
area:configurationRelated to configuring the SDKRelated to configuring the SDKsig-issueA specific SIG should look into this before discussing at the specA specific SIG should look into this before discussing at the specspec:miscellaneousFor issues that don't match any other spec labelFor issues that don't match any other spec label