Skip to content

feat(configuration): bump declarative configuration schema to v1.2.0 - #5926

Open
herin049 wants to merge 3 commits into
open-telemetry:mainfrom
herin049:misc/declarative-config-schema-1.2
Open

herin049 wants to merge 3 commits into
open-telemetry:mainfrom
herin049:misc/declarative-config-schema-1.2

Conversation

@herin049

Copy link
Copy Markdown
Contributor

Description

Updates the vendored OpenTelemetry configuration schema from v1.1.0 to v1.2.0 and regenerates models.py. file_format values of 1.2 are now accepted without a warning.

New v1.2.0 fields that map to existing SDK features are now applied:

  • sampler.always_record -> AlwaysRecordSampler wrapping the configured root sampler
  • max_request_size on OTLP HTTP (protobuf) exporters -> the exporter's max_request_size

New fields the SDK doesn't support yet are accepted, but a warning says they will be ignored:

  • max_response_size on all OTLP exporters
  • max_request_size on OTLP gRPC and OTLP HTTP JSON exporters
  • attribute_value_depth_limit on attribute_limits, span limits and log record limits
  • meter_provider.view_matching_mode/development

Type of change

Please delete options that are not relevant.

  • Bug fix (non-breaking change which fixes an issue)
  • New feature (non-breaking change which adds functionality)
  • Breaking change (fix or feature that would cause existing functionality to not work as expected)
  • This change requires a documentation update

Checklist:

See contributing.md for styleguide, changelog guidelines, and more.

  • I am a human and not a bot
  • I have run tox -e precommit
  • I have run tox -e typecheck
  • I have run the relevant tests and linting tox environments
  • This requires the following PR in contrib:

@opentelemetry-pr-dashboard

opentelemetry-pr-dashboard Bot commented Nov 12, 2026 •

Copy link
Copy Markdown

Pull request dashboard status

Waiting on maintainers · refreshed 2026-11-15 08:20 UTC

Merge when ready.

Status above doesn't look right?
  • Just replied or pushed? Anything around or after the refresh time above may not be picked up yet — give it a few minutes.
  • Anything look wrong? Report it with what you expected; it helps us improve the dashboard.

@herin049 herin049 added the Approve Public API check This label shows that the public symbols added or changed in a PR are strictly necessary label Nov 12, 2026

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟢 Approval recommended

No active review issues are reported for the declarative configuration schema v1.2.0 update.

No open issues 🎉

What changed in this PR

Updates declarative configuration to schema v1.2.0, connecting supported new fields to existing SDK features and warning when unsupported fields are ignored.

Changes:

  • Updates the vendored schema, regenerates models, and accepts file_format: "1.2" without a version warning.
  • Adds always_record sampler configuration and OTLP HTTP protobuf request-size limits.
  • Adds unsupported-field warnings, unit tests, and an always-record integration scenario.
File Description
tests/​opentelemetry-docker-tests/​tests/​declconfig/​scenarios/​trace_sampler_always_record/​scenario.yaml Defines recording and export expectations.
tests/​opentelemetry-docker-tests/​tests/​declconfig/​scenarios/​trace_sampler_always_record/​run.py Exercises record-only and sampled spans.
tests/​opentelemetry-docker-tests/​tests/​declconfig/​scenarios/​trace_sampler_always_record/​otel-config.yaml Configures the always-record integration scenario.
opentelemetry-configuration/​tests/​test_tracer_provider.py Tests sampler wiring, request limits, and warnings.
opentelemetry-configuration/​tests/​test_meter_provider.py Tests request limits and unsupported-field warnings.
opentelemetry-configuration/​tests/​test_logger_provider.py Tests request limits and unsupported-field warnings.
opentelemetry-configuration/​src/​opentelemetry/​configuration/​schema.json Vendors v1.2.0 fields and schema documentation.
opentelemetry-configuration/​src/​opentelemetry/​configuration/​models.py Adds generated models for new schema fields.
opentelemetry-configuration/​src/​opentelemetry/​configuration/​file/​_loader.py Recognizes schema minor version 2.
opentelemetry-configuration/​src/​opentelemetry/​configuration/​_tracer_provider.py Applies always-record sampling and request limits; adds warnings.
opentelemetry-configuration/​src/​opentelemetry/​configuration/​_meter_provider.py Applies request limits and warns about unsupported settings.
opentelemetry-configuration/​src/​opentelemetry/​configuration/​_logger_provider.py Applies request limits and warns about unsupported settings.
opentelemetry-configuration/​src/​opentelemetry/​configuration/​_common.py Centralizes unsupported size-limit and attribute-depth warnings.

Review effort: Balanced

@github-project-automation github-project-automation Bot moved this to Approved PRs in Python PR digest Nov 12, 2026
@herin049
herin049 force-pushed the misc/declarative-config-schema-1.2 branch from 2b0e29e to 71d3fb8 Compare November 15, 2026 08:13

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Approve Public API check This label shows that the public symbols added or changed in a PR are strictly necessary

Projects

Status: Approved PRs

Development

Successfully merging this pull request may close these issues.

3 participants