From 52055b1729cd7eff7f807a39a54b9dbf2cc7a4e8 Mon Sep 17 00:00:00 2001 From: Jack Berg <34418638+jack-berg@users.noreply.github.com> Date: Thu, 4 Jun 2026 11:56:45 -0500 Subject: [PATCH 1/5] Prepare changelog for 1.63.0 --- CHANGELOG.md | 60 ++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 60 insertions(+) diff --git a/CHANGELOG.md b/CHANGELOG.md index 8e33ebc5dea..4f30e0e56a4 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -2,6 +2,66 @@ ## Unreleased +### API + +* Add missing `setAttribute` shortcuts to `Span` and `LogRecordBuilder` + ([#8255](https://github.com/open-telemetry/opentelemetry-java/pull/8255)) +* Promote `InstrumentationUtil` to public class in `io.opentelemetry.api.impl` package + ([#8413](https://github.com/open-telemetry/opentelemetry-java/pull/8413)) +* Fix index-out-of-bounds in `StrictContextStorage` + ([#8294](https://github.com/open-telemetry/opentelemetry-java/pull/8294)) + +#### Incubating + +* **BREAKING** Remove deprecated `ExtendedAttributes` and related code + ([#8395](https://github.com/open-telemetry/opentelemetry-java/pull/8395)) + +### SDK + +#### Metrics + +* Collect async exemplars when exemplar filter is `always_on` + ([#8363](https://github.com/open-telemetry/opentelemetry-java/pull/8363)) +* Move delta record/collect coordination from instrument to series level + ([#8313](https://github.com/open-telemetry/opentelemetry-java/pull/8313)) + +#### Exporters + +* **BREAKING** OTLP: Remove support for deprecated `GrpcSenderProvider` and `HttpSenderProvider` SPI + property names (use `io.opentelemetry.sdk.common.export.GrpcSenderProvider` / + `io.opentelemetry.sdk.common.export.HttpSenderProvider` instead) + ([#8392](https://github.com/open-telemetry/opentelemetry-java/pull/8392)) +* OTLP: Bound OkHttp sender dispatchers and surface rejections + ([#8422](https://github.com/open-telemetry/opentelemetry-java/pull/8422)) +* Prometheus: Limit exemplar label characters to conform to Prometheus limits + ([#8362](https://github.com/open-telemetry/opentelemetry-java/pull/8362)) +* Logging: Fix `LoggingSpanExporter.flush()` to preserve flush failures + ([#8361](https://github.com/open-telemetry/opentelemetry-java/pull/8361)) +* Zipkin: Make exporter self-contained by removing shared internal code dependencies + ([#8413](https://github.com/open-telemetry/opentelemetry-java/pull/8413)) + +#### Extensions + +* **BREAKING** Autoconfigure: Remove deprecated `otel.experimental.config.file` property + ([#8393](https://github.com/open-telemetry/opentelemetry-java/pull/8393)) +* **BREAKING** Incubator: Remove deprecated `ViewConfig`/`ViewConfigCustomizer` view file config mechanism + ([#8394](https://github.com/open-telemetry/opentelemetry-java/pull/8394)) +* Declarative config: Fix model package + ([#8403](https://github.com/open-telemetry/opentelemetry-java/pull/8403)) + +### Shims + +* Deprecate OpenTracing shim public API + ([#8373](https://github.com/open-telemetry/opentelemetry-java/pull/8373)) + +### Project tooling + +* Finish adding OSGi support across all modules + ([#8401](https://github.com/open-telemetry/opentelemetry-java/pull/8401), + [#8417](https://github.com/open-telemetry/opentelemetry-java/pull/8417)) +* Force `io.zipkin.zipkin2:zipkin:3.6.1` to avoid problematic gson version + ([#8430](https://github.com/open-telemetry/opentelemetry-java/pull/8430)) + ## Version 1.62.0 (2026-05-08) ### API From 5173278dd8dd35dda5fc2a2b4012c6553480eecb Mon Sep 17 00:00:00 2001 From: Jack Berg <34418638+jack-berg@users.noreply.github.com> Date: Thu, 4 Jun 2026 11:57:08 -0500 Subject: [PATCH 2/5] Mark zipkin, opentracing shim artifacts as deprecated --- README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 8b33a2a6ffb..a1fa38243e2 100644 --- a/README.md +++ b/README.md @@ -113,7 +113,7 @@ SDK exporters for shipping traces, metrics, and logs out of process. | [OTLP Logging Exporters](./exporters/logging-otlp) | Logging exporters in OTLP JSON encoding, including traces, metrics, and logs | `opentelemetry-exporter-logging-otlp` | 1.62.0 | [![Javadocs](https://www.javadoc.io/badge/io.opentelemetry/opentelemetry-exporter-logging-otlp.svg)](https://www.javadoc.io/doc/io.opentelemetry/opentelemetry-exporter-logging-otlp) | | [OTLP Common](./exporters/otlp/common) | Shared OTLP components (internal) | `opentelemetry-exporter-otlp-common` | 1.62.0 | [![Javadocs](https://www.javadoc.io/badge/io.opentelemetry/opentelemetry-exporter-otlp-common.svg)](https://www.javadoc.io/doc/io.opentelemetry/opentelemetry-exporter-otlp-common) | | [Logging Exporter](./exporters/logging) | Logging exporters, including metrics, traces, and logs | `opentelemetry-exporter-logging` | 1.62.0 | [![Javadocs](https://www.javadoc.io/badge/io.opentelemetry/opentelemetry-exporter-logging.svg)](https://www.javadoc.io/doc/io.opentelemetry/opentelemetry-exporter-logging) | -| [Zipkin Exporter](./exporters/zipkin) | Zipkin trace exporter | `opentelemetry-exporter-zipkin` | 1.62.0 | [![Javadocs](https://www.javadoc.io/badge/io.opentelemetry/opentelemetry-exporter-zipkin.svg)](https://www.javadoc.io/doc/io.opentelemetry/opentelemetry-exporter-zipkin) | +| [Zipkin Exporter](./exporters/zipkin) | **DEPRECATED** Zipkin trace exporter | `opentelemetry-exporter-zipkin` | 1.62.0 | [![Javadocs](https://www.javadoc.io/badge/io.opentelemetry/opentelemetry-exporter-zipkin.svg)](https://www.javadoc.io/doc/io.opentelemetry/opentelemetry-exporter-zipkin) | | [Prometheus Exporter](./exporters/prometheus) | Prometheus metric exporter | `opentelemetry-exporter-prometheus` | 1.62.0-alpha | [![Javadocs](https://www.javadoc.io/badge/io.opentelemetry/opentelemetry-exporter-prometheus.svg)](https://www.javadoc.io/doc/io.opentelemetry/opentelemetry-exporter-prometheus) | | [Exporter Common](./exporters/common) | Shared exporter components (internal) | `opentelemetry-exporter-common` | 1.62.0 | [![Javadocs](https://www.javadoc.io/badge/io.opentelemetry/opentelemetry-exporter-common.svg)](https://www.javadoc.io/doc/io.opentelemetry/opentelemetry-exporter-common) | | [OkHttp Sender](./exporters/sender/okhttp) | OkHttp implementation of HttpSender (internal) | `opentelemetry-exporter-sender-okhttp` | 1.62.0 | [![Javadocs](https://www.javadoc.io/badge/io.opentelemetry/opentelemetry-exporter-sender-okhttp.svg)](https://www.javadoc.io/doc/io.opentelemetry/opentelemetry-exporter-sender-okhttp) | @@ -143,7 +143,7 @@ Shims for bridging data from one observability library to another. | Component | Description | Artifact ID | Version | Javadoc | |----------------------------------------|--------------------------------------------------------------|----------------------------------|-------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | [OpenCensus Shim](./opencensus-shim) | Bridge opencensus metrics into the OpenTelemetry metrics SDK | `opentelemetry-opencensus-shim` | 1.62.0-alpha | [![Javadocs](https://www.javadoc.io/badge/io.opentelemetry/opentelemetry-opencensus-shim.svg)](https://www.javadoc.io/doc/io.opentelemetry/opentelemetry-opencensus-shim) | -| [OpenTracing Shim](./opentracing-shim) | Bridge opentracing spans into the OpenTelemetry trace API | `opentelemetry-opentracing-shim` | 1.62.0 | [![Javadocs](https://www.javadoc.io/badge/io.opentelemetry/opentelemetry-opentracing-shim.svg)](https://www.javadoc.io/doc/io.opentelemetry/opentelemetry-opentracing-shim) | +| [OpenTracing Shim](./opentracing-shim) | **DEPRECATED** Bridge opentracing spans into the OpenTelemetry trace API | `opentelemetry-opentracing-shim` | 1.62.0 | [![Javadocs](https://www.javadoc.io/badge/io.opentelemetry/opentelemetry-opentracing-shim.svg)](https://www.javadoc.io/doc/io.opentelemetry/opentelemetry-opentracing-shim) | ### Verifying Artifacts From 8566d3757b81c31284b281a845caaad2092d7a33 Mon Sep 17 00:00:00 2001 From: Jack Berg <34418638+jack-berg@users.noreply.github.com> Date: Thu, 4 Jun 2026 11:58:48 -0500 Subject: [PATCH 3/5] Add since annotations --- .../java/io/opentelemetry/api/impl/InstrumentationUtil.java | 2 ++ .../main/java/io/opentelemetry/api/logs/LogRecordBuilder.java | 1 + api/all/src/main/java/io/opentelemetry/api/trace/Span.java | 1 + 3 files changed, 4 insertions(+) diff --git a/api/all/src/main/java/io/opentelemetry/api/impl/InstrumentationUtil.java b/api/all/src/main/java/io/opentelemetry/api/impl/InstrumentationUtil.java index 381e03fef3b..ab4ba5791eb 100644 --- a/api/all/src/main/java/io/opentelemetry/api/impl/InstrumentationUtil.java +++ b/api/all/src/main/java/io/opentelemetry/api/impl/InstrumentationUtil.java @@ -16,6 +16,8 @@ * *

