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

Release v1.23.0

v1.23.0 (2023-07-12)

Context

• No changes.

Traces

• Refine SDK TracerProvider configuration section.
  (#3559)
• Make SDK Tracer Creation more normative.
  (#3529)

Metrics

• Refine SDK MeterProvider configuration section.
  (#3522)
• Clarify metric view requirements and recommendations.
  (#3524)
• Change the view name to be the view's stream configuration name.
  (#3524)
• Make SDK Meter Creation more normative.
  (#3529)
• Clarify duplicate instrument registration scope to be a MeterProvider.
  (#3538)
• Clarify identical instrument definition for SDK.
  (#3585)

Logs

• Refine SDK LoggerProvider configuration section.
  (#3559)
• Make SDK Logger Creation more normative.
  (#3529)

Resource

• No changes.

Compatibility

• NOTICE: Remove the Jaeger Exporter
  (#3567)
• Prometheus: Do not add _total suffix if the metric already ends in _total.
  (#3581)
• Prometheus type and unit suffixes are not trimmed by default.
  (#3580)

SDK Configuration

• Extract Exemplar section and mark it as Experimental.
  (#3533)

Common

• No changes.

Supplemenatary Guidelines

• No changes.

New Contributors

• @marcalff made their first contribution in #3567
• @shalevr made their first contribution in #3569

Release v1.22.0

Release v1.22.0 (2023-06-09)

Context

• No changes.

Traces

• No changes.

Metrics

• Make recommendation to reserve aggregator normative.
  (#3526)

Logs

• No changes.

Resource

• No changes.

Compatibility

• No changes.

OpenTelemetry Protocol

• Move OTLP specification to github.com/open-telemetry/opentelemetry-proto.
  (#3454)

SDK Configuration

• Extract Examplar section and mark it as Experimental.
  (#3533)

Telemetry Schemas

• No changes.

Common

• Explain why custom attributes are not recommended to be placed in OTel
  namespaces.
  (#3507)

Supplementary Guidelines

• No changes.

New Contributors

• @zeitlinger made their first contribution in #3542

Release v1.21.0

v1.21.0 (2023-05-17)

Context

• No changes.

Traces

• No changes.

Metrics

• Add experimental histogram advice API.
  (#3216)
• Recommended non-prefixed units for metric instrument semantic conventions.
  (#3312)
• Recommended cardinality limits to protect metrics pipelines against
  excessive data production from a single instrument.
  (#2960)
• Add links to the JMX APIs that are the JVM runtime metric sources.
  (#3463)

Logs

• Clarify parameters for emitting a log record.
  (#3345)
• Drop logger include_trace_context parameter.
  (#3397)
• Clarify how ObservedTimestamp field is set if unspecified
  (#3385)
• Mark logs bridge API / SDK as stable.
  (#3376)
• Mark LogRecord Environment Variables as stable.
  (#3449)

Resource

• No changes.

Semantic Conventions

• The Semantic Conventions have moved to a separate repository
  github.com/open-telemetry/semantic-conventions.
  There will be no future semantic conventions release from this repository.
  (#3489)

Compatibility

• Mark OpenCensus compatibility spec as stable
  (#3425)

OpenTelemetry Protocol

• No changes.

SDK Configuration

• Lay initial groundwork for file configuration
  (#3360)
• Move file configuration schema to opentelemetry-configuration.
  (#3412)
• Move sdk-configuration.md and sdk-environment-variables.md
  to /specification/configuration/.
  (#3434)

Telemetry Schemas

• No changes.

Common

• Add log entries to specification README.md contents.
  (#3435)

Supplementary Guidelines

• Add guidance to use service-supported propagation formats as default for AWS SDK client calls.
  (#3212)

New Contributors

• @sebastien-rosset made their first contribution in #3194
• @roberttoyonaga made their first contribution in #3463
• @lzchen made their first contribution in #3475

Full Changelog: v1.20.0...v1.21.0