Mark declarative config as stable #4568

jack-berg · 2025-06-24T14:46:10Z

Resolves #4374.

We recently cut a release candidate for opentelemetry-configuration. After some additional bake-in time and review, we'd like to cut a stable release.

The stable release needs to coincide with marking key parts of the specification stable, so I'm opening this PR to solicit feedback such that when the time comes, we can mark the specification and opentelemetry-configuration stable is quick succession.

See open-telemetry/opentelemetry-configuration#100 for status of implementations.

cc @open-telemetry/configuration-maintainers

jack-berg · 2025-06-24T14:46:58Z

This is ready for review, but SHOULD not be merged. Assuming we get the required approvals, I'll coordinate merging this with cutting the corresponding release of opentelemetry-configuration.

github-actions · 2025-07-02T03:35:04Z

This PR was marked stale due to lack of activity. It will be closed in 7 days.

github-actions · 2025-07-10T03:36:30Z

This PR was marked stale due to lack of activity. It will be closed in 7 days.

specification/configuration/sdk.md

…y-specification into stabilize-declarative-config

specification/configuration/sdk.md

pellared · 2025-07-11T10:35:18Z

specification/configuration/sdk.md

 * `component_provider` - The `ComponentProvider`.
-* `type` - The type of plugin interface it provides (e.g. SpanExporter, Sampler,
-  etc).
+* `type` - The type of plugin interface it provides.


I do not like that in one place we are saying "component" in other "plugin" or "plugin interfaces".
I know that it keeps the same intention, but it makes me harder to read and interpret the specification.
I propose to use the term "Component" everywhere and just mention in the "Component" definition that this is a plugin that allows extensibility of the Configuration SDK.

That's fine with me. I was trying to connect the dots because elsewhere in the spec we both the words component and plugin interface. I'll try to be consistent here with "component" but also have a callout with something to the effect of: "... (also called plugin interface elsewhere in the spec)"

specification/configuration/sdk.md

github-actions · 2025-07-19T03:36:50Z

This PR was marked stale due to lack of activity. It will be closed in 7 days.

github-actions · 2025-07-27T03:47:17Z

This PR was marked stale due to lack of activity. It will be closed in 7 days.

github-actions · 2025-08-07T03:46:29Z

This PR was marked stale due to lack of activity. It will be closed in 7 days.

tsloughter · 2025-08-07T19:31:42Z

A concern I have is that this sort of implies that a spec for the behavior of AutoConfiguredOpenTelemetrySdk.initialize().getOpenTelemetrySdk(); is stable, which I think requires that #4591 be done.

Can the spec of config be stable before SDK initialization is defined?

github-actions · 2025-10-31T03:31:30Z

This PR was marked stale due to lack of activity. It will be closed in 7 days.

github-actions · 2025-11-08T03:25:34Z

This PR was marked stale due to lack of activity. It will be closed in 7 days.

github-actions · 2025-11-17T03:34:13Z

This PR was marked stale due to lack of activity. It will be closed in 7 days.

jack-berg · 2025-11-19T16:31:33Z

The config SIG has been making a lot of progress around the goal of stability and will be looking to stabilize end of 2025 / early 2026. Converting this to a draft until we're ready.

github-actions · 2025-11-27T03:32:32Z

This PR was marked stale due to lack of activity. It will be closed in 7 days.

…y-specification into stabilize-declarative-config

specification/configuration/sdk.md

jack-berg · 2025-12-15T20:51:11Z

A concern I have is that this sort of implies that a spec for the behavior of AutoConfiguredOpenTelemetrySdk.initialize().getOpenTelemetrySdk(); is stable, which I think requires that #4591 be done.
Can the spec of config be stable before SDK initialization is defined?

@tsloughter I don't understand. AutoConfiguredOpenTelemetrySdk.initialize().getOpenTelemetrySdk() is a java specific concept. How does the declarative config spec imply anything about a java specific concept?

@pellared

From feedback here: #4568 (comment) /cc @open-telemetry/configuration-maintainers @pellared

@pellared

From feedback here: #4568 (comment) /cc @open-telemetry/configuration-maintainers, @pellared

Mark declarative config as stable

04649ba

jack-berg requested review from a team June 24, 2025 14:46

Merge branch 'main' into stabilize-declarative-config

274afc5

github-actions bot added the Stale label Jul 2, 2025

carlosalberto removed the Stale label Jul 2, 2025

github-actions bot added the Stale label Jul 10, 2025

pellared mentioned this pull request Jul 10, 2025

