v1.41.1: Version 1.41.1/0.62b1

Compare Source

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

v1.41.0

Compare Source

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

v1.40.0

Compare Source

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

v1.39.1: Version 1.39.1/0.60b1

Compare Source

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)

v1.39.0

Compare Source

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

• feat: implement on ending in span processor
  (#​4775)

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

v1.38.0

Compare Source

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

v1.37.0

Compare Source

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

v1.36.0

Compare Source

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