Prepare for 1.59.0 release (#8052)

Author: jack-berg

CHANGELOG.md

@@ -2,9 +2,66 @@
 
 ## Unreleased
 
-* Add AlwaysRecordSampler
+### API
+
+* Stabilize complex attributes
+  ([#7973](https://github.com/open-telemetry/opentelemetry-java/pull/7973))
+* Limit init valid hex array to range that can be true
+  ([#7809](https://github.com/open-telemetry/opentelemetry-java/pull/7809))
+
+#### Extensions
+
+* Trace propagators: Deprecate OtTracePropagator
+  ([#8020](https://github.com/open-telemetry/opentelemetry-java/pull/8020))
+* Trace propagators: Deprecate JaegerPropagator
+  ([#8019](https://github.com/open-telemetry/opentelemetry-java/pull/8019))
+
+### SDK
+
+* Move io.opentelemetry.sdk.internal to io.opentelemetry.sdk.common.internal
+  ([#8003](https://github.com/open-telemetry/opentelemetry-java/pull/8003))
+* Always return ExtendedOpenTelemetry when incubator is available
+  ([#7991](https://github.com/open-telemetry/opentelemetry-java/pull/7991))
+
+#### Traces
+
+* Fix memory leak in SdkSpan#spanEndingThread
+  ([#7984](https://github.com/open-telemetry/opentelemetry-java/pull/7984))
+
+#### Metrics
+
+* Rework and publish metric benchmarks
+  ([#8000](https://github.com/open-telemetry/opentelemetry-java/pull/8000))
+* Update LongLastValueAggregator algo to avoid allocations
+  ([#8017](https://github.com/open-telemetry/opentelemetry-java/pull/8017))
+
+#### Testing
+
+* Fix OTel JUnit5 Extension cleanup when using Nested test classes
+  ([#7999](https://github.com/open-telemetry/opentelemetry-java/pull/7999))
+* Add assertion support for Span hasException(null)
+  ([#8033](https://github.com/open-telemetry/opentelemetry-java/pull/8033))
+
+#### Exporters
+
+* **DEPRECATION**: `opentelemetry-exporter-zipkin` is now deprecated with the
+  last release planned for 1.65.0 (August 2026)
+  ([#7974](https://github.com/open-telemetry/opentelemetry-java/pull/7974))
+* Refactor http, grpc senders and promote to public API
+  ([#7782](https://github.com/open-telemetry/opentelemetry-java/pull/7782))
+
+#### Extensions
+
+* Jaeger remote sampler: Remove unused code
+  ([#7970](https://github.com/open-telemetry/opentelemetry-java/pull/7970))
+* Incubator: Add AlwaysRecordSampler
   ([#7877](https://github.com/open-telemetry/opentelemetry-java/pull/7877))
 
+### Project tooling
+
+* Align generate release contributors
+  ([#8023](https://github.com/open-telemetry/opentelemetry-java/pull/8023))
+
 ## Version 1.58.0 (2026-01-09)
 
 ### API

api/all/src/main/java/io/opentelemetry/api/common/AttributeKey.java

@@ -81,6 +81,8 @@ static AttributeKey<List<Double>> doubleArrayKey(String key) {
    * that backends do not index individual properties of complex attributes, that querying or
    * aggregating on such properties is inefficient and complicated, and that reporting complex
    * attributes carries higher performance overhead.
+   *
+   * @since 1.59.0
    */
   static AttributeKey<Value<?>> valueKey(String key) {
     return InternalAttributeKeyImpl.create(key, AttributeType.VALUE);

api/all/src/main/java/io/opentelemetry/api/common/AttributeType.java

@@ -18,5 +18,10 @@ public enum AttributeType {
   BOOLEAN_ARRAY,
   LONG_ARRAY,
   DOUBLE_ARRAY,
+  /**
+   * {@link Value}-based attributes.
+   *
+   * @since 1.59.0
+   */
   VALUE
 }

api/all/src/main/java/io/opentelemetry/api/common/AttributesBuilder.java

@@ -208,6 +208,7 @@ default AttributesBuilder put(String key, boolean... value) {
    * your keys, if possible.
    *
    * @return this Builder
+   * @since 1.59.0
    */
   default AttributesBuilder put(String key, Value<?> value) {
     return put(valueKey(key), value);

api/all/src/main/java/io/opentelemetry/api/common/Empty.java

@@ -8,6 +8,8 @@
 /**
  * A singleton class representing an empty value, used as the generic type parameter for {@link
  * Value} when representing empty values.
+ *
+ * @since 1.59.0
  */
 public final class Empty {
 

api/all/src/main/java/io/opentelemetry/api/common/Value.java

@@ -85,7 +85,11 @@ static Value<List<KeyValue>> of(Map<String, Value<?>> value) {
     return KeyValueList.createFromMap(value);
   }
 
-  /** Returns an empty {@link Value}. */
+  /**
+   * Returns an empty {@link Value}.
+   *
+   * @since 1.59.0
+   */
   static Value<Empty> empty() {
     return ValueEmpty.create();
   }

api/all/src/main/java/io/opentelemetry/api/common/ValueType.java

@@ -20,5 +20,10 @@ public enum ValueType {
   ARRAY,
   KEY_VALUE_LIST,
   BYTES,
+  /**
+   * Empty value.
+   *
+   * @since 1.59.0
+   */
   EMPTY
 }

sdk/common/src/main/java/io/opentelemetry/sdk/common/export/Compressor.java

@@ -12,6 +12,8 @@
 /**
  * A service provider interface (SPI) for compression. Implementation MUST be thread safe as the
  * same instance is expected to be used many times and concurrently.
+ *
+ * @since 1.59.0
  */
 @ThreadSafe
 public interface Compressor {

sdk/common/src/main/java/io/opentelemetry/sdk/common/export/GrpcResponse.java

@@ -13,6 +13,7 @@
  * A gRPC response.
  *
  * @see GrpcSender#send(MessageWriter, Consumer, Consumer)
+ * @since 1.59.0
  */
 @Immutable
 public interface GrpcResponse {

sdk/common/src/main/java/io/opentelemetry/sdk/common/export/GrpcSender.java

@@ -17,6 +17,7 @@
  * cases.
  *
  * @see GrpcSenderProvider
+ * @since 1.59.0
  */
 public interface GrpcSender {