feat: Add ConfigPropertiesBackedConfigProvider options for extensions and distros

[aviralgarg05]

• Enhance ConfigPropertiesBackedConfigProvider with Builder for custom mappings

• Refactor ConfigPropertiesBackedDeclarativeConfigProperties to support mappings

• Addresses issue create a replacement for DeclarativeConfigPropertiesBridge for extensions and distros #15811

[trask]

cc @zeitlinger

[zeitlinger]

great 😄

[zeitlinger]

pr title is misleading - nothing is replaced it this PR - just new functions added

[Copilot]

Pull request overview

This PR extends the declarative-config-bridge module so that extensions and distros can supply custom property mappings when bridging ConfigProperties into DeclarativeConfigProperties (declarative/YAML config). It adds a Builder to ConfigPropertiesBackedConfigProvider and threads a custom-mappings map through ConfigPropertiesBackedDeclarativeConfigProperties, merging user mappings on top of the built-in SPECIAL_MAPPINGS while rejecting attempts to override built-ins. This addresses issue #15811.

Changes:

• Added ConfigPropertiesBackedConfigProvider.builder() with addMapping(...) and build(ConfigProperties) for supplying custom declarative→config-property mappings.
• Added an overload createInstrumentationConfig(ConfigProperties, Map<String,String>) that merges custom mappings with built-ins and throws IllegalArgumentException on override of a built-in mapping; instance now carries the merged mappings map through getStructured navigation.
• Added tests for builder mappings, default mappings, and rejection of built-in overrides.

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 1 comment.

File	Description
ConfigPropertiesBackedConfigProvider.java	Introduces Builder and routes create/build through the new mapping-aware factory.
ConfigPropertiesBackedDeclarativeConfigProperties.java	Adds mappings field, a mapping-aware factory with built-in override validation, and propagates mappings through navigation.
ConfigPropertiesBackedConfigProviderTest.java	New tests covering builder mappings, defaults, and override rejection.
ConfigPropertiesBackedDeclarativeConfigPropertiesTest.java	Adds a test verifying custom mappings coexist with special mappings.

[opentelemetry-pr-dashboard]

This PR has review comments. Review suggestions, whether from maintainers or automated reviewers, aren't always correct or required. Please evaluate each comment on its merits, then make sure each thread has a clear outcome.

For example, link to the commit if you applied a suggestion, explain why it wasn't applied, or ask a follow-up question.

Automation flags a PR for human review once every review thread has a reply or is marked as resolved.

Status across open PRs is visible on the pull request dashboard.

[trask]

@robsunday @zeitlinger do you still need this feature? thanks!

[zeitlinger]

This would unblock follow-up work in opentelemetry-java-contrib that replaces the remaining usages of DeclarativeConfigPropertiesBridgeBuilder with the non-deprecated bridge API.

In particular, the custom mapping support here is what we need for the contrib declarative component providers. Once this lands, it should let us finish migrating those callers and keep the old bridge on track for removal in 3.0.

#19202
open-telemetry/opentelemetry-java-contrib#2988

[zeitlinger]

Closing this in favor of #19220, which carries the current version of the bridge work, including the configurable access path, the shared duration helper, and the added docs/tests based on the contrib follow-up.