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

Release 1.30.0

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

• @CosminLazar made their first contribution in #3838
• @danielgblanco made their first contribution in #3842
• @efgpinto made their first contribution in #3843

Release 1.29.0

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

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

• @patrickhousley made their first contribution in #3749
• @davix made their first contribution in #3764

Release 1.27.0

v1.27.0 (2023-11-08)

Context

• No changes.

Traces

• Add a new AddLink() operation to Span (experimental). (#3678)

Metrics

• No changes.

Logs

• No changes.

Resource

• No changes.

OpenTelemetry Protocol

• New exporter implementations do not need to support OTEL_EXPORTER_OTLP_SPAN_INSECURE and OTEL_EXPORTER_OTLP_METRIC_INSECURE. (#3719)

Compatibility

• No changes.

SDK Configuration

• Define file configuration parse and create operations. (#3437)
• Add environment variable implementation guidelines. (#3738)

Common

• Rename/replace (client|server).socket.(address|port) attributes with network.(peer|local).(address|port). (#3713)

Supplementary Guidelines

• No changes.

New Contributors

• @vprithvi made their first contribution in #3726

Release 1.26.0

v1.26.0 (2023-10-10)

Context

• No changes.

Traces

• ParentBased sampler is a decorator (not a composite). (#3706)

Metrics

• Consistently use "advisory parameters" instead of "advice parameters". (#3693)
• Stabilize ExplicitBucketBoundaries instrument advisory parameter. (#3694)

Logs

• Update two apache access logs mappings. (#3712)

Resource

• No changes.

OpenTelemetry Protocol

• No changes.

Compatibility

• Prometheus exporters omit empty resources and scopes without attributes. (#3660)

SDK Configuration

• Fix description of OTEL_ATTRIBUTE_COUNT_LIMIT (#3714)

Common

• Add upgrading and version management documentation (#3695)

Supplementary Guidelines

• No changes.

New Contributors

• @albertored made their first contribution in #3693
• @jjatria made their first contribution in #3714

Release v1.25.0

v1.25.0 (2023-09-13)

Context

• No changes.

Traces

• No changes.

Metrics

• Increase metric name maximum length from 63 to 255 characters.
  (#3648)
• MetricReader.Collect ignores Resource from MetricProducer.Produce.
  (#3636)
• Attribute sets not observed during async callbacks are not exported.
  (#3242)
• Promote MetricProducer specification to feature-freeze.
  (#3655)
• Add synchronous gauge instrument, clarify temporality selection influence on
  metric point persistence.
  (#3540)
• Clarify that advice is non-identifying.
  (#3661)
• Define the default size of the SimpleFixedSizeExemplarReservoir to be 1.
  (#3670)
• Rename "advice" to "advisory parameters".
  (#3662)
• Clarify the minimal implementation of a View's attribute_keys is an allow-list.
  (#3680)
• Add "/" to valid characters for instrument names
  (#3684)
• Stabilize the MetricProducer.
  (#3685)

Logs

• Update GCP data model to use TraceFlags instead of
  gcp.trace_sampled. (#3629)

Resource

• No changes.

OpenTelemetry Protocol

• Fix and clarify definition of "transient error" in the OTLP exporter specification.
  (#3653)

Compatibility

• OpenTracing Shim: Allow invalid but sampled SpanContext to be returned.
  (#3471)
• Prometheus: Allow changing metric names by default when translating from Prometheus to OpenTelemetry.
  (#3679)

SDK Configuration

• No changes.

Common

• No changes.

Supplementary Guidelines

• No changes.

Full Changelog: v1.24.0...v1.25.0

Release v1.24.0

v1.24.0 (2023-08-10)

Context

• No changes.

Traces

• No changes.

Metrics

• Specify how to handle instrument name conflicts.
  (#3626)
• Add experimental metric attributes advice API.
  (#3546)
• Revise the exemplar default reservoirs.
  (#3627)
• Mark the default aggregation cardinality Experimental in MetricReader.
  (#3619)
• Mark Metric No-Op API as stable.
  (#3642)
• MetricProducers are provided as config to MetricReaders instead of through a RegisterProducer operation.
  (#3613)
• Refine MetricProvider.ForceFlush and define ForceFlush for periodic exporting MetricReader.
  (#3563)

Logs

• Clarify how log appender use Scope name and attributes.
  (#3583)
• Mark No-Op Logs Bridge API as stable.
  (#3642)

Resource

• No changes.

Compatibility

• Prometheus exporters SHOULD provide configuration to disable the addition of _total suffixes.
  (#3590)

SDK Configuration

• No changes.

Common

• No changes.

Supplementary Guidelines

• No changes.

New Contributors

• @PerfectSlayer made their first contribution in #3633

Full Changelog: v1.23.0...v1.24.0