open-telemetry/opentelemetry-specification v1.62.0

Release 1.62.0

on GitHub

Traces

• Add Sampler.Shutdown operation.
  (#5335)
• Clarify that calls to the Development SpanProcessor.OnEnding method are not
  allowed after Shutdown.
  (#5316)

Metrics

• Specify that Shutdown of the periodic exporting MetricReader MUST include
  the effects of ForceFlush.
  (#5305)

Logs

• Add systemd-journald example mapping to the logs data model appendix and align syslog mapping.
  (#4995)

Resource

• Update resource detectors to generate entities and indicate resource detectors should be entity-aware
  unless new OTEL_EXPERIMENTAL_ENTITIES_ENABLED != true.
  (#5147)

Entities

• Add in-development entity-resource startup specification.
  (#5057)
• Remove OTEL_ENTITIES from general env var configuration spec.
  (#5147)

Common

• Stabilize Attribute and Attribute Collection representation for non-OTLP.
  (#5149)

OpenTelemetry Protocol

• Clarify that the OTLP exporter timeout bounds the entire batch export,
  including all request attempts and waits between retries, and that earlier
  caller deadlines take precedence.
  (#5347)

Compatibility

• Stabilize Prometheus Unknown-typed metric transformation.
  (#5213)
• Stabilize Prometheus Info metric transformation.
  (#5211)

SDK Configuration

• Declarative config should gracefully degrade when encountering unrecognized
  resource detectors. Other SDK plugin components continue to produce errors
  when missing.
  (#5323)

Supplementary Guidelines

• Allow narrowly scoped security-related changes to stable SDK and Contrib
  behavior, configuration defaults, supported values, and emitted telemetry
  without a major version bump, while preserving API compatibility and requiring
  release notes describing the security rationale, user impact, and migration.
  (#5357)

OTEPs

• Add OTEP proposing a top-level span type field in API, SDK, and OTLP.
  (#5233)