●Change8

Migrating to OpenTelemetry Python v1.44.0

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

Released: 7/16/2026

2
Breaking Changes
3
Migration Steps
22
Affected Symbols

⚠️ Check Your Code

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

opentelemetry-docker-testsopentelemetry-exporter-otlp-commonopentelemetry-sdkLogRecordExporterInMemorySpanExporterExponentialBucketHistogramAggregationExplicitBucketHistogramAggregationSynchronousMultiLogRecordProcessorConcurrentMultiLogRecordProcessorTracerProvideropentelemetry-instrumentation-loggingopentelemetry-configurationopentelemetry.sdk._configurationopentelemetry.configurationopentelemetry-apiEnvironmentGetteropentelemetry-semantic-conventionsopentelemetry-exporter-otlp-proto-httpBatchLogRecordProcessorReadableLogRecordContextProcessResourceDetector

Breaking Changes

●Issue #1

The `opentelemetry-sdk`'s `BatchLogRecordProcessor` now clears the `Context` object before buffering. Custom log exporters that access `context` from `ReadableLogRecord` might be affected as the context will now be an empty `Context()` instead of the original.

●Issue #2

The `opentelemetry-api` has removed environment carrier environment snapshot caching. You must now explicitly pass the mapping from which to get environment variables as the first argument to `EnvironmentGetter.get`.

Migration Steps

  1. 1
    If you are using custom log exporters that access `context` from `ReadableLogRecord`, you may need to adjust your code to handle an empty `Context()` object.
  2. 2
    When using `EnvironmentGetter.get` in `opentelemetry-api`, explicitly pass the mapping from which to get environment variables as the first argument.
  3. 3
    Users who depend on `process.command_args` and `process.command_line` resource attributes from `ProcessResourceDetector` in `opentelemetry-sdk` must now pass `include_command_args=True`.

Release Summary

This release introduces several new features for declarative configuration, including support for instrumentors and file exporters, along with improvements to log record processing and resource attribute handling. It also removes the deprecated Events API and SDK.

Need More Details?

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

View Full Changelog