●Change8

Migrating to OpenTelemetry Python v1.41.0

Version v1.41.0 introduces 2 breaking changes. This guide details how to update your code.

Released: 4/9/2026

2
Breaking Changes
2
Migration Steps
26
Affected Symbols

⚠️ Check Your Code

If you use any of these symbols, you need to read this guide:

opentelemetry-sdkdetection_development.detectors[].hostdetection_development.detectors[].containeropentelemetry-resource-detector-containeridcreate_tracer_providerconfigure_tracer_providerExplicitBucketHistogramAggregationBatchLogRecordProcessorschedule_delay_millisOTEL_BLRP_SCHEDULE_DELAYdetection_development.detectors[].process_parse_headerscreate_meter_providerconfigure_meter_providercreate_resourcecreate_propagatorconfigure_propagatorCRITICALFATALMetricReaderSpanReadableSpanBoundedAttributesBoundedListmax_export_batch_sizeTracerConfig

Breaking Changes

●Issue #1

The default `schedule_delay_millis` for `BatchLogRecordProcessor` changed from 5000ms to 1000ms to comply with the OTel specification. Logs may now be exported 5x more frequently by default if the environment variable `OTEL_BLRP_SCHEDULE_DELAY` was not explicitly set.

●Issue #2

Internal interface change in `opentelemetry-sdk`: TracerConfig is now cached into the tracer. This means only one Tracer with the same instrumentation scope will be created.

Migration Steps

  1. 1
    If you rely on `BatchLogRecordProcessor` exporting logs at a maximum delay of 5 seconds, you must now explicitly set the environment variable `OTEL_BLRP_SCHEDULE_DELAY` to `5000`.
  2. 2
    If you were relying on the internal mechanism that created multiple Tracer instances for the same scope, be aware that only one Tracer instance per instrumentation scope will now be created due to TracerConfig caching.

Release Summary

This release introduces extensive support for declarative configuration in `opentelemetry-sdk`, enabling instantiation of providers, resources, and propagators via YAML/JSON files. It also adjusts the default log batch export delay to align with the OTel specification.

Need More Details?

View the full release notes and all changes for OpenTelemetry Python v1.41.0.

View Full Changelog