Skip to content

Releases: open-telemetry/opentelemetry-specification

Release 1.37.0

13 Sep 16:55
45dea75
Compare
Choose a tag to compare

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

Release 1.36.0

12 Aug 15:53
328bbe6
Compare
Choose a tag to compare

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

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

Release 1.35.0

12 Jul 17:27
27bc9ff
Compare
Choose a tag to compare

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

11 Jun 14:14
518b1a5
Compare
Choose a tag to compare

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

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

Release 1.33.0

09 May 16:27
a7bb647
Compare
Choose a tag to compare

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

Release 1.32.0

11 Apr 14:13
93ddb3a
Compare
Choose a tag to compare

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

Release 1.31.0

13 Mar 17:56
3985e21
Compare
Choose a tag to compare

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

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

Release 1.30.0

15 Feb 23:03
5d9cef8
Compare
Choose a tag to compare

v1.30.0 (2024-02-15)

Context

  • No changes.

Traces

  • No changes.

Metrics

  • Clarify metric view measurement processing.
    (#3842)
  • Expose ExemplarReservoir as configuration parameter for views.
    Remove ExemplarFilter as an interface, now it is only configuration parameter.
    (#3820)

Logs

  • Fix Resource field type in Logs Data Model.
    (#3826)
  • Remove confusing description from Body field in Logs Data Model to make it clear the Bridge API must support a structured body.
    (#3827)
  • Deconstruct number scalar type to double and signed integer.
    (#3854)
  • Remove use of Object-Oriented term class in log signal.
    (#3882)

Resource

  • No changes.

OpenTelemetry Protocol

  • Use TracesData, MetricsData and LogsData proto messages for file exporter.
    (#3809)

Compatibility

  • No changes.

SDK Configuration

  • Add file configuration section to spec compliance matrix.
    (#3804)
  • Define mechanism for SDK extension components.
    (#3802)

Common

  • No changes.

Supplementary Guidelines

  • No changes.

New Contributors

Release 1.29.0

11 Jan 01:19
c6520a7
Compare
Choose a tag to compare

v1.29.0 (2024-01-10)

Context & Baggage

  • Align definition of Baggage with W3C Specification.
    (#3800)

Traces

  • Update OpenTelemetry to Zipkin Transformation to handle attributes from older semantic conventions in a backwards compatible way.
    (#3794)

Metrics

  • Define experimental MetricFilter as a mechanism to filter collected metrics by the MetricReader
    (#3566)
  • Add optional configuration for Prometheus exporters to optionally remove unit and type suffixes.
    (#3777)
  • Add optional configuration for Prometheus exporters to optionally drop otel_scope_info metric.
    (#3796)

Logs

Resource

OpenTelemetry Protocol

Compatibility

SDK Configuration

  • Define file configuration file format and env var substitution
    (#3744)

Common

  • Clarify that attribute keys are case-sensitive.
    (#3784)

Supplementary Guidelines

Release 1.28.0

07 Dec 17:11
b064af8
Compare
Choose a tag to compare

v1.28.0 (2023-12-07)

Context

  • No changes.

Traces

  • Stabilize how exceptions are recorded using the Trace SDK.
    (#3769)
  • Add definition for standard output span exporter.
    (#3740)

Metrics

  • Add optional configuration for Prometheus exporters to promote resource attributes to metric attributes
    (#3761)
  • Clarifications and flexibility in Exemplar speicification.
    (#3760)

Logs

  • Add definition for standard output log record exporter.
    (#3741)
  • BREAKING: Change event.name definition to include namespace and removed event.domain from log event attributes.
    (#3749)
  • BREAKING: Refine the arguments of the emit Event API. Instead of accepting a LogRecord, the individual arguments are enumerated along with the implementation requirements on how those arguments map to LogRecord.
    (#3772)

Resource

  • No changes.

OpenTelemetry Protocol

  • Clarify HTTP endpoint configuration option handling.
    (#3739)

Compatibility

  • No changes.

SDK Configuration

  • Add console as an exporter type that is supported via environment variable configuration.
    (#3742)

Common

  • No changes.

Supplementary Guidelines

  • No changes.

New Contributors