v1.0.0-rc.3
This release contains a number of changes which are breaking according to the versioning policy, but in
practice are unlikely to be impactful. These changes generally make implicit assumptions explicit, or require changes
from implementations but not end users. There are a small number of notable breaking changes called out below.
This release also contains a large number of project tooling improvements aimed at improving consistency and quality.
Notably, the schema is now compiled into a single file at opentelemetry_configuration.json. Please see project tooling docs for more details.
Schema
-
BREAKING: Move certificate configuration under
tlsblock and rename to align with collector
(#331, #418)Migration steps
# Before tracer_provider: # or meter_provider, logger_provider processors: - batch: exporter: otlp_http: certificate_file: /app/cert.pem client_key_file: /app/key.pem client_certificate_file: /app/client_cert.pem --- # After tracer_provider: processors: - batch: exporter: otlp_http: tls: ca_file: /app/cert.pem key_file: /app/key.pem cert_file: /app/client_cert.pem
-
BREAKING: Update .log_level to be enum
(#447)Migration steps
# .log_level must now be one of the values in https://github.com/open-telemetry/opentelemetry-configuration/blob/main/schema-docs.md#severitynumber- # If already conforming to this, no update is necessary, else update to the equivalent level. log_level: info
-
BREAKING: Delete ZipkinSpanExporter ahead of stabilizing after deprecation in the specification.
See https://opentelemetry.io/blog/2025/deprecating-zipkin-exporters/ for details. If you depend on ZipkinSpanExporter
w/ declarative config, please open an issue to let us know.
(#453) -
BREAKING (low-impact): Add ConsoleMetricExporter
(#362) -
BREAKING (low-impact): Add [0, 1] bounds for TraceIdRatioBasedSampler ratio
(#358) -
BREAKING (low-impact): Make view selector and stream required
(#365) -
BREAKING (low-impact): Change JaegerRemote to Experimental
(#363) -
BREAKING (low-impact): Fix casing for OpenTelemetryConfiguration
(#372) -
BREAKING (low-impact): Add AttributeLimit constraints
(#382) -
BREAKING (low-impact): Set AttributeLimits additionalProperties: false
(#381) -
BREAKING (low-impact): Update Propagator to disallow additionalProperties
(#388) -
BREAKING (low-impact): Add constraints to Base2ExponentialBucketHistogramAggregation properties
(#383) -
BREAKING (low-impact): Add minItems recommendation for array properties
(#386) -
BREAKING (low-impact): Experimental{Signal}MatcherAndConfig require name and config properties
(#406) -
BREAKING (low-impact): Break out dedicated type for prometheus translation strategy
(#415) -
BREAKING (low-impact): Add schema modeling guidance for enum values as lower_snake_case
(#445) -
Replace patternProperties with additionalProperties for improved type safety
(#323, #347) -
Minor cleanup of SDK extension plugin types
(#385) -
Add schema for ProbabilitySampler
(#339) -
Add new LoggerConfig parameters
(#392) -
Update
without_target_infotoExperimentalPrometheusMetricExporter
(#376) -
Clarify .file_format is a string consisting of the major and minor version
(#455) -
Add schema for rule based sampler
(#410) -
Add Distribution section for vendor-specific settings
(#433)
Tooling
- Fix links, use common link checker
(#319, #351, #379, #434) - Track additional schema meta data, including default behavior and descriptions. Separate schema source and compile into single output file. Add additional schema validation. Generate documentation from schema.
(#312, #350, #360, #359, #361, #370, #369, #367, #364, #384, #380, #366, #374, #414, #412, #411, #424, #425, #426, #436, #443, #444, #442, #440, #451, #450) - Document what you see is what you get philosophy as schema modeling rule
(#377) - Add contributing / release guidance for breaking changes
(#373) - Document SDK extension plugin schema modeling rule
(#378) - Misc docs updates
(#423) - Add getting started config at
/examples/getting-started.yaml
(#402) - Move stability definition to VERSIONING.md, rework README.md for improved focus
(#454) - Add tooling for small targeted configuration snippets
(#397)