Release 1.40.0

v1.40.0 (2024-12-12)

Context

• Adds optional GetAll method to Getter in Propagation API, allowing for the retrieval of multiple values for the same key.
  #4295

Traces

• Add in-development support for otlp/stdout exporter via OTEL_TRACES_EXPORTER.
  (#4183)
• Remove the recommendation to not synchronize access to TracerConfig.disabled.
  (#4310)

Metrics

• Add in-development support for otlp/stdout exporter via OTEL_METRICS_EXPORTER.
  (#4183)
• Remove the recommendation to not synchronize access to MeterConfig.disabled.
  (#4310)

Logs

• Add in-development support for otlp/stdout exporter via OTEL_LOGS_EXPORTER.
  (#4183)
• Remove the recommendation to not synchronize access to LoggerConfig.disabled.
  (#4310)
• Remove the in-development isolating log record processor.
  (#4301)

Events

• Deprecate Events API and SDK in favor of having Events support in the Logs API and SDK.
  (#4319)
• Change event.name attribute into top-level event name field.
  (#4320)

Common

• Lay out core principles for Specification changes.
  (#4286)

Supplementary Guidelines

• Add core principles for evaluating specification changes.
  (#4286)

OTEPs

• The open-telemetry/oteps repository was merged into the specification repository.
  (#4288)

New Contributors

• @CharlieTLe made their first contribution in #4289
• @jamesmoessis made their first contribution in #4295

Release 1.39.0

v1.39.0 (2024-11-07)

Logs

• Simplify the name "Logs Instrumentation API" to just "Logs API".
  (#4258)
• Rename Log Bridge API to Logs API. Define the existing Logger methods to be
  Log Bridge Operations. Add EmitEvent to the Logger as an Instrumentation Operation.
  (#4259)

Profiles

• Define required attributes for Mappings.
  (#4197)

Compatibility

• Add requirement to allow extending Stable APIs.
  (#4270)

SDK Configuration

• Clarify declarative configuration parse requirements for null vs empty.
  (#4269)

Common

• Define prototype for proposed features in development.
  (#4273)

New Contributors

• @florianl made their first contribution in #4197

Release 1.38.0

v1.38.0 (2024-10-10)

Traces

• Make all fields as identifying for Tracer. Previously attributes were omitted from being identifying.
  (#4161)
• Clarify that Export MUST NOT be called by simple and batching processors concurrently.
  (#4205)

Metrics

• Make all fields as identifying for Meter. Previously attributes were omitted from being identifying.
  (#4161)
• Add support for filtering attribute keys for streams via an exclude list.
  (#4188)
• Clarify that Enabled only applies to synchronous instruments.
  (#4211)
• Clarify that applying cardinality limits should be done after attribute filtering.
  (#4228)
• Mark cardinality limits as stable.
  (#4222)

Logs

• Make all fields as identifying for Logger. Previously attributes were omitted from being identifying.
  (#4161)
• Define Enabled parameters for Logger.
  (#4203)
  (#4221)
• Introduce initial placeholder for the new user-facing Logs API, adding references
  to existing API's informing of the coming changes while the definition is defined.
  (#4236)

Common

• Define equality for attributes and collection of attributes.
  (#4161)
• Update Instrumentation Scope glossary entry with correct identifying fields
  (#4244)

New Contributors

• @yuanyuanzhao3 made their first contribution in #4216
• @MSNev made their first contribution in #4236

Release 1.37.0

v1.37.0 (2024-09-13)

Traces

• Minor clarification on BatchExportingProcessor behavior.
  (#4164)
• Clarify SpanKind description, extend it to cover links, add examples of nested client spans.
  (#4178)

Metrics

• Clarify that Export MUST NOT be called by periodic exporting MetricReader concurrently.
  (#4206)

Logs

• Clarify that log record mutations are visible in next registered processors.
  (#4067)
• Clarify that Export MUST NOT be called by simple and batching processors concurrently.
  (#4173)

SDK Configuration

• Define instrumentation configuration API.
  (#4128)
• Mark exemplar filter env variable config as stable.
  (#4191)

Common

• Update instrumentation library guidance to avoid naming collisions between external and OTel instrumentations.
  (#4187)
• Add natively instrumented to glossary.
  (#4186)

New Contributors

• @javiergarea made their first contribution in #4182
• @carsonip made their first contribution in #4192

Release 1.36.0

v1.36.0 (2024-08-12)

Traces

• Remove restriction that sampler description is immutable.
  (#4137)
• Add in-development OnEnding callback to SDK SpanProcessor interface.
  (#4024)

Metrics

• Clarify metric reader / metric exporter relationship for temporality
  preference and default aggregation. Explicitly define configuration options
  for temporality preference and default aggregation of built-in exporters, and
  make default values explicit.
  (#4142)
• Add data point flags to the metric data model.
  (#4135)

Logs

• The SDK MAY provide an operation that makes a deep clone of a ReadWriteLogRecord.
  (#4090)

Baggage

• Clarify no empty string allowed in baggage names.
  (#4144)

Compatibility

• Clarify prometheus exporter should have host and port configuration options.
  (#4147)

Common

• Require separation of API and SDK artifacts.
  (#4125)

New Contributors

• @vishweshbankwar made their first contribution in #4139
• @alfiejfs made their first contribution in #4150
• @hiroyaonoe made their first contribution in #4153

Full Changelog: v1.35.0...v1.36.0

Release 1.35.0

v1.35.0 (2024-07-12)

Logs

• Add the in-development isolating log record processor.
  (#4062)

Compatibility

• Define casing for hex-encoded IDs and mark the "Trace Context in non-OTLP Log Formats" specification stable.
  (#3909)

Release 1.34.0

v1.34.0 (2024-06-11)

Context

• No changes.

Traces

• Clarify the trace SDK should log discarded events and links. (#4064)
• Add new in-development Enabled API to the Tracer. (#4063)

Metrics

• Add new in-development Enabled API to meter instruments. (#4063)

Logs

• Add the in-development Enabled API to the Logger. (#4020)

Events

• Rename event payload to body. (#4035)
• Add specification for EventLogger and EventLoggerProvider. (#4031)
• Describe the use cases for events in greater detail. (#3969)

Resource

• No changes.

OpenTelemetry Protocol

• No changes.

Compatibility

• Prometheus: Clarify location of unit suffix within metric names. (#4057)

SDK Configuration

• No changes.

Common

• OpenTelemetry clients MUST follow SemVer 2.0.0. (#4039)
• Rename "Experimental" to "Development" according to OTEP 0232. (#4061), (#4069)

Supplementary Guidelines

• Clarify that it is permissible to extend SDK interfaces without requiring a major version bump (#4030)

New Contributors

• @yijiem made their first contribution in #4050
• @JonasKunz made their first contribution in #4030

Full Changelog: v1.33.0...v1.34.0

Release 1.33.0

v1.33.0 (2024-05-09)

Context

• No changes.

Traces

• Links with invalid SpanContext are recorded.
  (#3928)

Metrics

• Change the exemplar behavior to be on by default.
  (#3994)
• Use normative language for exemplar default aggregations.
  (#4009)
• Mark Exemplars as stable.
  (#3870)
• Mark synchronous gauge as stable.
  (#4019)

Logs

• Allow implementations to export duplicate keys in a map as an opt-in option.
  (#3987)

Events

• No changes.

Resource

• No changes.

OpenTelemetry Protocol

• No changes.

Compatibility

• Add name suggestion for option to apply resource attributes as metric attributes in Prometheus exporter.
  (#3837)

SDK Configuration

• Clarify syntax for environment variable substitution regular expression
  (#4001)
• Error out on invalid identifiers in environment variable substitution.
  (#4002)
• Add end to end examples for file configuration
  (#4018)
• Clarify the schema for YAML configuration files
  (#3973)

Common

• No changes.

Supplementary Guidelines

• No changes.

New Contributors

• @weslenteche made their first contribution in #3993

Release 1.32.0

v1.32.0 (2024-04-11)

Context

• No changes.

Traces

• Remove the Jaeger Exporter.
  (#3964)

Metrics

• Clarify that exemplar reservoir default may change in a minor version.
  (#3943)
• Add option to disable target info metric to Prometheus exporters.
  (#3872)
• Add synchronous gauge entry to sum monotonic table.
  (#3977)

Logs

• Refine description of Instrumentation Scope.
  (#3855)
• Clarify that ReadableLogRecord and ReadWriteLogRecord can be represented using a single type.
  (#3898)
• Fix what can be modified via ReadWriteLogRecord.
  (#3907)

Events

• No changes.

Resource

• No changes.

OpenTelemetry Protocol

• No changes.

Compatibility

• Prometheus compatibility: Clarify naming of the target info metric, and differences between various Prometheus formats.
  (#3871)
• Prometheus compatibility: Clarify that the service triplet is required to be unique by semantic conventions.
  (#3945)
• Prometheus: represent Prometheus Info, StateSet and Unknown-typed metrics in OTLP.
  (#3868)
• Update and reorganize the prometheus sdk exporter specification.
  (#3872)

SDK Configuration

• Define OTEL_EXPERIMENTAL_CONFIG_FILE to ignore other env vars, add env var substitution default syntax.
  (#3948)
• Clarify environment variable substitution is not recursive
  (#3913)
• Allow env: prefix in environment variable substitution syntax.
  (#3974)
• Add simple scope configuration to Tracer, Meter, Logger (experimental).
  (#3877)

Common

• No changes.

Supplementary Guidelines

• No changes.

New Contributors

• @grandwizard28 made their first contribution in #3947
• @steverao made their first contribution in #3955
• @dmathieu made their first contribution in #3984

Release 1.31.0

v1.31.0 (2024-03-13)

Context

• Specify allowed characters for Baggage keys and values.
  (#3801)

Traces

• Mark the AddLink() operation as stable.
  (#3887)

Metrics

• Formalize the interaction between cardinality limit and overflow attribute.
  (#3912)

Logs

• Fix: remove name from LogRecord example in the File Exporter example.
  (#3886)
• Remove implementation detail from Logs Bridge API.
  (#3884)
• Clarify that logs attributes are a superset of standard attributes.
  (#3852)
• Add support for empty values.
  (#3853)
• Mark standard output log record exporter as stable.
  (#3922)

Events

• Add Provider to the Event API.
  (#3878)

Resource

• No changes.

OpenTelemetry Protocol

• No changes.

Compatibility

• No changes.

SDK Configuration

• No changes.

Common

• Prohibit attribute value from evolving to contain complex types.
  (#3858)
• Tighten stability requirements for well-known attribute values.
  (#3879)

Supplementary Guidelines

• No changes.

New Contributors

• @cartermp made their first contribution in #3886
• @jaydeluca made their first contribution in #3916
• @khushijain21 made their first contribution in #3919

Full Changelog: v1.30.0...v1.31.0