opentelemetry-api 1.39.0

Version 1.39.0/0.60b0

on Python PyPI

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)