This class is not intended for use by application developers. Its API is stable and will not * be changed or removed in a backwards-incompatible manner. + * + * @since 1.63.0 */ public final class InstrumentationUtil { private static final ContextKey SUPPRESS_INSTRUMENTATION_KEY = diff --git a/api/all/src/main/java/io/opentelemetry/api/logs/LogRecordBuilder.java b/api/all/src/main/java/io/opentelemetry/api/logs/LogRecordBuilder.java index fb128fe7d3d..3570262b7ef 100644 --- a/api/all/src/main/java/io/opentelemetry/api/logs/LogRecordBuilder.java +++ b/api/all/src/main/java/io/opentelemetry/api/logs/LogRecordBuilder.java @@ -210,6 +210,7 @@ default LogRecordBuilder setAttribute(String key, int value) { * @param key the key for this attribute. * @param value the value for this attribute. * @return this. + * @since 1.63.0 */ default LogRecordBuilder setAttribute(String key, Value value) { return setAttribute(AttributeKey.valueKey(key), value); diff --git a/api/all/src/main/java/io/opentelemetry/api/trace/Span.java b/api/all/src/main/java/io/opentelemetry/api/trace/Span.java index da967abfad6..6cffbcdc912 100644 --- a/api/all/src/main/java/io/opentelemetry/api/trace/Span.java +++ b/api/all/src/main/java/io/opentelemetry/api/trace/Span.java @@ -163,6 +163,7 @@ default Span setAttribute(String key, boolean value) { * @param key the key for this attribute. * @param value the value for this attribute. * @return this. + * @since 1.63.0 */ default Span setAttribute(String key, Value value) { return setAttribute(AttributeKey.valueKey(key), value); From d1eb6994b4c088dbab3ccf6a70ee0f0aeb3a2eb1 Mon Sep 17 00:00:00 2001 From: Jack Berg <34418638+jack-berg@users.noreply.github.com> Date: Thu, 4 Jun 2026 12:01:15 -0500 Subject: [PATCH 4/5] Update for 8435 --- CHANGELOG.md | 2 ++ .../io/opentelemetry/sdk/logs/export/LogRecordExporter.java | 2 ++ .../io/opentelemetry/sdk/trace/export/SpanExporter.java | 6 +++++- 3 files changed, 9 insertions(+), 1 deletion(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 4f30e0e56a4..d9a904261f6 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -27,6 +27,8 @@ #### Exporters +* Add `noop()` factory method to `SpanExporter` and `LogRecordExporter` + ([#8435](https://github.com/open-telemetry/opentelemetry-java/pull/8435)) * **BREAKING** OTLP: Remove support for deprecated `GrpcSenderProvider` and `HttpSenderProvider` SPI property names (use `io.opentelemetry.sdk.common.export.GrpcSenderProvider` / `io.opentelemetry.sdk.common.export.HttpSenderProvider` instead) diff --git a/sdk/logs/src/main/java/io/opentelemetry/sdk/logs/export/LogRecordExporter.java b/sdk/logs/src/main/java/io/opentelemetry/sdk/logs/export/LogRecordExporter.java index 505d37d0e48..cccdf326505 100644 --- a/sdk/logs/src/main/java/io/opentelemetry/sdk/logs/export/LogRecordExporter.java +++ b/sdk/logs/src/main/java/io/opentelemetry/sdk/logs/export/LogRecordExporter.java @@ -58,6 +58,8 @@ static LogRecordExporter composite(Iterable exporters) { /** * Returns a {@link LogRecordExporter} that does nothing. All exported LogRecordData are ignored. + * + * @since 1.63.0 */ static LogRecordExporter noop() { return NoopLogRecordExporter.getInstance(); diff --git a/sdk/trace/src/main/java/io/opentelemetry/sdk/trace/export/SpanExporter.java b/sdk/trace/src/main/java/io/opentelemetry/sdk/trace/export/SpanExporter.java index 37628de1e6b..1a1818bf6f2 100644 --- a/sdk/trace/src/main/java/io/opentelemetry/sdk/trace/export/SpanExporter.java +++ b/sdk/trace/src/main/java/io/opentelemetry/sdk/trace/export/SpanExporter.java @@ -55,7 +55,11 @@ static SpanExporter composite(Iterable exporters) { return MultiSpanExporter.create(exportersList); } - /** Returns a {@link SpanExporter} that does nothing. All exported Spans are ignored. */ + /** + * Returns a {@link SpanExporter} that does nothing. All exported Spans are ignored. + * + * @since 1.63.0 + */ static SpanExporter noop() { return NoopSpanExporter.getInstance(); } From af55465ead1e26c11e0abd3890751a0336a087de Mon Sep 17 00:00:00 2001 From: Jack Berg <34418638+jack-berg@users.noreply.github.com> Date: Fri, 5 Jun 2026 08:46:11 -0500 Subject: [PATCH 5/5] Update for 8452 --- CHANGELOG.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/CHANGELOG.md b/CHANGELOG.md index d9a904261f6..d92685164fe 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -50,6 +50,8 @@ ([#8394](https://github.com/open-telemetry/opentelemetry-java/pull/8394)) * Declarative config: Fix model package ([#8403](https://github.com/open-telemetry/opentelemetry-java/pull/8403)) +* Declarative config: Fix Java module name to `io.opentelemetry.sdk.autoconfigure.declarativeconfig` + ([#8452](https://github.com/open-telemetry/opentelemetry-java/pull/8452)) ### Shims