●Change8

Migrating to OpenTelemetry 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.detectorsExplicitBucketHistogramAggregationBatchLogRecordProcessorOTEL_BLRP_SCHEDULE_DELAYopentelemetry-apicreate_tracer_providerconfigure_tracer_providercreate_meter_providerconfigure_meter_providercreate_resourcecreate_propagatorconfigure_propagatorCRITICALFATALMetricReaderSpanReadableSpanopentelemetry-exporter-prometheusBoundedAttributesBoundedListopentelemetry-proto-jsonopentelemetry-codegen-jsonOTLPMetricExportermax_export_batch_sizeopentelemetry-exporter-otlp-proto-http

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 of creating multiple Tracer instances with the same scope, be aware that `opentelemetry-sdk` now caches the Tracer based on instrumentation scope.

Release Summary

This release introduces extensive support for declarative configuration in `opentelemetry-sdk`, enabling setup via YAML/JSON files for providers, resources, and detectors. It also fixes a critical default configuration change for `BatchLogRecordProcessor` and enhances metric/log processing capabilities.

Need More Details?

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

View Full Changelog