opentelemetry-api

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 https://github.com/open-telemetry/opentelemetry-python/pull/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)

Breaking Changes

We are working on stabilizing the Log signal that would require making deprecations and breaking changes. We will try to reduce the releases that may require an update to your code, especially for instrumentations or for sdk developers.

• Rename LogRecordProcessor.emit to on_emit (#4648)

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

• opentelemetry-sdk: Fix invalid type: ignore that causes mypy to ignore the whole file (#4618)
• Add span_exporter property back to BatchSpanProcessor class (#4621)

• typecheck: add sdk/resources and drop mypy (#4578)
• Refactor BatchLogRecordProcessor to simplify code and make the control flow more clear (#4562 and #4535).
• 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)

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

• Remove log messages from BatchLogRecordProcessor.emit, this caused the program to crash at shutdown with a max recursion error (#4586).

• 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)

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

• 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)

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

• api: Revert record BaseException change in trace_api.use_span() (#4494)

• 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)

• 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)

This is a patch release on the previous 1.28.1/0.49b1 release, fixing the issue(s) below.

• Fix crash exporting a log record with None body (#4276)
• sdk: setup EventLogger when OTEL_PYTHON_LOGGING_AUTO_INSTRUMENTATION_ENABLED is set (#4270)

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

• 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)

• 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)

• 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] (https://github.com/open-telemetry/opentelemetry-python/pull/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)
• 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 (#3645)
• 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)

• 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)

• 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)

• 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)

• 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)

What's Changed

• Stop MeterProvier attribute error message from showing up by @ocelotl in https://github.com/open-telemetry/opentelemetry-python/pull/2875
• Update PeriodicExportingMetricReader to never call export() concurrently by @aabmass in https://github.com/open-telemetry/opentelemetry-python/pull/2873
• Fix typos by @kianmeng in https://github.com/open-telemetry/opentelemetry-python/pull/2868
• Adding Codespell to the CI by @galbash in https://github.com/open-telemetry/opentelemetry-python/pull/2878
• Skip LICENSE files for spellcheck by @srikanthccv in https://github.com/open-telemetry/opentelemetry-python/pull/2879
• Add param for indent size to LogRecord.to_json() by @dougramirez in https://github.com/open-telemetry/opentelemetry-python/pull/2870
• Remove LogEmitter.flush() to align with OTel Log Spec by @pranavmarla in https://github.com/open-telemetry/opentelemetry-python/pull/2863
• Mark test as flaky by @ocelotl in https://github.com/open-telemetry/opentelemetry-python/pull/2886
• Remove support for 3.6 by @ocelotl in https://github.com/open-telemetry/opentelemetry-python/pull/2763
• Update package metadata opentelemetry-api by @ofek in https://github.com/open-telemetry/opentelemetry-python/pull/2867
• Refactor testing console exporter by @ocelotl in https://github.com/open-telemetry/opentelemetry-python/pull/2877
• Update package metadata opentelemetry-proto by @ofek in https://github.com/open-telemetry/opentelemetry-python/pull/2905
• Update package metadata opentelemetry-sdk by @ofek in https://github.com/open-telemetry/opentelemetry-python/pull/2906
• Update package metadata opentelemetry-semantic-conventions by @ofek in https://github.com/open-telemetry/opentelemetry-python/pull/2907
• Update package metadata opentelemetry-propagator-b3 by @ofek in https://github.com/open-telemetry/opentelemetry-python/pull/2908
• Update package metadata opentelemetry-propagator-jaeger by @ofek in https://github.com/open-telemetry/opentelemetry-python/pull/2909
• Update package metadata opentelemetry-exporter-jaeger-thrift by @ofek in https://github.com/open-telemetry/opentelemetry-python/pull/2896
• Update package metadata opentelemetry-exporter-zipkin-json by @ofek in https://github.com/open-telemetry/opentelemetry-python/pull/2903
• Update package metadata opentelemetry-exporter-opencensus by @ofek in https://github.com/open-telemetry/opentelemetry-python/pull/2897
• Update package metadata opentelemetry-exporter-zipkin-proto-http by @ofek in https://github.com/open-telemetry/opentelemetry-python/pull/2904
• Update package metadata opentelemetry-exporter-zipkin by @ofek in https://github.com/open-telemetry/opentelemetry-python/pull/2902
• Update package metadata opentelemetry-exporter-prometheus by @ofek in https://github.com/open-telemetry/opentelemetry-python/pull/2901
• Update package metadata opentelemetry-exporter-otlp-proto-http by @ofek in https://github.com/open-telemetry/opentelemetry-python/pull/2900
• Update package metadata opentelemetry-exporter-otlp-proto-grpc by @ofek in https://github.com/open-telemetry/opentelemetry-python/pull/2899
• Update package metadata opentelemetry-exporter-jaeger-proto-grpc by @ofek in https://github.com/open-telemetry/opentelemetry-python/pull/2895
• Update package metadata opentelemetry-exporter-otlp by @ofek in https://github.com/open-telemetry/opentelemetry-python/pull/2898
• Update package metadata opentelemetry-exporter-jaeger by @ofek in https://github.com/open-telemetry/opentelemetry-python/pull/2894
• Update package metadata opentelemetry-opentracing-shim by @ofek in https://github.com/open-telemetry/opentelemetry-python/pull/2912
• Update package metadata docs/examples/error_handler by @ofek in https://github.com/open-telemetry/opentelemetry-python/pull/2914
• Update package metadata opentelemetry-test-utils by @ofek in https://github.com/open-telemetry/opentelemetry-python/pull/2913
• Update README.md by @srikanthccv in https://github.com/open-telemetry/opentelemetry-python/pull/2916
• Adding support for setting OTLP exporter protocol by env vars by @ronyis in https://github.com/open-telemetry/opentelemetry-python/pull/2893
• Fix preferred_aggregation + preferred_temporality example by @lzchen in https://github.com/open-telemetry/opentelemetry-python/pull/2911
• Bump API/SDK version for exporters by @srikanthccv in https://github.com/open-telemetry/opentelemetry-python/pull/2918
• Add a configurable max_export_batch_size to the gRPC metrics exporter by @overmeulen in https://github.com/open-telemetry/opentelemetry-python/pull/2809
• Update scripts and lint configs by @srikanthccv in https://github.com/open-telemetry/opentelemetry-python/pull/2929
• Update contrib repo SHA by @ocelotl in https://github.com/open-telemetry/opentelemetry-python/pull/2937
• Add force_flush to span exporters by @srikanthccv in https://github.com/open-telemetry/opentelemetry-python/pull/2919
• Update scripts by @srikanthccv in https://github.com/open-telemetry/opentelemetry-python/pull/2944
• updating changelogs and version to 1.13.0-0.34b0 by @srikanthccv in https://github.com/open-telemetry/opentelemetry-python/pull/2950

