Prepare 1.50.0 (#7335)

Author: jack-berg

CHANGELOG.md

@@ -2,6 +2,72 @@
 
 ## Unreleased
 
+### API
+
+* Clarify that AttributesBuilder.put allows nulls
+ ([#7271](https://github.com/open-telemetry/opentelemetry-java/pull/7271))
+* Stabilize log record event name
+ ([#7277](https://github.com/open-telemetry/opentelemetry-java/pull/7277))
+
+#### Context
+
+* Fix duplicated ExecutorService wrap
+ ([#7245](https://github.com/open-telemetry/opentelemetry-java/pull/7245))
+* Promote getAll to TextMapGetter stable API
+ ([#7267](https://github.com/open-telemetry/opentelemetry-java/pull/7267))
+
+#### Incubator
+
+* Add ExtendedLogRecordBuilder#setException
+ ([#7182](https://github.com/open-telemetry/opentelemetry-java/pull/7182))
+* Add experimental support for log extended attributes
+ ([#7123](https://github.com/open-telemetry/opentelemetry-java/pull/7123))
+
+### SDK
+
+* Remove Java9VersionSpecific clock implementation
+ ([#7221](https://github.com/open-telemetry/opentelemetry-java/pull/7221))
+* Add addProcessorFirst to SdkTracerProviderBuilder, SdkLoggerProviderBuilder
+ ([#7243](https://github.com/open-telemetry/opentelemetry-java/pull/7243))
+
+#### Logs
+
+* Add `setLoggerConfigurator` support to `LoggerProvider`
+ ([#7332](https://github.com/open-telemetry/opentelemetry-java/pull/7332))
+
+#### Metrics
+
+* Add DelegatingMetricData
+ ([#7229](https://github.com/open-telemetry/opentelemetry-java/pull/7229))
+* Spatial aggregation for async instruments with filtering views
+ ([#7264](https://github.com/open-telemetry/opentelemetry-java/pull/7264))
+
+#### Exporters
+
+* Prometheus: Add Authenticator support for PrometheusHttpServer
+ ([#7225](https://github.com/open-telemetry/opentelemetry-java/pull/7225))
+* OTLP: Fix OTLP metric exporter toBuilder() loosing temporality
+ ([#7280](https://github.com/open-telemetry/opentelemetry-java/pull/7280))
+* OTLP: Allow Otlp*MetricExporter's to publish export stats
+ ([#7255](https://github.com/open-telemetry/opentelemetry-java/pull/7255))
+
+#### Extensions
+
+* Declarative config: Add support for escaping env var substitution
+ ([#7033](https://github.com/open-telemetry/opentelemetry-java/pull/7033))
+* Declarative config: update to opentelemetry-configuration 0.4
+ ([#7064](https://github.com/open-telemetry/opentelemetry-java/pull/7064))
+* Declarativeconfig: Refactor internals to add DeclarativeConfigContext
+ ([#7293](https://github.com/open-telemetry/opentelemetry-java/pull/7293))
+
+### Project tooling
+
+* Kotlin extension: Update min kotlin version to 1.8
+ ([#7155](https://github.com/open-telemetry/opentelemetry-java/pull/7155))
+* Add javadoc site crawler
+ ([#7300](https://github.com/open-telemetry/opentelemetry-java/pull/7300),
+ [#7316](https://github.com/open-telemetry/opentelemetry-java/pull/7316))
+
 ## Version 1.49.0 (2025-04-04)
 
 ### SDK

api/all/src/main/java/io/opentelemetry/api/logs/LogRecordBuilder.java

@@ -203,6 +203,8 @@ default LogRecordBuilder setAttribute(String key, int value) {
  *
  * <p>This name should uniquely identify the event structure (both attributes and body). A log
  * record with a non-empty event name is an Event.
+ *
+ * @since 1.50.0
  */
  default LogRecordBuilder setEventName(String eventName) {
  return this;

context/src/main/java/io/opentelemetry/context/propagation/TextMapGetter.java

@@ -46,6 +46,7 @@ public interface TextMapGetter<C> {
  * @param key the key of the field.
  * @return all values for a given {@code key} in order, or returns an empty list. Default method
  * wraps {@code get()} as an {@link Iterator}.
+ * @since 1.50.0
  */
  default Iterator<String> getAll(@Nullable C carrier, String key) {
  String first = get(carrier, key);

exporters/otlp/all/src/main/java/io/opentelemetry/exporter/otlp/http/metrics/OtlpHttpMetricExporterBuilder.java

@@ -246,6 +246,8 @@ public OtlpHttpMetricExporterBuilder setProxyOptions(ProxyOptions proxyOptions)
  /**
  * Sets the {@link MeterProvider} to use to collect metrics related to export. If not set, uses
  * {@link GlobalOpenTelemetry#getMeterProvider()}.
+ *
+ * @since 1.50.0
  */
  public OtlpHttpMetricExporterBuilder setMeterProvider(MeterProvider meterProvider) {
  requireNonNull(meterProvider, "meterProvider");
@@ -256,6 +258,8 @@ public OtlpHttpMetricExporterBuilder setMeterProvider(MeterProvider meterProvide
  /**
  * Sets the {@link MeterProvider} supplier to use to collect metrics related to export. If not
  * set, uses {@link GlobalOpenTelemetry#getMeterProvider()}.
+ *
+ * @since 1.50.0
  */
  public OtlpHttpMetricExporterBuilder setMeterProvider(
  Supplier<MeterProvider> meterProviderSupplier) {

exporters/otlp/all/src/main/java/io/opentelemetry/exporter/otlp/metrics/OtlpGrpcMetricExporterBuilder.java

@@ -276,6 +276,8 @@ public OtlpGrpcMetricExporterBuilder setRetryPolicy(@Nullable RetryPolicy retryP
  /**
  * Sets the {@link MeterProvider} to use to collect metrics related to export. If not set, uses
  * {@link GlobalOpenTelemetry#getMeterProvider()}.
+ *
+ * @since 1.50.0
  */
  public OtlpGrpcMetricExporterBuilder setMeterProvider(MeterProvider meterProvider) {
  requireNonNull(meterProvider, "meterProvider");
@@ -286,6 +288,8 @@ public OtlpGrpcMetricExporterBuilder setMeterProvider(MeterProvider meterProvide
  /**
  * Sets the {@link MeterProvider} supplier to use to collect metrics related to export. If not
  * set, uses {@link GlobalOpenTelemetry#getMeterProvider()}.
+ *
+ * @since 1.50.0
  */
  public OtlpGrpcMetricExporterBuilder setMeterProvider(
  Supplier<MeterProvider> meterProviderSupplier) {

sdk/logs/src/main/java/io/opentelemetry/sdk/logs/ReadWriteLogRecord.java

@@ -52,7 +52,11 @@ default ReadWriteLogRecord setAllAttributes(Attributes attributes) {
  /** Return an immutable {@link LogRecordData} instance representing this log record. */
  LogRecordData toLogRecordData();
 
- /** Returns the log record event name, or {@code null} if none is set. */
+ /**
+ * Returns the log record event name, or {@code null} if none is set.
+ *
+ * @since 1.50.0
+ */
  @Nullable
  default String getEventName() {
  return null;

sdk/logs/src/main/java/io/opentelemetry/sdk/logs/SdkLoggerProviderBuilder.java

@@ -107,6 +107,7 @@ public SdkLoggerProviderBuilder addLogRecordProcessor(LogRecordProcessor process
  *
  * @param processor the log processor
  * @return this
+ * @since 1.50.0
  */
  public SdkLoggerProviderBuilder addLogRecordProcessorFirst(LogRecordProcessor processor) {
  requireNonNull(processor, "processor");

sdk/logs/src/main/java/io/opentelemetry/sdk/logs/data/LogRecordData.java

@@ -83,7 +83,11 @@ default Value<?> getBodyValue() {
  */
  int getTotalAttributeCount();
 
- /** Returns the event name, or {@code null} if none is set. */
+ /**
+ * Returns the event name, or {@code null} if none is set.
+ *
+ * @since 1.50.0
+ */
  @Nullable
  default String getEventName() {
  return null;

sdk/metrics/src/main/java/io/opentelemetry/sdk/metrics/data/DelegatingMetricData.java

@@ -34,6 +34,8 @@
  * // }
  * // }
  * }</pre>
+ *
+ * @since 1.50.0
  */
 public abstract class DelegatingMetricData implements MetricData {
 

sdk/metrics/src/main/java/io/opentelemetry/sdk/metrics/data/DoubleExemplarData.java

@@ -18,6 +18,11 @@
 @Immutable
 public interface DoubleExemplarData extends ExemplarData {
 
+ /**
+ * Create a record.
+ *
+ * @since 1.50.0
+ */
  static DoubleExemplarData create(
  Attributes filteredAttributes, long recordTimeNanos, SpanContext spanContext, double value) {
  return ImmutableDoubleExemplarData.create(