Add Configuration SDK open-telemetry/opentelemetry-dotnet#6380

Open

pellared reviewed Jul 10, 2025

View reviewed changes

specification/configuration/sdk.md Show resolved Hide resolved

pellared reviewed Jul 10, 2025

View reviewed changes

specification/configuration/sdk.md Show resolved Hide resolved

pellared reviewed Jul 10, 2025

View reviewed changes

specification/configuration/sdk.md Show resolved Hide resolved

jack-berg removed the Stale label Jul 10, 2025

jack-berg added 2 commits July 10, 2025 16:33

Merge branch 'main' of https://github.com/open-telemetry/opentelemetr…

678225d

…y-specification into stabilize-declarative-config

PR feedback

e1a7e09

jack-berg commented Jul 10, 2025

View reviewed changes

specification/configuration/sdk.md Show resolved Hide resolved

jack-berg commented Jul 10, 2025

View reviewed changes

specification/configuration/sdk.md Show resolved Hide resolved

pellared reviewed Jul 11, 2025

View reviewed changes

github-actions bot added the Stale label Jul 19, 2025

MrAlias removed the Stale label Jul 19, 2025

github-actions bot added the Stale label Jul 27, 2025

MrAlias removed the Stale label Jul 28, 2025

github-actions bot added the Stale label Aug 7, 2025

MrAlias removed the Stale label Aug 7, 2025

carlosalberto removed the Stale label Oct 23, 2025

github-actions bot added the Stale label Oct 31, 2025

lmolkova removed the Stale label Oct 31, 2025

github-actions bot added the Stale label Nov 8, 2025

marcalff removed the Stale label Nov 9, 2025

github-actions bot added the Stale label Nov 17, 2025

carlosalberto removed the Stale label Nov 17, 2025

jack-berg marked this pull request as draft November 19, 2025 16:31

github-actions bot added the Stale label Nov 27, 2025

carlosalberto removed the Stale label Dec 1, 2025

revert register componentprovider type clarification

ce31365

jack-berg mentioned this pull request Dec 15, 2025

Link to declarative config types for SDK extension plugins #4802

Merged

jack-berg added 4 commits December 15, 2025 11:24

Merge branch 'main' of https://github.com/open-telemetry/opentelemetr…

d6fbce4

…y-specification into stabilize-declarative-config

Add links to issues

1da6cc0

Fix compliance matrix

3cb264b

Mark config programmatic customization as experimental

01d203a

jack-berg commented Dec 15, 2025

View reviewed changes

specification/configuration/sdk.md Show resolved Hide resolved

consistent status callout

c636863

jack-berg mentioned this pull request Dec 15, 2025

Use consistent vocabulary in reference to components and plugins #4806

Open

github-merge-queue bot pushed a commit that referenced this pull request Dec 18, 2025

Link to declarative config types for SDK extension plugins (#4802)

c2cfe71

From feedback here: #4568 (comment) /cc @open-telemetry/configuration-maintainers @pellared

github-merge-queue bot pushed a commit that referenced this pull request Dec 18, 2025

Clarify declarative config component provider type parameter (#4799)

7601df4

From feedback here: #4568 (comment) /cc @open-telemetry/configuration-maintainers, @pellared

Mark declarative config as stable #4568

Are you sure you want to change the base?

Mark declarative config as stable #4568

Uh oh!

Conversation

jack-berg commented Jun 24, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

jack-berg commented Jun 24, 2025

Uh oh!

github-actions bot commented Jul 2, 2025

Uh oh!

github-actions bot commented Jul 10, 2025

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

pellared Jul 11, 2025

Choose a reason for hiding this comment

Uh oh!

jack-berg Jul 19, 2025

Choose a reason for hiding this comment

Uh oh!

jack-berg Dec 15, 2025

Choose a reason for hiding this comment

Uh oh!

Uh oh!

github-actions bot commented Jul 19, 2025

Uh oh!

github-actions bot commented Jul 27, 2025

Uh oh!

github-actions bot commented Aug 7, 2025

Uh oh!

tsloughter commented Aug 7, 2025

Uh oh!

github-actions bot commented Oct 31, 2025

Uh oh!

github-actions bot commented Nov 8, 2025

Uh oh!

github-actions bot commented Nov 17, 2025

Uh oh!

jack-berg commented Nov 19, 2025

Uh oh!

github-actions bot commented Nov 27, 2025

Uh oh!

Uh oh!

jack-berg commented Dec 15, 2025

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

10 participants

jack-berg commented Jun 24, 2025 •

edited

Loading