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)

• Addopentelemetry-exporter-credential-provider-gcp as an optional dependency toopentelemetry-exporter-otlp-proto-grpc andopentelemetry-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 fromSequence[LogData] toSequence[ReadableLogRecord]

    # Beforefromopentelemetry.sdk._logsimportLogDatadefexport(self,batch:Sequence[LogData])->LogRecordExportResult:    ...# Afterfromopentelemetry.sdk._logsimportReadableLogRecorddefexport(self,batch:Sequence[ReadableLogRecord])->LogRecordExportResult:    ...

  • For Log Processors: UseReadWriteLogRecord for processing,ReadableLogRecord for exporting

    # Beforefromopentelemetry.sdk._logsimportLogDatadefon_emit(self,log_data:LogData):    ...# Afterfromopentelemetry.sdk._logsimportReadWriteLogRecord,ReadableLogRecorddefon_emit(self,log_record:ReadWriteLogRecord):# Convert to ReadableLogRecord before exportingreadable=ReadableLogRecord(log_record=log_record.log_record,resource=log_record.resourceorResource.create({}),instrumentation_scope=log_record.instrumentation_scope,limits=log_record.limits,    )    ...

  • Accessing log data: Use the same attributes onReadableLogRecord/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 aLogRecord with theevent_name field set (#4654).

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

• Addrstcheck 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 SDKOTEL_PYTHON_EXPORTER_OTLP_{HTTP/GRPC}_{METRICS/TRACES/LOGS}_CREDENTIAL_PROVIDER that can be used to inject arequests.Session orgrpc.ChannelCredentials object into OTLP exporters created during auto instrumentation#4689.
• Filter duplicate logs out of some internallogger'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: Cacheimportlib_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 OTLPLogHandler remains attached to the root logger. Fix a bug that can cause a deadlock to occur overlogging._lock in some cases (#4636).

• otlp-http-exporter: set default value for paramtimeout_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.
• Addevent_name as a top level field in theLogRecord. Events are now simply logs with theevent_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 invalidtype: ignore that causes mypy to ignore the whole file (#4618)
• Addspan_exporter property back toBatchSpanProcessor class (#4621)
• Fix license field in pyproject.toml files (#4625)
• Update logger level to NOTSET in logs example (#4637)
• Logging API accepts optionalcontext; deprecatestrace_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 invalidtype: ignore that causes mypy to ignore the whole file (#4618)
• Addspan_exporter property back toBatchSpanProcessor class (#4621)

• typecheck: add sdk/resources and drop mypy (#4578)
• RefactorBatchLogRecordProcessor to simplify code and make the control flow more clear (#4562 and#4535).
• Use PEP702 for marking deprecations (#4522)
• RefactorBatchLogRecordProcessor andBatchSpanProcessor to simplify code and make the control flow more clear (#4562#4535, and#4580).
• Remove log messages fromBatchLogRecordProcessor.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 fromBatchLogRecordProcessor.emit, this caused the program to crash at shutdown with a max recursion error (#4586).

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