This release adds the experimental metrics API/SDK and will include the following packages:

  opentelemetry-exporter-prometheus
  opentelemetry-api
  opentelemetry-sdk
  opentelemetry-exporter-otlp-proto-grpc
  opentelemetry-exporter-otlp

Added

• opentelemetry-exporter-prometheus: add support to configure Resource attributes as metric labels (#5122)
• infra: add renovate (#5202)
• opentelemetry-api, opentelemetry-sdk: add support for extended attribute values everywhere. (#5266)
• opentelemetry-sdk: wire the top-level log_level field in declarative configuration — when set, maps the OTel SeverityNumber value to a Python logging level and applies it to the opentelemetry logger so SDK internal diagnostics respect the configured severity. (#5351)
• opentelemetry-sdk: add the new stable AlwaysRecordSampler (#5354)
• opentelemetry-configuration, opentelemetry-sdk: wire top-level attribute_limits into per-signal providers via declarative config; add log_record_limits support to LoggerProvider (#5365)
• opentelemetry-exporter-otlp-json-http: add OTLP JSON HTTP exporter package (#5374)
• opentelemetry-api, opentelemetry-sdk: add enabled() support to the Logger API, SDK, and LogRecordProcessor to let instrumentation skip expensive work when logging is disabled (#5380)
• opentelemetry-exporter-otlp-json-file: add OTLP JSON file Docker tests (#5412)
• opentelemetry-configuration: wire the experimental tracer_configurator/development, meter_configurator/development and logger_configurator/development fields into create_tracer_provider, create_meter_provider and create_logger_provider, so per-instrumentation-scope enabled overrides declared in the config file are applied to the provider (previously these fields were parsed but silently discarded). The logger minimum_severity/trace_based fields are not supported by the Python SDK and are ignored with a warning. (#5418)
• docs/examples: add example on how to manually setup the SDK to get SDK metrics (#5449)
• opentelemetry-docker-tests: add Prometheus exporter docker tests (#5457)
• opentelemetry-sdk: count records dropped after shutdown on otel.sdk.processor.{span,log}.processed with error.type=already_shutdown (batch span/log and simple log processors), which the semantic conventions define as a valid value for this metric. (#5509)
• opentelemetry-semantic-conventions: update semantic conventions to v1.44.0 (#5511)
• opentelemetry-sdk: add host.id to the host resource detector (#5653)
• opentelemetry-test-utils: add CapturingSampler to record what samplers receive in instrumentation tests (#5681)

Changed

• Enable PIE (flake8-pie) ruff rule and fix all violations (#5150)
• The public opentelemetry.util.types.AttributeValue type in package opentelemetry-api is being expanded to include None, heterogeneous sequences of primitive types (and nested sequences) as opposed to only homogeneous primitive sequences, and Mappings of strings to any primitive types or sequences/mappings (which themselves must only contain primitive types or sequences/mappings validated the same way). If a bytes type is set as an attribute value in the SDK, it will no longer be utf-8 decoded to a string, instead it will be passed along as is in accordance with the OTEL spec, since bytes is a valid type in the OTLP proto. (#5266)
• opentelemetry-exporter-otlp-proto-http: add a max_request_size argument to the OTLP HTTP exporters (traces, logs, metrics); serialized requests larger than the limit are dropped before sending, measured before compression. Defaults to 64 MiB (enabled); set to 0 to disable. Mirrors opentelemetry-go#8157. (#5369)
• [BREAKING] opentelemetry-api: subclasses of Logger need to implement the enabled method (#5380)
• opentelemetry-exporter-otlp-proto-http: refactor to use shared opentelemetry-exporter-otlp-common and opentelemetry-exporter-http-transport packages and switch default HTTP backend to urllib3 (#5389)
• opentelemetry-sdk: unify logging force_flush timeout defaults to 30000ms (#5438)
• opentelemetry-python: enable Ruff default ruleset and fix auto-fixable lint issues (#5491)
• opentelemetry-sdk: SimpleSpanProcessor now drops spans ended after shutdown() instead of passing them to the exporter, and counts them on otel.sdk.processor.span.processed with error.type=already_shutdown. (#5512)
• Bump pytest to 9.0.3 (#5518)
• opentelemetry-exporter-otlp-proto-http: clarify that the endpoint= kwarg requires the full signal path (#5633)
• opentelemetry-sdk: fix typos in SpanLimits docstring (#5658)

Fixed

• opentelemetry-configuration: perform environment variable substitution on scalar values after parsing the configuration file, so ${VAR} references inside comments and mapping keys are no longer substituted and undefined references in comments no longer abort loading (#5407)
• opentelemetry-configuration: declarative config environment variable substitution now replaces an unset variable that has no default with an empty value instead of raising an error, per the configuration spec. Resource attributes whose value resolves to null (an unset ${VAR} with no default) are skipped with a warning instead of being inserted as a null value. (#5408)
• 'scripts/build.sh: add opentelemetry-configurationandopentelemetry-proto-json` to the package to release (#5425)
• opentelemetry-sdk: fix View instrument-name matching so a view configured with an instrument's real (mixed-case) name is applied; matching is now case-insensitive and platform-independent instead of relying on fnmatch's OS-dependent case handling (#5430)
• opentelemetry-sdk: fix missing f-prefix in exponential histogram error messages (#5434)
• opentelemetry-configuration: resolve false-positive warning logs for newer schema minor version (#5436)
• opentelemetry-sdk: make methods on FixedSizeExemplarReservoirABC thread safe (#5437)
• opentelemetry-propagator-jaeger: fix typing issues and enable pyright typechecking for the package opentelemetry-propagator-jaeger: skip uberctx- baggage headers with an empty value on extraction instead of raising TypeError (#5440)
• opentelemetry-sdk: fix TypeError when instantiating a _BaseConfigurator subclass whose __init__ takes arguments (#5441)
• opentelemetry-sdk: fix TypeError in os.fork() when a BatchProcessor or PeriodicExportingMetricReader is garbage collected (#5453)
• opentelemetry-configuration: a declarative config key present with an empty (null) value on an object-typed node (e.g. always_on:, a - service: detector, or a metric console: exporter) is now treated the same as an explicit empty config (always_on: {}) instead of failing type dispatch or silently skipping the node. Both dict-typed nodes and dataclasses constructible with no arguments are covered. (#5454)
• opentelemetry-api: fix copy-pasted log message in SpanContext.__delattr__ (#5455)
• opentelemetry-sdk: reject views with ExponentialBucketHistogramAggregation for asynchronous instruments instead of silently producing no data (#5461)
• opentelemetry-sdk: fill every bucket of SimpleFixedSizeExemplarReservoir before random sampling (#5462)
• opentelemetry-sdk: Import code_attributes from stable semconv package (#5465)
• opentelemetry-sdk: for both the simple and batch span/log processors, count otel.sdk.processor.{span,log}.processed when the processor submits records to the exporter instead of after export completes, and stop stamping exporter failures onto this metric as error.type (#5472)
• opentelemetry-sdk: fix misleading instrument name validation error message (name max length is 255, not 63). (#5513)
• opentelemetry-configuration: add missing process executable name to default service name when available in resource attributes (#5534)
• opentelemetry-sdk: fix values for process.executable.name and process.executable.path to match semantic conventions. (#5535)
• opentelemetry-api: fix TraceState.update dropping all entries when adding a new key at the 32-key limit (#5543)
• opentelemetry-sdk: bound get_aggregated_resources() wait to the timeout (#5545)
• opentelemetry-sdk: don't read process.executable.name resource attribute when building default service.name (#5547)
• opentelemetry-propagator-jaeger: enforce baggage limits on both uberctx- extract and inject, borrowing the same limits (180 entries, 4096 bytes per entry, 8192 bytes total) the package's core W3CBaggagePropagator already uses, so neither an inbound carrier nor an in-process baggage map can produce unbounded work or headers. (#5556)
• opentelemetry-sdk: keep metric attribute values that Python considers equal but the data model does not, such as True, 1 and 1.0, in separate metric streams (#5573)
• opentelemetry-sdk: keep Resource hashable and serialisable when an attribute value is bytes, instead of raising TypeError from every OTLP encoder (#5577)
• opentelemetry-sdk: fix instrumentation scope name matching in the tracer, meter and logger configurators so it is case-sensitive on every platform instead of relying on fnmatch's OS-dependent case handling (#5584)
• opentelemetry-sdk: fix TracerProvider() raising ValueError when OTEL_TRACES_SAMPLER_ARG is a syntactically valid number outside the [0.0, 1.0] range, instead of logging a warning and falling back like other invalid values (#5594)
• opentelemetry-sdk: retain values from synchronous instruments using last-value aggregation across cumulative collections (#5637)
• opentelemetry-api: Added guard for negative value on max_value_len (#5647)
• opentelemetry-sdk: fix overriding of the service.instance.id which has been populated from the user provided values through the resource detectors (#5660)
• opentelemetry-exporter-otlp-proto-grpc: Fix incorrect default port for OTLP gRPC exporter self-metrics (#5668)
• opentelemetry-api: update W3CBaggagePropagator to properly handle whitespace (#5680)

Added

• opentelemetry-docker-tests: Refactor Docker tests to properly validate contents of exported telemetry (#5220)
• opentelemetry-exporter-otlp-common: add shared package for common OTLP utilities (#5252)
• opentelemetry-sdk: add MissingDependencyError exception for declarative configuration and use it for missing optional dependency errors (#5265)
• opentelemetry-sdk: Add ability to refresh process dependent Resource attributes (#5280)
• opentelemetry-sdk: add force_flush method to LogRecordExporter ABC (#5294)
• opentelemetry-sdk: Make it possible to limit the size of stored spans in InMemorySpanExporter (#5296)
• opentelemetry-sdk: add log record limits environment variables OTEL_LOGRECORD_ATTRIBUTE_COUNT_LIMIT and OTEL_LOGRECORD_ATTRIBUTE_VALUE_LENGTH_LIMIT (#5300)
• opentelemetry-sdk: add support for file exporter with declarative config (#5311)
• opentelemetry-sdk: expose SynchronousMultiLogRecordProcessor and ConcurrentMultiLogRecordProcessor publicly (#5327)
• opentelemetry-sdk: point the declarative configuration package README at the shared language support status matrix in the opentelemetry-configuration repo, so Python conformance status lives alongside the other languages instead of being duplicated per language SDK. (#5347)
• opentelemetry-sdk: document that Python-implementation extensions (OTEL_PYTHON_* variables) are bypassed when OTEL_CONFIG_FILE is set. The env-var initialisation path is skipped entirely in favour of the declarative file; honouring these alongside a config file is tracked as a follow-up. (#5353)
• opentelemetry-sdk: wire id_generator from declarative configuration to TracerProvider (#5363)
• opentelemetry-sdk: Add support for activating instrumentors from a declarative configuration file via the instrumentation/development.python section. Instrumentors can declare a configuration attribute to have their options validated through the same type-coercion pipeline used for SDK component configuration. (#5372)
• opentelemetry-sdk: add record_min_max option to ExponentialBucketHistogramAggregation, matching the option already available on ExplicitBucketHistogramAggregation and required by the specification (#5377)

Changed

• opentelemetry-sdk: revert BoundedAttributes RLock back to Lock (#5329)
• docs: update logs example to use opentelemetry-instrumentation-logging (#5344)
• opentelemetry-sdk: bump declarative configuration schema to v1.1.0 (#5345)
• opentelemetry-configuration: declarative configuration moves from opentelemetry.sdk._configuration into the new public opentelemetry-configuration package (opentelemetry.configuration namespace), published experimentally. opentelemetry-sdk[file-configuration] continues to work as an alias that installs opentelemetry-configuration alongside the SDK. (#5356)
• opentelemetry-api: remove env carrier environment snapshot caching, you now have to pass explicitly the mapping where to get the environment variables from as the EnvironmentGetter.get first argument. (#5366)
• opentelemetry-semantic-conventions: bump to 1.42.0 (#5410)
• opentelemetry-semantic-conventions: bump to 1.43.0 (#5413)

Removed

• opentelemetry-api, opentelemetry-sdk: Removed deprecated Events API/SDK. Use LogRecord with the event_name field set instead. (#5293)

Fixed

• opentelemetry-sdk: Optimize LogRecord memory in BatchLogRecordProcessor by clearing the Context object before buffering. This is a potentially breaking change for custom log exporters that access context from the exported ReadableLogRecord, as the context will now be an empty Context() instead of the original. (#4977)
• opentelemetry-sdk: drop non-finite measurements (NaN and Inf) at the instrument level to prevent permanent aggregation poisoning (#5336)
• opentelemetry-sdk: raise ValueError when ExplicitBucketHistogramAggregation boundaries are not strictly increasing or finite (#5340)
• opentelemetry-sdk: ProcessResourceDetector no longer collects or emits process.command_args and process.command_line by default since the values are not sanitized and may contain sensitive information. Users who depend on these resource attributes must pass include_command_args=True. (#5364)
• opentelemetry-exporter-otlp-proto-http: fix the OTLP HTTP metric exporter self-observability metrics over-counting data points when max_export_batch_size splits a batch; each split now reports its own data-point count instead of the whole-batch count. (#5370)
• opentelemetry-api: Prevent in-place mutation of Context via inherited dict methods (#5399)

Added

• opentelemetry-sdk: add add_metric_reader / remove_metric_reader public APIs to register / unregister metric readers at runtime. (#4863)
• opentelemetry-exporter-prometheus: add support for configuring metric scope labels (#5123)
• opentelemetry-exporter-otlp-proto-grpc: Add grpc error details to the log message that's written when the grpc call fails. (#5143)
• opentelemetry-exporter-http-transport: add 'opentelemetry-exporter-http-transport' package for HTTP exporters (#5194)
• opentelemetry-sdk: Add composite/development samplers support to declarative file configuration (#5201)
• opentelemetry-exporter-otlp-json-file: Add OTLP JSON File exporter implementation (#5207)
• opentelemetry-sdk: add _resolve_component shared utility for declarative config plugin loading, reducing boilerplate in exporter factory functions (#5215)
• opentelemetry-sdk: add pull metric reader support to declarative file configuration, including Prometheus metric reader via the prometheus_development config field (#5216)
• opentelemetry-proto-json: update to use opentelemetry-proto v1.10.0 (#5224)
• opentelemetry-proto: bump maximum supported protobuf version to 7.x.x (#5251)
• opentelemetry-sdk: add ServiceInstanceIdResourceDetector for populating service.instance.id (#5259)
• opentelemetry-sdk: declarative config loader now recursively converts parsed dicts into typed dataclass instances, including nested dataclasses, lists of dataclasses, and enum values. End-to-end YAML/JSON → SDK configuration now works via the factory functions. (#5269)
• opentelemetry-sdk: add configure_sdk(config) to the declarative configuration API. Single entry point that takes a parsed OpenTelemetryConfiguration, builds the resource, and applies the tracer/meter/logger providers and propagator globally. Honors the top-level disabled flag. (#5270)
• opentelemetry-sdk: the SDK configurator now honors the OTEL_CONFIG_FILE environment variable. When set, the SDK loads and applies the referenced declarative configuration file (YAML or JSON) in place of the env-var-based init path. (#5271)
• opentelemetry-sdk: update declarative config to use ServiceInstanceIdResourceDetector (#5299)
• opentelemetry-exporter-otlp-proto-common, opentelemetry-exporter-otlp-json-common: encoders now always accept null, and encode it as an empty AnyValue in accordance with the spec. (#5305)
• opentelemetry-sdk: validate the declarative config file_format version — reject an unsupported major version and warn on a newer minor version, per the configuration spec versioning rules (#5315)
• opentelemetry-exporter-http-transport: enable entry-point loading of transport implementations (#5320)

Changed

• opentelemetry-sdk: introduce experimental entry points for OpAMP agent integration (#4646)
• opentelemetry-api: conditionally import entrypoints for opentelemetry_context only if the OTEL_PYTHON_CONTEXT env variable is defined, return ContextVarsRuntimeContext otherwise (#5144)
• opentelemetry-sdk: rename "known/unknown" to "built-in/user-defined" terminology in declarative config component loading code (#5214)
• opentelemetry-proto: regenerate protobuf code from opentelemetry-proto v1.10.0 (#5223)
• opentelemetry-sdk: remove unnecessary copy in Span creation (#5272)
• opentelemetry-sdk: remove unnecessary dict in set_attribute method (#5274)
• opentelemetry-sdk: inline the method _clean_attribute_value (#5275)
• Remove typing aliases deprecated in python 3.9 and replace all usages of typing.Union and typing.Optional with |. (#5277)
• opentelemetry-sdk: remove generator in the accessor for links/events (#5287)
• opentelemetry-api: remove unnecessary copy in iterator (#5288)
• opentelemetry-api: update EnvironmentGetter to ignore non-normalized environment variable names (#5289)
• opentelemetry-sdk: update iterator for BoundedList (#5297)
• opentelemetry-sdk: reduce lock contention in attributes (#5298)
• opentelemetry-sdk: merge doesn't need a copy, dict already does this (#5326)
• opentelemetry-api: normalize empty environment propagation names to _ in EnvironmentSetter and EnvironmentGetter (#5328)

Fixed

• Add missing .rst files to Sphinx documentation build for SDK logs, propagators, and exporter submodules. (#5017)
• Preserve the random trace ID flag when creating child spans instead of always setting the random trace id bit depending on the available trace id generator. (#5241)
• opentelemetry-api: fix SelectableGroups deprecation warning (#5250)
• opentelemetry-sdk: make SynchronousMeasurementConsumer.consume_measurement lock free to avoid deadlocks (#5321)

This is a patch release on the previous 1.42.0/0.63b0 release, fixing the issue(s) below.

Fixed

• Preserve the random trace ID flag when creating child spans instead of always setting the random trace id bit depending on the available trace id generator. (#5241)

Added

• opentelemetry-api, opentelemetry-sdk: add support for 'random-trace-id' flags in W3C traceparent header trace flags. Implementations of IdGenerator that do randomly generate the 56 least significant bits, should also implement a is_trace_id_random methods that returns True. (#4854)
• logs: add exception support to Logger emit and LogRecord attributes (#4908)
• opentelemetry-exporter-otlp-proto-grpc: make retryable gRPC error codes configurable for gRPC exporters (#4917)
• opentelemetry-sdk: Add create_logger_provider/configure_logger_provider to declarative file configuration, enabling LoggerProvider instantiation from config files without reading env vars (#4990)
• opentelemetry-exporter-otlp-json-common: add 'opentelemetry-exporter-otlp-json-common' package for OTLP JSON exporters (#4996)
• opentelemetry-sdk: Add service resource detector support to declarative file configuration via detection_development.detectors[].service (#5003)
• opentelemetry-docker-tests: add docker-tests coverage of opentelemetry-exporter-otlp-proto-grpc and opentelemetry-exporter-otlp-proto-http metrics export (#5030)
• Add registry keyword argument to PrometheusMetricReader to allow passing a custom Prometheus registry (#5055)
• Add WeaverLiveCheck test util (#5088)
• opentelemetry-sdk: add load_entry_point shared utility to declarative file configuration for loading plugins via entry points; refactor propagator loading to use it (#5093)
• opentelemetry-sdk: add sampler plugin loading to declarative file configuration via the opentelemetry_sampler entry point group, matching the spec's PluginComponentProvider mechanism (#5095)
• opentelemetry-sdk: add propagator plugin loading to declarative file configuration via the opentelemetry_propagator entry point group, matching the spec's PluginComponentProvider mechanism (#5098)
• opentelemetry-sdk: add exporter plugin loading to declarative file configuration for all three signals (traces, metrics, logs) via the opentelemetry_*_exporter entry point groups, matching the spec's PluginComponentProvider mechanism (#5128)
• opentelemetry-sdk: add generic resource detector plugin loading to declarative file configuration via the opentelemetry_resource_detector entry point group, matching the spec's PluginComponentProvider mechanism (#5129)
• opentelemetry-sdk: add additional_properties support to generated config models via custom datamodel-codegen template, enabling plugin/custom component names to flow through typed dataclasses (#5131)
• Add ability to selectively enable exporting of SDK internal metrics with the OTEL_PYTHON_SDK_INTERNAL_METRICS_ENABLED environment variable. (#5151)

Changed

• opentelemetry-semantic-conventions: use X | Y union annotation (#5096)
• opentelemetry-api: update EnvironmentGetter and EnvironmentSetter to use normalized environment variable names (#5119)
• Apply fixes for UP ruff rule (#5133)
• opentelemetry-sdk: only load entrypoints for resource detectors if they are configured via OTEL_EXPERIMENTAL_RESOURCE_DETECTORS (#5145)
• ci: wait for tracecontext server readiness instead of a fixed sleep in scripts/tracecontext-integration-test.sh (#5149)
• Switch to SPDX license headers and add CI enforcement (#5177)
• opentelemetry-semantic-conventions: Bump semantic conventions to 1.41.1, this changes the metrics name of K8S_CONTAINER_CPU_LIMIT_UTILIZATION and K8S_CONTAINER_CPU_REQUEST_UTILIZATION. (#5200)

Removed

• opentelemetry-api: remove third-party importlib-metadata in favor of standard library since Python >= 3.10 is now required (#3234)
• Drop Python 3.9 support (#5076)

Fixed

• opentelemetry-sdk: Allow declarative OTLP HTTP exporters to map compression: deflate instead of rejecting it as unsupported. (#5075)
• Fix incorrect code example in create_tracer() docstring (#5077)
• opentelemetry-sdk: Fix ProcessResourceDetector to use sys.orig_argv so that process.command, process.command_line, and process.command_args reflect the original invocation for python -m <module> runs (where sys.argv[0] is rewritten to the module path) (#5083)
• opentelemetry-sdk: fix YAML structure injection via environment variable substitution in declarative file configuration; values containing newlines are now emitted as quoted YAML scalars per spec requirement (#5091)
• opentelemetry-sdk: Fix mutable attributes reference in metrics, attributes passed to instrument add/record are now copied so that subsequent mutations do not affect recorded data points (#5106)
• opentelemetry-sdk: make resource detector ordering deterministic (#5120)
• Fix incorrect type annotation on detectors parameter of get_aggregated_resources (#5135)
• opentelemetry-api: Enforce W3C Baggage size limits on outbound propagation in W3CBaggagePropagator.inject(). Previously only inbound extraction enforced limits; now inject also caps entries at 180, individual pairs at 4096 bytes, and total header at 8192 bytes per the W3C Baggage spec. The extract path max_pairs limit now counts all size-valid entries rather than only successfully parsed ones. (#5163)
• opentelemetry-sdk: fix multi-processor force_flush skipping remaining processors when one returns None (#5179)
• opentelemetry-test-utils: fix weaver live check hanging when weaver log output fills the pipe buffer (#5208)

This is a patch release on the previous 1.41.0/0.62b0 release, fixing the issue(s) below.

• opentelemetry-sdk: Add host resource detector support to declarative file configuration via detection_development.detectors[].host (#5002)
• opentelemetry-sdk: Add container resource detector support to declarative file configuration via detection_development.detectors[].container, using entry point loading of the opentelemetry-resource-detector-containerid contrib package (#5004)
• opentelemetry-sdk: Add create_tracer_provider/configure_tracer_provider to declarative file configuration, enabling TracerProvider instantiation from config files without reading env vars (#4985)
• Enabled the flake8-tidy-import plugins rules for the ruff linter. These rules throw warnings for relative imports in the modules. (#5019)
• opentelemetry-sdk: Fix AttributeError in ExplicitBucketHistogramAggregation when applied to non-Histogram instruments without explicit boundaries (#5034)
• Fix BatchLogRecordProcessor default schedule_delay_millis from 5000ms to 1000ms to comply with the OTel specification. Note: logs may be exported 5x more frequently by default (e.g. for users who don't explicitly set the OTEL_BLRP_SCHEDULE_DELAY env var). (#4998)
• opentelemetry-sdk: Add process resource detector support to declarative file configuration via detection_development.detectors[].process (#5001)
• opentelemetry-sdk: Add shared _parse_headers helper for declarative config OTLP exporters (#5021)
• opentelemetry-api: Replace a broad exception in attribute cleaning tests to satisfy pylint in the lint-opentelemetry-api CI job
• opentelemetry-sdk: Add create_meter_provider/configure_meter_provider to declarative file configuration, enabling MeterProvider instantiation from config files without reading env vars (#4987)
• opentelemetry-sdk: Add create_resource and create_propagator/configure_propagator to declarative file configuration, enabling Resource and propagator instantiation from config files without reading env vars (#4979)
• opentelemetry-sdk: Map Python CRITICAL log level to OTel FATAL severity text per the specification (#4984)
• opentelemetry-sdk: Add file configuration support with YAML/JSON loading, environment variable substitution, and schema validation against the vendored OTel config JSON schema (#4898)
• Fix intermittent CI failures in getting-started and tracecontext jobs caused by GitHub git CDN SHA propagation lag by installing contrib packages from the already-checked-out local copy instead of a second git clone (#4958)
• opentelemetry-sdk: fix type annotations on MetricReader and related types (#4938)
• opentelemetry-sdk: implement log creation metric (#4935)
• opentelemetry-sdk: implement metric reader metrics (#4970)
• opentelemetry-sdk: implement processor metrics (#5012)
• opentelemetry-sdk: upgrade vendored OTel configuration schema from v1.0.0-rc.3 to v1.0.0 (#4965)
• improve check-links ci job (#4978)
• Resolve some Pyright type errors in Span/ReadableSpan and utility stubs (#4973)
• opentelemetry-exporter-prometheus: Fix metric name prefix (#4895)
• opentelemetry-api, opentelemetry-sdk: Add deepcopy support for BoundedAttributes and BoundedList (#4934)
• opentelemetry-proto-json, opentelemetry-codegen-json: Implement custom protoc plugin to generate OTLP JSON class definitions (#4910)
• Add configurable max_export_batch_size to OTLP HTTP metrics exporter (#4576)
• opentelemetry-sdk: Implement experimental Meter configurator (#4966)
• opentelemetry-exporter-otlp-proto-http: use consistent protobuf for export request (#5015)
• opentelemetry-sdk: cache TracerConfig into the tracer, this changes an internal interface. Only one Tracer with the same instrumentation scope will be created (#5007)
• Redo OTLPMetricExporter unit tests of max_export_batch_size to use real export (#5036)
• opentelemetry-sdk: Implement experimental Logger configurator (#4980)

BREAKING CHANGE

As part of #4861, start_span and start_as_current_span as part of NoOpTracer were fixed such that they no longer strictly return an INVALID_SPAN if there is a valid span context as the current span context, instead it propagates the span context properly even at the absence of the sdk installed.

• opentelemetry-sdk: deprecate LoggingHandler in favor of opentelemetry-instrumentation-logging, see opentelemetry-instrumentation-logging documentation (#4919)
• opentelemetry-sdk: Clarify log processor error handling expectations in documentation (#4915)
• bump semantic-conventions to v1.40.0 (#4941)
• Add stale PR GitHub Action (#4926)
• opentelemetry-sdk: Drop unused Jaeger exporter environment variables (exporter removed in 1.22.0) (#4918)
• opentelemetry-sdk: Clarify timeout units in environment variable documentation (#4906)
• opentelemetry-exporter-otlp-proto-grpc: Fix re-initialization of gRPC channel on UNAVAILABLE error (#4825)
• opentelemetry-exporter-prometheus: Fix duplicate HELP/TYPE declarations for metrics with different label sets (#4868)
• Allow loading all resource detectors by setting OTEL_EXPERIMENTAL_RESOURCE_DETECTORS to * (#4819)
• opentelemetry-sdk: Fix the type hint of the _metrics_data property to allow None (#4837).
• Regenerate opentelemetry-proto code with v1.9.0 release (#4840)
• Add python 3.14 support (#4798)
• Silence events API warnings for internal users (#4847)
• opentelemetry-sdk: make it possible to override the default processors in the SDK configurator (#4806)
• Prevent possible endless recursion from happening in SimpleLogRecordProcessor.on_emit, (#4799) and (#4867).
• Implement span start/end metrics (#4880)
• Add environment variable carriers to API (#4609)
• Add experimental composable rule based sampler (#4882)
• Make ConcurrentMultiSpanProcessor fork safe (#4862)
• opentelemetry-exporter-otlp-proto-http: fix retry logic and error handling for connection failures in trace, metric, and log exporters (#4709)
• opentelemetry-sdk: avoid RuntimeError during iteration of view instrument match dictionary in MetricReaderStorage.collect() (#4891)
• Implement experimental TracerConfigurator (#4861)
• opentelemetry-sdk: Fix instrument creation race condition (#4913)
• bump semantic-conventions to v1.39.0 (#4914)
• opentelemetry-sdk: automatically generate configuration models using OTel config JSON schema (#4879)

This is a patch release on the previous 1.39.0/0.60b0 release, fixing the issue(s) below.

• Silence events API warnings for internal users (#4847)

• opentelemetry-api: Convert objects of any type other than AnyValue in attributes to string to be exportable (#4808)

• docs: Added sqlcommenter example (#4734)

• build: bump ruff to 0.14.1 (#4782)

• Add opentelemetry-exporter-credential-provider-gcp as an optional dependency to opentelemetry-exporter-otlp-proto-grpc and opentelemetry-exporter-otlp-proto-http (#4760)

• semantic-conventions: Bump to 1.38.0 (#4791)

• [BREAKING] Remove LogData and extend SDK LogRecord to have instrumentation scope (#4676)

• [BREAKING] Rename several classes from Log to LogRecord
  (#4647)

  Migration Guide:

  LogData has been removed. Users should update their code as follows:

  • For Log Exporters: Change from Sequence[LogData] to Sequence[ReadableLogRecord]

    # Before
    from opentelemetry.sdk._logs import LogData
    def export(self, batch: Sequence[LogData]) -> LogRecordExportResult:
        ...
    
    # After
    from opentelemetry.sdk._logs import ReadableLogRecord
    def export(self, batch: Sequence[ReadableLogRecord]) -> LogRecordExportResult:
        ...

  • For Log Processors: Use ReadWriteLogRecord for processing, ReadableLogRecord for exporting

    # Before
    from opentelemetry.sdk._logs import LogData
    def on_emit(self, log_data: LogData):
        ...
    
    # After
    from opentelemetry.sdk._logs import ReadWriteLogRecord, ReadableLogRecord
    def on_emit(self, log_record: ReadWriteLogRecord):
        # Convert to ReadableLogRecord before exporting
        readable = ReadableLogRecord(
            log_record=log_record.log_record,
            resource=log_record.resource or Resource.create({}),
            instrumentation_scope=log_record.instrumentation_scope,
            limits=log_record.limits,
        )
        ...

  • Accessing log data: Use the same attributes on ReadableLogRecord/ReadWriteLogRecord

    • log_record.log_record - The API LogRecord (contains body, severity, attributes, etc.)
    • log_record.resource - The Resource
    • log_record.instrumentation_scope - The InstrumentationScope (now included, was in LogData before)
    • log_record.limits - The LogRecordLimits

• Mark the Events API/SDK as deprecated. The Logs API/SDK should be used instead, an event is now a LogRecord with the event_name field set (#4654).

• Fix type checking for built-in metric exporters (#4820)

• Add rstcheck to pre-commit to stop introducing invalid RST (#4755)
• logs: extend Logger.emit to accept separated keyword arguments (#4737)
• logs: add warnings for classes that would be deprecated and renamed in 1.39.0 (#4771)

• Add experimental composite samplers (#4714)
• Add new environment variables to the SDK OTEL_PYTHON_EXPORTER_OTLP_{HTTP/GRPC}_{METRICS/TRACES/LOGS}_CREDENTIAL_PROVIDER that can be used to inject a requests.Session or grpc.ChannelCredentials object into OTLP exporters created during auto instrumentation #4689.
• Filter duplicate logs out of some internal logger's logs on the export logs path that might otherwise endlessly log or cause a recursion depth exceeded issue in cases where logging itself results in an exception. (#4695).
• docs: linked the examples with their github source code location and added Prometheus example (#4728)
• Permit to override default HTTP OTLP exporters headers (#4634)
• semantic-conventions: Bump to 1.37.0 (#4731)
• opentelemetry-sdk: fix handling of OTEL_ATTRIBUTE_COUNT_LIMIT in logs (#4677)
• Performance: Cache importlib_metadata.entry_points (#4735)
• opentelemetry-sdk: fix calling Logger.emit with an API LogRecord instance (#4741)

• Add missing Prometheus exporter documentation (#4485)
• Overwrite logging.config.fileConfig and logging.config.dictConfig to ensure the OTLP LogHandler remains attached to the root logger. Fix a bug that can cause a deadlock to occur over logging._lock in some cases (#4636).
• otlp-http-exporter: set default value for param timeout_sec in _export method (#4691)
• Update OTLP gRPC/HTTP exporters: calling shutdown will now interrupt exporters that are sleeping before a retry attempt, and cause them to return failure immediately. Update BatchSpan/LogRecordProcessors: shutdown will now complete after 30 seconds of trying to finish exporting any buffered telemetry, instead of continuing to export until all telemetry was exported. (#4638).

• Update OTLP proto to v1.7 #4645.
• Add event_name as a top level field in the LogRecord. Events are now simply logs with the event_name field set, the logs SDK should be used to emit events (#4652).
• Update OTLP gRPC/HTTP exporters: the export timeout is now inclusive of all retries and backoffs. A +/-20% jitter was added to all backoffs. A pointless 32 second sleep that occurred after all retries had completed/failed was removed. (#4564).
• Update ConsoleLogExporter.export to handle LogRecord's containing bytes type in the body (#4614).
• opentelemetry-sdk: Fix invalid type: ignore that causes mypy to ignore the whole file (#4618)
• Add span_exporter property back to BatchSpanProcessor class (#4621)
• Fix license field in pyproject.toml files (#4625)
• Update logger level to NOTSET in logs example (#4637)
• Logging API accepts optional context; deprecates trace_id, span_id, trace_flags. (#4597) and (#4668)
• sdk: use context instead of trace_id,span_id for initializing LogRecord (#4653)
• Rename LogRecordProcessor.emit to on_emit (#4648)
• Logging API hide std_to_otel function to convert python logging severity to otel severity (#4649)
• proto: relax protobuf version requirement to support v6 (#4620)
• Bump semantic-conventions to 1.36.0 (#4669)
• Set expected User-Agent in HTTP headers for grpc OTLP exporter (#4658)

• typecheck: add sdk/resources and drop mypy (#4578)
• Use PEP702 for marking deprecations (#4522)
• Refactor BatchLogRecordProcessor and BatchSpanProcessor to simplify code and make the control flow more clear (#4562 #4535, and #4580).
• Remove log messages from BatchLogRecordProcessor.emit, this caused the program to crash at shutdown with a max recursion error (#4586).
• Configurable max retry timeout for grpc exporter (#4333)
• opentelemetry-api: allow importlib-metadata 8.7.0 (#4593)
• opentelemetry-test-utils: assert explicit bucket boundaries in histogram metrics (#4595)
• Bump semantic conventions to 1.34.0 (#4599)
• Drop support for Python 3.8 (#4520)

• Fix intermittent Connection aborted error when using otlp/http exporters (#4477)
• opentelemetry-sdk: use stable code attributes: code.function -> code.function.name, code.lineno -> code.line.number, code.filepath -> code.file.path (#4508)
• Fix serialization of extended attributes for logs signal (#4342)
• Handle OTEL_PROPAGATORS contains None (#4553)
• docs: updated and added to the metrics and log examples (#4559)
• Bump semantic conventions to 1.33.0 (#4567)

• Fix user agent in OTLP HTTP metrics exporter (#4475)
• Improve performance of baggage operations (#4466)
• sdk: remove duplicated constant definitions for environment_variables (#4491)
• api: Revert record BaseException change in trace_api.use_span() (#4494)
• Improve CI by cancelling stale runs and setting timeouts (#4498)
• Patch logging.basicConfig so OTel logs don't cause console logs to disappear (#4436)
• Bump semantic conventions to 1.32.0 (#4530)
• Fix ExplicitBucketHistogramAggregation to handle multiple explicit bucket boundaries advisories (#4521)
• opentelemetry-sdk: Fix serialization of objects in log handler (#4528)

• semantic-conventions: Bump to 1.31.0 (#4471)
• Add type annotations to context's attach & detach (#4346)
• Fix OTLP encoders missing instrumentation scope schema url and attributes (#4359)
• prometheus-exporter: fix labels out of place for data points with different attribute sets (#4413)
• Type indent parameter in to_json (#4402)
• Tolerates exceptions when loading resource detectors via OTEL_EXPERIMENTAL_RESOURCE_DETECTORS (#4373)
• Disconnect gRPC client stub when shutting down OTLPSpanExporter (#4370)
• opentelemetry-sdk: fix OTLP exporting of Histograms with explicit buckets advisory (#4434)
• opentelemetry-exporter-otlp-proto-grpc: better dependency version range for Python 3.13 (#4444)
• opentelemetry-exporter-opencensus: better dependency version range for Python 3.13 (#4444)
• Updated tracecontext-integration-test gitref to d782773b2cf2fa4afd6a80a93b289d8a74ca894d (#4448)
• Make trace_api.use_span() record BaseException as well as Exception (#4406)
• Fix env var error message for TraceLimits/SpanLimits (#4458)
• pylint-ci updated python version to 3.13 (#4450)
• Fix memory leak in Log & Trace exporter (#4449)

• Always setup logs sdk, OTEL_PYTHON_LOGGING_AUTO_INSTRUMENTATION_ENABLED only controls python logging module handler setup (#4340)
• Add attributes field in metrics.get_meter wrapper function (#4364)
• Add Python 3.13 support (#4353)
• sdk: don't log or print warnings when the SDK has been disabled (#4371)
• Fix span context manager typing by using ParamSpec from typing_extensions (#4389)
• Fix serialization of None values in logs body to match 1.31.0+ data model (#4400)
• [BREAKING] semantic-conventions: Remove opentelemetry.semconv.attributes.network_attributes.NETWORK_INTERFACE_NAME introduced by mistake in the wrong module. (#4391)
• Add support for explicit bucket boundaries advisory for Histograms (#4361)
• semantic-conventions: Bump to 1.30.0 (#4337)

• Fix crash exporting a log record with None body (#4276)
• Fix metrics export with exemplar and no context and filtering observable instruments (#4251)
• Fix recursion error with sdk disabled and handler added to root logger (#4259)
• sdk: setup EventLogger when OTEL_PYTHON_LOGGING_AUTO_INSTRUMENTATION_ENABLED is set (#4270)
• api: fix logging of duplicate EventLogger setup warning (#4299)
• sdk: fix setting of process owner in ProcessResourceDetector (#4311)
• sdk: fix serialization of logs severity_number field to int (#4324)
• Remove TestBase.assertEqualSpanInstrumentationInfo method, use assertEqualSpanInstrumentationScope instead (#4310)
• sdk: instantiate lazily ExemplarBuckets in ExemplarReservoirs (#4260)
• semantic-conventions: Bump to 1.29.0 (#4337)

• Removed superfluous py.typed markers and added them where they were missing (#4172)
• Include metric info in encoding exceptions (#4154)
• sdk: Add support for log formatting (#4137)
• sdk: Add Host resource detector (#4182)
• sdk: Implementation of exemplars (#4094)
• Implement events sdk (#4176)
• Update semantic conventions to version 1.28.0 (#4218)
• Add support to protobuf 5+ and drop support to protobuf 3 and 4 (#4206)
• Update environment variable descriptions to match signal (#4222)
• Record logger name as the instrumentation scope name (#4208)
• Fix memory leak in exporter and reader (#4224)
• Drop OTEL_PYTHON_EXPERIMENTAL_DISABLE_PROMETHEUS_UNIT_NORMALIZATION environment variable (#4217)
• Improve compatibility with other logging libraries that override LogRecord.getMessage() in order to customize message formatting (#4216)

• Implementation of Events API (#4054)
• Make log sdk add exception.message to logRecord for exceptions whose argument is an exception not a string message (#4122)
• Fix use of link.attributes.dropped, which may not exist (#4119)
• Running mypy on SDK resources (#4053)
• Added py.typed file to top-level module (#4084)
• Drop Final annotation from Enum in semantic conventions (#4085)
• Update log export example to not use root logger (#4090)
• sdk: Add OS resource detector (#3992)
• sdk: Accept non URL-encoded headers in OTEL_EXPORTER_OTLP_*HEADERS to match other languages SDKs (#4103)
• Update semantic conventions to version 1.27.0 (#4104)
• Add support to type bytes for OTLP AnyValue (#4128)
• Export ExponentialHistogram and ExponentialHistogramDataPoint (#4134)
• Implement Client Key and Certificate File Support for All OTLP Exporters (#4116)
• Remove _start_time_unix_nano attribute from _ViewInstrumentMatch in favor of using time_ns() at the moment when the aggregation object is created (#4137)

• Standardizing timeout calculation in measurement consumer collect to nanoseconds (#4074)
• optional scope attributes for logger creation (#4035)
• optional scope attribute for tracer creation (#4028)
• OTLP exporter is encoding invalid span/trace IDs in the logs fix (#4006)
• Update sdk process resource detector process.command_args attribute to also include the executable itself (#4032)
• Fix start_time_unix_nano for delta collection for explicit bucket histogram aggregation (#4009)
• Fix start_time_unix_nano for delta collection for sum aggregation (#4011)
• Update opentracing and opencesus docs examples to not use JaegerExporter (#4023)
• Do not execute Flask Tests in debug mode (#3956)
• When encountering an error encoding metric attributes in the OTLP exporter, log the key that had an error. (#3838)
• Fix ExponentialHistogramAggregation (#3978)
• Log a warning when a LogRecord in sdk/log has dropped attributes due to reaching limits (#3946)
• Fix RandomIdGenerator can generate invalid Span/Trace Ids (#3949)
• Add Python 3.12 to tox (#3616)
• Improve resource field structure for LogRecords (#3972)
• Update Semantic Conventions code generation scripts:
  • fix namespace exclusion that resulted in dropping os and net namespaces.
  • add Final decorator to constants to prevent collisions
  • enable mypy and fix detected issues
  • allow to drop specific attributes in preparation for Semantic Conventions v1.26.0 (#3973)
• Update semantic conventions to version 1.26.0. (#3964)
• Use semconv exception attributes for record exceptions in spans (#3979)
• Fix _encode_events assumes events.attributes.dropped exists (#3965)
• Validate links at span creation (#3991)
• Add attributes field in MeterProvider.get_meter and InstrumentationScope (#4015)
• Fix inaccessible SCHEMA_URL constants in opentelemetry-semantic-conventions (#4069)

• Fix class BoundedAttributes to have RLock rather than Lock (#3859)
• Remove thread lock by loading RuntimeContext explicitly. (#3763)
• Update proto version to v1.2.0 (#3844)
• Add to_json method to ExponentialHistogram (#3780)
• Bump mypy to 1.9.0 (#3795)
• Fix exponential histograms (#3798)
• Fix otlp exporter to export log_record.observed_timestamp (#3785)
• Add capture the fully qualified type name for raised exceptions in spans (#3837)
• Prometheus exporter sort label keys to prevent duplicate metrics when user input changes order (#3698)
• Update semantic conventions to version 1.25.0. Refactor semantic-convention structure:
  • SpanAttributes, ResourceAttributes, and MetricInstruments are deprecated.
  • Attribute and metric definitions are now grouped by the namespace.
  • Stable attributes and metrics are moved to opentelemetry.semconv.attributes and opentelemetry.semconv.metrics modules.
  • Stable and experimental attributes and metrics are defined under opentelemetry.semconv._incubating import path. (#3586)
• Rename test objects to avoid pytest warnings ([#3823] (https://github.com/open-telemetry/opentelemetry-python/pull/3823))
• Add span flags to OTLP spans and links (#3881)
• Record links with invalid SpanContext if either attributes or TraceState are not empty (#3917)
• Add OpenTelemetry trove classifiers to PyPI packages ([#3913] (https://github.com/open-telemetry/opentelemetry-python/pull/3913))
• Fix prometheus metric name and unit conversion (#3924)
  • this is a breaking change to prometheus metric names so they comply with the specification.
  • you can temporarily opt-out of the unit normalization by setting the environment variable OTEL_PYTHON_EXPERIMENTAL_DISABLE_PROMETHEUS_UNIT_NORMALIZATION=true
  • common unit abbreviations are converted to Prometheus conventions (s -> seconds), following the collector's implementation
  • repeated _ are replaced with a single _
  • unit annotations (enclosed in curly braces like {requests}) are stripped away
  • units with slash are converted e.g. m/s -> meters_per_second.
  • The exporter's API is not changed
• Add parameters for Distros and configurators to configure autoinstrumentation in addition to existing environment variables. (#3864)

• Make create_gauge non-abstract method (#3817)
• Make tracer.start_as_current_span() decorator work with async functions (#3633)
• Fix python 3.12 deprecation warning (#3751)
• bump mypy to 0.982 (#3776)
• Add support for OTEL_SDK_DISABLED environment variable (#3648)
• Fix ValueError message for PeriodicExportingMetricsReader (#3769)
• Use BaseException instead of Exception in record_exception (#3354)
• Make span.record_exception more robust (#3778)
• Fix license field in pyproject.toml files (#3803)

• Use Attribute rather than boundattribute in logrecord (#3567)
• Fix flush error when no LoggerProvider configured for LoggingHandler (#3608)
• Add Span.add_link() method to add link after span start (#3618)
• Fix OTLPMetricExporter ignores preferred_aggregation property (#3603)
• Logs: set observed_timestamp field (#3565)
• Add missing Resource SchemaURL in OTLP exporters (#3652)
• Fix loglevel warning text (#3566)
• Prometheus Exporter string representation for target_info labels (#3659)
• Logs: ObservedTimestamp field is missing in console exporter output (#3564)
• Fix explicit bucket histogram aggregation (#3429)
• Add code.lineno, code.function and code.filepath to all logs (#3675)
• Add Synchronous Gauge instrument (#3462)
• Drop support for 3.7 (#3668)
• Include key in attribute sequence warning (#3639)
• Upgrade markupsafe, Flask and related dependencies to dev and test environments (#3609)
• Handle HTTP 2XX responses as successful in OTLP exporters (#3623)
• Improve Resource Detector timeout messaging (#3645)
• Add Proxy classes for logging (#3575)
• Remove dependency on 'backoff' library (#3679)

• Prometheus exporter sanitize info metric (#3572)
• Remove Jaeger exporters (#3554)
• Log stacktrace on UNKNOWN status OTLP export error (#3536)
• Fix OTLPExporterMixin shutdown timeout period (#3524)
• Handle taskName logrecord attribute (#3557)

• Fix SumAggregation  (#3390)
• Fix handling of empty metric collection cycles (#3335)
• Fix error when no LoggerProvider configured for LoggingHandler (#3423)
• Make opentelemetry_metrics_exporter entrypoint support pull exporters (#3428)
• Allow instrument names to have '/' and up to 255 characters (#3442)
• Do not load Resource on sdk import (#3447)
• Update semantic conventions to version 1.21.0 (#3251)
• Add missing schema_url in global api for logging and metrics (#3251)
• Prometheus exporter support for auto instrumentation (#3413)
• Implement Process Resource detector (#3472)

• Modify Prometheus exporter to translate non-monotonic Sums into Gauges (#3306)

• Drop setuptools runtime requirement. (#3372)
• Update the body type in the log ($3343)
• Add max_scale option to Exponential Bucket Histogram Aggregation (#3323)
• Use BoundedAttributes instead of raw dict to extract attributes from LogRecord (#3310)
• Support dropped_attributes_count in LogRecord and exporters (#3351)
• Add unit to view instrument selection criteria (#3341)
• Upgrade opentelemetry-proto to 0.20 and regen #3355)
• Include endpoint in Grpc transient error warning #3362)
• Fixed bug where logging export is tracked as trace #3375)
• Default LogRecord observed_timestamp to current timestamp #3377)

• Select histogram aggregation with an environment variable (#3265)
• Move Protobuf encoding to its own package (#3169)
• Add experimental feature to detect resource detectors in auto instrumentation (#3181)
• Fix exporting of ExponentialBucketHistogramAggregation from opentelemetry.sdk.metrics.view (#3240)
• Fix headers types mismatch for OTLP Exporters (#3226)
• Fix suppress instrumentation for log batch processor (#3223)
• Add speced out environment variables and arguments for BatchLogRecordProcessor (#3237)
• Add benchmark tests for metrics (#3267)

• Implement LowMemory temporality (#3223)
• PeriodicExportingMetricReader will continue if collection times out (#3100)
• Fix formatting of ConsoleMetricExporter. (#3197)
• Fix use of built-in samplers in SDK configuration (#3176)
• Implement shutdown procedure forOTLP grpc exporters (#3138)
• Add exponential histogram (#2964)
• Add OpenCensus trace bridge/shim (#3210)

• Change __all__ to be statically defined. (#3143)
• Remove the ability to set a global metric prefix for Prometheus exporter (#3137)
• Adds environment variables for log exporter (#3037)
• Add attribute name to type warning message. (3124)
• Add db metric name to semantic conventions (#3115)
• Fix User-Agent header value for OTLP exporters to conform to RFC7231 & RFC7230 (#3128)
• Fix validation of baggage values (#3058)
• Fix capitalization of baggage keys (#3151)
• Bump min required api version for OTLP exporters (#3156)
• deprecate jaeger exporters (#3158)
• Create a single resource instance (#3118)

• PeriodicExportingMetricsReader with +Inf interval to support explicit metric collection (#3059)
• Regenerate opentelemetry-proto to be compatible with protobuf 3 and 4 (#3070)
• Rename parse_headers to parse_env_headers and improve error message (#2376)
• Add url decode values from OTEL_RESOURCE_ATTRIBUTES (#3046)
• Fixed circular dependency issue with custom samplers (#3026)
• Add missing entry points for OTLP/HTTP exporter (#3027)
• Update logging to include logging api as per specification (#3038)
• Fix: Avoid generator in metrics _ViewInstrumentMatch.collect() (#3035
• [exporter-otlp-proto-grpc] add user agent string (#3009)

• Add logarithm and exponent mappings (#2960)
• Add and use missing metrics environment variables (#2968)
• Enabled custom samplers via entry points (#2972)
• Update log symbol names (#2943)
• Update explicit histogram bucket boundaries (#2947)
• exporter-otlp-proto-http: add user agent string (#2959)
• Add http-metric instrument names to semantic conventions (#2976)
• [exporter/opentelemetry-exporter-otlp-proto-http] Add OTLPMetricExporter (#2891)
• Add support for py3.11 (#2997)
• Fix a bug with exporter retries for with newer versions of the backoff library (#2980)

• Add a configurable max_export_batch_size to the gRPC metrics exporter (#2809)
• Remove support for 3.6 (#2763)
• Update PeriodicExportingMetricReader to never call export() concurrently (#2873)
• Add param for indent size to LogRecord.to_json() (#2870)
• Fix: Remove LogEmitter.flush() to align with OTel Log spec (#2863)
• Bump minimum required API/SDK version for exporters that support metrics (#2918)
• Fix metric reader examples + added preferred_temporality and preferred_aggregation for ConsoleMetricExporter (#2911)
• Add support for setting OTLP export protocol with env vars, as defined in the specifications (#2893)
• Add force_flush to span exporters (#2919)

• Add force_flush method to metrics exporter (#2852)
• Change tracing to use Resource.to_json() (#2784)
• Fix get_log_emitter instrumenting_module_version args typo (#2830)
• Fix OTLP gRPC exporter warning message (#2781)
• Fix tracing decorator with late configuration (#2754)
• Fix --insecure of CLI argument (#2696)
• Add temporality and aggregation configuration for metrics exporters, use OTEL_EXPORTER_OTLP_METRICS_TEMPORALITY_PREFERENCE only for OTLP metrics exporter (#2843)
• Instrument instances are always created through a Meter (#2844)

• Fix instrument name and unit regexes (#2796)
• Add optional sessions parameter to all Exporters leveraging requests.Session (#2783
• Add min/max fields to Histogram (#2759)
• opentelemetry-exporter-otlp-proto-http Add support for OTLP/HTTP log exporter (#2462)
• Fix yield of None-valued points (#2745)
• Add missing to_json methods (#2722
• Fix type hints for textmap Getter and Setter (#2657)
• Fix LogEmitterProvider.force_flush hanging randomly (#2714)
• narrow protobuf dependencies to exclude protobuf >= 4 (#2720)
• Specify worker thread names (#2724)
• Loosen dependency on backoff for newer Python versions (#2726)
• fix: frozenset object has no attribute items (#2727)
• fix: create suppress HTTP instrumentation key in opentelemetry context (#2729)
• Support logs SDK auto instrumentation enable/disable with env (#2728)
• fix: update entry point object references for metrics (#2731)
• Allow set_status to accept the StatusCode and optional description (#2735)
• Configure auto instrumentation to support metrics (#2705)
• Add entrypoint for metrics exporter (#2748)
• Fix Jaeger propagator usage with NonRecordingSpan (#2762)
• Add opentelemetry.propagate module and opentelemetry.propagators package to the API reference documentation (#2785)

• Add parameter to MetricReader constructor to select aggregation per instrument kind (#2638)
• Add parameter to MetricReader constructor to select temporality per instrument kind (#2637)
• Fix unhandled callback exceptions on async instruments (#2614)
• Rename DefaultCounter, DefaultHistogram, DefaultObservableCounter, DefaultObservableGauge, DefaultObservableUpDownCounter, DefaultUpDownCounter instruments to NoOpCounter, NoOpHistogram, NoOpObservableCounter, NoOpObservableGauge, NoOpObservableUpDownCounter, NoOpUpDownCounter (#2616)
• Deprecate InstrumentationLibraryInfo and Add InstrumentationScope (#2583)

• Rename API Measurement for async instruments to Observation (#2617)
• Add support for zero or more callbacks (#2602)
• Fix parsing of trace flags when extracting traceparent (#2577)
• Add default aggregation (#2543)
• Fix incorrect installation of some exporter “convenience” packages into “site-packages/src” (#2525)
• Capture exception information as part of log attributes (#2531)
• Change OTLPHandler to LoggingHandler (#2528)
• Fix delta histogram sum not being reset on collection (#2533)
• Add InMemoryMetricReader to metrics SDK (#2540)
• Drop the usage of name field from log model in OTLP (#2565)
• Update opentelemetry-proto to v0.15.0 (#2566)
• Remove enable_default_view option from sdk MeterProvider (#2547)
• Update otlp-proto-grpc and otlp-proto-http exporters to have more lax requirements for backoff lib (#2575)
• Add min/max to histogram point (#2581)
• Update opentelemetry-proto to v0.16.0 (#2619)

• Docs rework: non-API docs are moving to opentelemetry.io. For details, including a list of pages that have moved, see #2453, and #2498.
• opentelemetry-exporter-otlp-proto-grpc update SDK dependency to ~1.9. (#2442)
• bugfix(auto-instrumentation): attach OTLPHandler to root logger (#2450)
• Bump semantic conventions from 1.6.1 to 1.8.0 (#2461)
• fix exception handling in get_aggregated_resources (#2464)
• Fix OTEL_EXPORTER_OTLP_ENDPOINT usage in OTLP HTTP trace exporter (#2493)
• [exporter/opentelemetry-exporter-prometheus] restore package using the new metrics API (#2321)

Added

• Add support for OTLP v0.6.0 (#1472)
• Add protobuf via gRPC exporting support for Jaeger (#1471)
• Add support for Python 3.9 (#1441)
• Added the ability to disable instrumenting libraries specified by OTEL_PYTHON_DISABLED_INSTRUMENTATIONS env variable, when using opentelemetry-instrument command. (#1461)
• Add fields to propagators (#1374)
• Add local/remote samplers to parent based sampler (#1440)
• Add support for OTEL_SPAN_{ATTRIBUTE_COUNT_LIMIT,EVENT_COUNT_LIMIT,LINK_COUNT_LIMIT} (#1377)
• Return None for DictGetter if key not found (#1449)
• Added support for Jaeger propagator (#1219)
• Remove dependency on SDK from opentelemetry-instrumentation package. The opentelemetry-sdk package now registers an entrypoint opentelemetry_configurator to allow opentelemetry-instrument to load the configuration for the SDK (#1420)
• opentelemetry-exporter-zipkin Add support for array attributes in Span and Resource exports (#1285)
• Added __repr__ for DefaultSpan, added trace_flags to __repr__ of SpanContext (#1485])
• opentelemetry-sdk Add support for OTEL_TRACE_SAMPLER and OTEL_TRACE_SAMPLER_ARG env variables (#1496)
• Adding opentelemetry-distro package to add default configuration for span exporter to OTLP (#1482)

Changed

• opentelemetry-exporter-zipkin Updated zipkin exporter status code and error tag (#1486)
• Recreate span on every run of a start_as_current_span-decorated function (#1451)
• opentelemetry-exporter-otlp Headers are now passed in as tuple as metadata, instead of a string, which was incorrect. (#1507)
• opentelemetry-exporter-jaeger Updated Jaeger exporter status code tag (#1488)
• opentelemetry-api opentelemety-sdk Moved idsgenerator into sdk (#1514)
• opentelemetry-sdk The B3Format propagator has been moved into its own package: opentelemetry-propagator-b3 (#1513)
• Update default port for OTLP exporter from 55680 to 4317 (#1516)
• opentelemetry-exporter-zipkin Update boolean attribute value transformation (#1509)
• Move opentelemetry-opentracing-shim out of instrumentation folder (#1533)
• opentelemetry-sdk The JaegerPropagator has been moved into its own package: opentelemetry-propagator-jaeger (#1525)
• opentelemetry-exporter-jaeger, opentelemetry-exporter-zipkin Update InstrumentationInfo tag keys for Jaeger and Zipkin exporters (#1535)
• opentelemetry-sdk Remove rate property setter from TraceIdRatioBasedSampler (#1536)
• Fix TraceState to adhere to specs (#1502)

Removed

• opentelemetry-api Remove ThreadLocalRuntimeContext since python3.4 is not supported. (#1482)

opentelemetry-sdk

• Add meter reference to observers to fix #1424

One major change done as part of this release was to move the instrumentation out of the core repo and into the contrib repo. This change should not impact users of the published packages, but the release notes for instrumentation packages will now be available in the contrib repo.

opentelemetry-api

🚀 Enhancements

• Add optional parameter to record_exception method (#1314)
• Add pickle support to SpanContext class (#1380)

opentelemetry-instrumentation

🚀 Enhancements

• Added support for OTEL_EXPORTER to the opentelemetry-instrument command (#1036)
• Add IDs Generator as Configurable Property of Auto Instrumentation (#1404)
• Add missing references to instrumented packages (#1416)
• Instrumentation Package depends on the OTel SDK (#1405)

opentelemetry-proto

💥 Breaking Changes

• Update protobuf versions (#1356)

opentelemetry-sdk

💥 Breaking Changes

• Rename MetricRecord class to ExportRecord (#1367)
• Rename Record class to Accumulation (#1373)
• Rename Meter class to Accumulator (#1372)

🚀 Enhancements)

• Add optional parameter to record_exception method (#1314)

• Update exception handling optional parameters, add escaped attribute to record_exception (#1365)

• Allow samplers to modify tracestate (#1319)
• Fix ParentBased sampler for implicit parent spans. Fix also trace_state erasure for dropped spans or spans sampled by the TraceIdRatioBased sampler. (#1394)

opentelemetry-exporter-jaeger

🚀 Enhancements

• Fix Jaeger exporter to correctly translate span.kind attribute (#1329)

opentelemetry-exporter-opencensus

💥 Breaking Changes

• Update protobuf versions (#1356)

opentelemetry-exporter-otlp

🚀 Enhancements

• Add Gzip compression for exporter (#1141)
• Handle error case when no credentials supplied (#1366)
• Change temporality for Counter and UpDownCounter (#1384)
• Add instrumentation library name and version to OTLP exported metrics (#1418)

opentelemetry-exporter-zipkin

🚀 Enhancements

• Support for v2 api protobuf format (#1318)

opentelemetry-api

💥 Breaking Changes

• Updating status codes to adhere to spec (#1282)

🚀 Enhancements

• Add keys method to TextMap propagator Getter (#1196)
• Fix ConsoleSpanExporter exception (#1246)
• Updating limits for attributes, events, links (#1249)

opentelemetry-sdk

💥 Breaking Changes

• Updating status codes to adhere to specs (#1282)
• Split up metric instrument constructors (#1254)

🚀 Enhancements

• Allow None in sequence attributes values (#998)
• Set initial checkpoint timestamp in aggregators (#1237)
• Span.is_recording() returns false after span has ended (#1289)
• Fix b3 propagator entrypoint (#1265)
• Samplers to accept parent Context (#1267)
• Add keys method to TextMap propagator Getter (#1196)
• Make SpanProcessor.on_start accept parent Context (#1251)
• Remove TracerProvider coupling from Tracer init (#1295)

opentelemetry-exporter-datadog

🚀 Enhancements

• Make SpanProcessor.on_start accept parent Context (#1251)

opentelemetry-exporter-jaeger

🚀 Enhancements

• Add support for Jaeger Span Exporter configuration by environment variables and change JaegerSpanExporter constructor parameters (#1114)

opentelemetry-exporter-otlp

🚀 Enhancements

• Add Env variables in OTLP exporter (#1101)
• Do not use bound instruments in OTLP exporter (#1237)

opentelemetry-instrumentation-django

🚀 Enhancements

• Django instrumentation is now enabled by default but can be disabled by setting OTEL_PYTHON_DJANGO_INSTRUMENT to False (#1239)
• Span name resolves correctly for paths that also require a query parameter to match (#1309)
• Added capture of http.route (#1226)
• Add support for tracking http metrics (#1230)
• Record span status and http.status_code attribute on exception (#1257)

opentelemetry-instrumentation-flask

🚀 Enhancements

• Use url.rule instead of request.endpoint for span name (#1260)

opentelemetry-instrumentation-grpc

🚀 Enhancements

• Rewrite gRPC server interceptor (#1171)

opentelemetry-instrumentation-requests

🚀 Enhancements

• Add support for tracking http metrics (#1116)

opentelemetry-api

💥 Breaking Changes

• Update baggage propagation header (#1194)
• Parent is now always passed in via Context, intead of Span or SpanContext (#1146)

🚀 Enhancements

• Add support for OTEL_PROPAGATORS (#1123)
• Store ints as ints in the global Configuration object (#1118)
• Make instances of SpanContext immutable (#1134)
• Allow for Custom Trace and Span IDs Generation - IdsGenerator for TracerProvider (#1153)

opentelemetry-sdk

💥 Breaking Changes

• Update sampling result names (#1128)
• Renaming metrics Batcher to Processor (#1203)
• Parent is now always passed in via Context, intead of Span or SpanContext (#1146)

🚀 Enhancements

• Add timestamps to aggregators (#1199)
• Add Global Error Handler (#1080)
• Add support for OTEL_BSP_MAX_QUEUE_SIZE, OTEL_BSP_SCHEDULE_DELAY_MILLIS, OTEL_BSP_MAX_EXPORT_BATCH_SIZE and OTEL_BSP_EXPORT_TIMEOUT_MILLIS environment variables (#1105)
• Allow for Custom Trace and Span IDs Generation - IdsGenerator for TracerProvider (#1153)
• Event attributes are now immutable (#1195)
• Protect access to Span implementation (#1188)
• start_as_current_span and use_span can now optionally auto-record any exceptions raised inside the context manager. (#1162)
• Adding Resource to MeterRecord (#1209)

opentelemetry-exporter-datadog

🚀 Enhancements

• Add support for span resource labels and service name (#1074)

opentelemetry-exporter-otlp

💥 Breaking Changes

• Update OpenTelemetry protos to v0.5.0 (#1143)

🚀 Enhancements

• Add support for span resource labels and service name (#1074)
• Add timestamps to OTLP exporter (#1199)

opentelemetry-exporter-zipkin

🚀 Enhancements

• Add support for span resource labels and service name (#1074)
• Zipkin exporter now accepts a max_tag_value_length attribute to customize the maximum allowed size a tag value can have. (#1151)

opentelemetry-instrumentation-celery

🚀 Enhancements

• Span operation names now include the task type. (#1135)
• Added automatic context propagation. (#1135)

opentelemetry-instrumentation-django

🚀 Enhancements

• Changed span name extraction from request to comply semantic convention (#992)
• Added support for OTEL_PYTHON_DJANGO_TRACED_REQUEST_ATTRS (#1154)

opentelemetry-instrumentation-falcon

🚀 Enhancements

• Added support for OTEL_PYTHON_FALCON_TRACED_REQUEST_ATTRS (#1158)

opentelemetry-instrumentation-pymysql

🚀 Enhancements

• Bumped version from 0.9.3 to 0.10.1 (#1228)

opentelemetry-instrumentation-system-metrics

🐛 Bug Fixes

• Fix issue when specific metrics are not available in certain OS (#1207)

opentelemetry-instrumentation-tornado

🚀 Enhancements

• Added support for OTEL_PYTHON_TORNADO_TRACED_REQUEST_ATTRS (#1178)

opentelemetry-instrumentation

🚀 Enhancements

• Add support for http metrics (#1116)

🐛 Bug Fixes

• Fixed boostrap command to correctly install opentelemetry-instrumentation-falcon instead of opentelemetry-instrumentation-flask (#1138)

The 0.13b0 version officially drops support for Python 3.4 (#1099)

opentelemetry-api

💥 Breaking Changes

• Refactor SpanContext.is_valid from a method to a data attribute (#1005)
• Moved samplers from API to SDK (#1023)
• Change is_recording_events to is_recording (#1034)
• Remove lazy Event and Link API from Span interface (#1045)
• Rename CorrelationContext to Baggage (#1060)
• Rename HTTPTextFormat to TextMapPropagator. This change also updates get_global_httptextformat and set_global_httptextformat to get_global_textmap and set_global_textmap (#1085)

🐛 Bug Fixes

• Change return value type of correlationcontext.get_correlations to immutable MappingProxyType (#1024)
• Fix api/sdk setup.cfg to include missing python files (#1091)

opentelemetry-sdk

💥 Breaking Changes

• Moved samplers from API to SDK (#1023)
• Sampling spec changes (#1034)
• Remove lazy Event and Link API from Span interface (#1045)
• Rename Resource labels to attributes (#1082)
• Rename members of trace.sampling.Decision enum (#1115)

🚀 Enhancements

• Improve BatchExportSpanProcessor (#1062)
• Populate resource attributes as per semantic conventions (#1053)

🐛 Bug Fixes

• Fix api/sdk setup.cfg to include missing python files (#1091)

opentelemetry-exporter-jaeger

🚀 Enhancements

• Report instrumentation info (#1098)

opentelemetry-exporter-otlp

🚀 Enhancements

• Add instrumentation info to exported spans (#1095)
• Add metric OTLP exporter (#835)

opentelemetry-exporter-zipkin

🚀 Enhancements

• Add support for OTEL_EXPORTER_ZIPKIN_ENDPOINT env var. As part of this change, the configuration of the ZipkinSpanExporter exposes a url argument to replace host_name, port, protocol, endpoint. This brings this implementation inline with other implementations. (#1064)
• Zipkin exporter report instrumentation info. (#1097)

opentelemetry-instrumentation-aiohttp-client

🚀 Enhancements

• Updating span name to match semantic conventions (#972)

opentelemetry-instrumentation-dbapi

🐛 Bug Fixes

• cursors and connections now produce spans when used with context managers (#1028)

opentelemetry-instrumentation-falcon

🚀 Enhancements

• Initial release. Added instrumentation for Falcon 2.0+

opentelemetry-instrumentation-tornado

🚀 Enhancements

• Initial release. Supports Tornado 6.x on Python 3.5 and newer

Added

• Implement Views in metrics SDK (#596)

Changed

• Update environment variable names, prefix changed from OPENTELEMETRY to OTEL (#904)
• Stop TracerProvider and MeterProvider from being overridden (#959)
• Update default port to 55680 (#977)
• Add proper length zero padding to hex strings of traceId, spanId, parentId sent on the wire, for compatibility with jaeger-collector (#908)
• Send start_timestamp and convert labels to strings (#937)
• Renamed several packages (#953)
• Thrift URL for Jaeger exporter doesn't allow HTTPS (hardcoded to HTTP) (#978)
• Change reference names to opentelemetry-instrumentation-opentracing-shim (#969)
• Changed default Sampler to ParentOrElse(AlwaysOn) (#960)
• Update environment variable names, prefix changed from OPENTELEMETRY to OTEL (#904)
• Update environment variable OTEL_RESOURCE to OTEL_RESOURCE_ATTRIBUTES as per the specification