New Contributors

• @kianmeng made their first contribution in https://github.com/open-telemetry/opentelemetry-python/pull/2868
• @galbash made their first contribution in https://github.com/open-telemetry/opentelemetry-python/pull/2878
• @dougramirez made their first contribution in https://github.com/open-telemetry/opentelemetry-python/pull/2870
• @pranavmarla made their first contribution in https://github.com/open-telemetry/opentelemetry-python/pull/2863
• @ofek made their first contribution in https://github.com/open-telemetry/opentelemetry-python/pull/2867
• @ronyis made their first contribution in https://github.com/open-telemetry/opentelemetry-python/pull/2893

Full Changelog: https://github.com/open-telemetry/opentelemetry-python/compare/v1.12.0...v1.13.0

• 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)

• Fix LoggingHandler to handle LogRecord with exc_info=False (#2690)
• Make metrics components public (#2684)
• Update to semantic conventions v1.11.0 (#2669)
• Update opentelemetry-proto to v0.17.0 (#2668)
• Add CallbackOptions to observable instrument callback params (#2664)
• Add timeouts to metric SDK (#2653)
• Add variadic arguments to metric exporter/reader interfaces (#2654)
• Added a opentelemetry.sdk.resources.ProcessResourceDetector that adds the 'process.runtime.{name,version,description}' resource attributes when used with the opentelemetry.sdk.resources.get_aggregated_resources API (#2660)
• Move Metrics API behind internal package (#2651)

This release includes the release candidate for metrics.

• 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)

• 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)

• 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-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)

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

Changes

• Update opentelemetry-proto to v0.12.0. Note that this update removes deprecated status codes. (#2415)

Changes

• Fix SpanLimits global span limit defaulting when set to 0 (#2398)
• Add Python version support policy (#2397)
• Decode URL-encoded headers in environment variables (#2312)
• [exporter/opentelemetry-exporter-otlp-proto-grpc] Add OTLPMetricExporter (#2323)
• Complete metric exporter format and update OTLP exporter (#2364)
• [api] Add NoOpTracer and NoOpTracerProvider. Marking _DefaultTracer and _DefaultTracerProvider as deprecated. (#2363)
• [exporter/opentelemetry-exporter-otlp-proto-grpc] Add Sum to OTLPMetricExporter (#2370)
• [api] Rename _DefaultMeter and _DefaultMeterProvider to NoOpMeter and NoOpMeterProvider. (#2383)
• [exporter/opentelemetry-exporter-otlp-proto-grpc] Add Gauge to OTLPMetricExporter (#2408)
• [logs] prevent None from causing problems (#2410)

##Changes

• Adds Aggregation and instruments as part of Metrics SDK (#2234)
• Update visibility of OTEL_METRICS_EXPORTER environment variable (#2303)
• Adding entrypoints for log emitter provider and console, otlp log exporters (#2253)
• Rename ConsoleExporter to ConsoleLogExporter (#2307)
• Adding OTEL_LOGS_EXPORTER environment variable (#2320)
• Add otlp entrypoint for log exporter (#2322)

Happy Holidays 🎅 ☃️

Highlights

• Experimental release for logging SDK 🎉 (https://github.com/open-telemetry/opentelemetry-python/tree/main/opentelemetry-sdk/src/opentelemetry/sdk/_logs)
• Python 3.10 is now officially supported 🎉

Changelog

• Add support for Python 3.10 (#2207)
• remove X-B3-ParentSpanId for B3 propagator as per OpenTelemetry specification (#2237)
• Populate auto.version in Resource if using auto-instrumentation (#2243)
• Return proxy instruments from ProxyMeter [#2169]
• Make Measurement a concrete class (#2153)
• Add metrics API (#1887)
• Make batch processor fork aware and reinit when needed (#2242)
• opentelemetry-sdk Sanitize env var resource attribute pairs (#2256)
• opentelemetry-test start releasing to pypi.org (#2269)

This version was partially released. Please use 1.7.1 & 0.26b1 instead.

• Fix parental trace relationship for opentracing follows_from reference (#2180)

• Upgrade GRPC/protobuf related dependency and regenerate otlp protobufs (#2201)
• Propagation: only warn about oversized baggage headers when headers exist (#2212)
• Migrate instrumentation and disro to contrib (#2196)

• Fix race in set_tracer_provider() (#2182)
• Automatically load OTEL environment variables as options for opentelemetry-instrument (#1969)
• opentelemetry-semantic-conventions Update to semantic conventions v1.6.1 (#2077)
• Do not count invalid attributes for dropped (#2096)
• Fix propagation bug caused by counting skipped entries (#2071)
• Add entry point for exporters with default protocol (#2093)
• Do not skip sequence attribute on decode error (#2097)
• opentelemetry-test: Add HttpTestBase to allow tests with actual TCP sockets (#2101)
• Fix incorrect headers parsing via environment variables (#2103)
• Add support for OTEL_ATTRIBUTE_COUNT_LIMIT (#2139)
• Attribute limits no longer apply to Resource attributes (#2138)
• opentelemetry-exporter-otlp: Add opentelemetry-otlp-proto-http as dependency (#2147)
• Fix validity calculation for trace and span IDs (#2145)
• Add schema_url to TracerProvider.get_tracer (#2154)
• Make baggage implementation w3c spec complaint (#2167)

Added

• Add Trace ID validation to meet TraceID spec (#1992)
• opentelemetry-sdk added support for OTEL_SPAN_ATTRIBUTE_VALUE_LENGTH_LIMIT (#2044)
• opentelemetry-sdk Add support for OTEL_ATTRIBUTE_VALUE_LENGTH_LIMIT env var (#2056)

Changed

• opentelemetry-sdk get_aggregated_resource() returns default resource and service name whenever called (#2013)
• opentelemetry-distro & opentelemetry-sdk Moved Auto Instrumentation Configurator code to SDK to let distros use its default implementation (#1937)
• opentelemetry-sdk Treat limit even vars set to empty values as unset/unlimited. (#2054)
• opentelemetry-api Attribute keys must be non-empty strings. (#2057)

Fixed

• Fix documentation on well known exporters and variable OTEL_TRACES_EXPORTER which were misnamed (#2023)
• Fixed Python 3.10 incompatibility in opentelemetry-opentracing-shim tests (#2018)
• opentelemetry-sdk Fixed bugs (#2041, #2042 & #2045) in Span Limits (#2044)

Hotfix to address https://github.com/open-telemetry/opentelemetry-python/issues/1988

Added

• opentelemetry-semantic-conventions Generate semconv constants update for OTel Spec 1.5.0 (#1946)
• Moved opentelemetry-instrumentation to core repository. (#1959)
• Dropped attributes/events/links count available exposed on ReadableSpans. (#1893)
• Added dropped count to otlp, jaeger and zipkin exporters. (#1893)

Changed

• Updated opentelemetry-opencensus-exporter to use service_name of spans instead of resource (#1897)
• Added descriptions to the env variables mentioned in the opentelemetry-specification (#1898)
• Ignore calls to Span.set_status with StatusCode.UNSET and also if previous status already had StatusCode.OK. (#1902)
• Attributes for Link and Resource are immutable as they are for Event, which means any attempt to modify attributes directly will result in a TypeError exception. (#1909)
• Added BoundedAttributes to the API to make it available for Link which is defined in the API. Marked BoundedDict in the SDK as deprecated as a result. (#1915)
• Fix OTLP SpanExporter to distinguish spans based off Resource and InstrumentationInfo (#1927)
• Updating dependency for opentelemetry api/sdk packages to support major version instead of pinning to specific versions. (#1933)

Fixed

• Updated opentelementry-opentracing-shim ScopeShim to report exceptions in opentelemetry specification format, rather than opentracing spec format. (#1878)