●Change8

Migrating to OpenTelemetry 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
20
Affected Symbols

⚠️ Check Your Code

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

opentelemetry-docker-testsopentelemetry-exporter-otlp-commonopentelemetry-sdkLogRecordExporterInMemorySpanExporterBatchLogRecordProcessorReadableLogRecordContextSynchronousMultiLogRecordProcessorConcurrentMultiLogRecordProcessorTracerProviderExponentialBucketHistogramAggregationExplicitBucketHistogramAggregationBoundedAttributesopentelemetry-instrumentation-loggingProcessResourceDetectoropentelemetry-exporter-otlp-proto-httpopentelemetry-apiEnvironmentGetteropentelemetry-semantic-conventions

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 retrieve environment variables as the first argument.
  3. 3
    Users who depend on `process.command_args` and `process.command_line` resource attributes from `opentelemetry-sdk`'s `ProcessResourceDetector` must now pass `include_command_args=True`.

Release Summary

This release introduces several new features for declarative configuration, logging, and resource attribute management. It also includes bug fixes and refactors for improved stability and performance.

Need More Details?

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

View Full Changelog