Prepare 1.58.0 (#7965)

Author: jack-berg

CHANGELOG.md

@@ -2,6 +2,61 @@
 
 ## Unreleased
 
+### API
+
+#### Incubator
+
+* Delete GlobalConfigProvider in favor of access via ExtendedOpenTelemetry
+  ([#7914](https://github.com/open-telemetry/opentelemetry-java/pull/7914))
+* Add DeclarativeConfigProperties#get method
+  ([#7923](https://github.com/open-telemetry/opentelemetry-java/pull/7923))
+* Update ConfigProvider#getInstrumentationConfig response to be non-null
+  ([#7954](https://github.com/open-telemetry/opentelemetry-java/pull/7954))
+* Add declarative config utility methods for common operations
+  ([#7927](https://github.com/open-telemetry/opentelemetry-java/pull/7927))
+
+### SDK
+
+#### Traces
+
+* Implement SDK metrics for trace
+  ([#7895](https://github.com/open-telemetry/opentelemetry-java/pull/7895),
+  [#7930](https://github.com/open-telemetry/opentelemetry-java/pull/7930))
+* Emit warning when TraceIdRatioBasedSampler is used as child sampler
+  ([#7937](https://github.com/open-telemetry/opentelemetry-java/pull/7937))
+
+#### Logs
+
+* Implement SDK metrics for logs
+  ([#7931](https://github.com/open-telemetry/opentelemetry-java/pull/7931))
+
+#### Exporters
+
+* Prom exporter update
+  ([#7934](https://github.com/open-telemetry/opentelemetry-java/pull/7934))
+
+#### Extensions
+
+* Declarative config: update to opentelemetry-configuration 1.0.0-rc.3
+  ([#7861](https://github.com/open-telemetry/opentelemetry-java/pull/7861))
+* Declarative config: update jaeger remote sampler to require endpoint, initial_sampler
+  ([#7943](https://github.com/open-telemetry/opentelemetry-java/pull/7943))
+* Declarative config: add support for view unit
+  ([#7942](https://github.com/open-telemetry/opentelemetry-java/pull/7942))
+* Declarative config: add support for new logger config minimum_severity and trace_based properties
+  ([#7940](https://github.com/open-telemetry/opentelemetry-java/pull/7940))
+* Declarative config: add support for composable parent threshold sampler
+  ([#7941](https://github.com/open-telemetry/opentelemetry-java/pull/7941))
+* Declarative config: improve pattern for validating and loading SDK extension plugins
+  ([#7947](https://github.com/open-telemetry/opentelemetry-java/pull/7947))
+
+### Project tooling
+
+* Use develocity build cache in PRs and local builds
+  ([#7906](https://github.com/open-telemetry/opentelemetry-java/pull/7906))
+* Configure japicmp classpath to avoid false positives
+  ([#7945](https://github.com/open-telemetry/opentelemetry-java/pull/7945))
+
 ## Version 1.57.0 (2025-12-05)
 
 ### API

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

@@ -192,6 +192,8 @@ SdkLoggerProviderBuilder setExceptionAttributeResolver(
    * Sets the {@link MeterProvider} to use to generate <a
    * href="https://opentelemetry.io/docs/specs/semconv/otel/sdk-metrics/#span-metrics">SDK Span
    * Metrics</a>.
+   *
+   * @since 1.58.0
    */
   public SdkLoggerProviderBuilder setMeterProvider(Supplier<MeterProvider> meterProvider) {
     requireNonNull(meterProvider, "meterProvider");

sdk/logs/src/main/java/io/opentelemetry/sdk/logs/export/BatchLogRecordProcessorBuilder.java

@@ -148,14 +148,20 @@ public BatchLogRecordProcessorBuilder setMeterProvider(MeterProvider meterProvid
   /**
    * Sets the {@link MeterProvider} to use to collect metrics related to batch export. If not set,
    * metrics will not be collected.
+   *
+   * @since 1.58.0
    */
   public BatchLogRecordProcessorBuilder setMeterProvider(Supplier<MeterProvider> meterProvider) {
     requireNonNull(meterProvider, "meterProvider");
     this.meterProvider = meterProvider;
     return this;
   }
 
-  /** Sets the {@link InternalTelemetryVersion} defining which metrics this processor records. */
+  /**
+   * Sets the {@link InternalTelemetryVersion} defining which metrics this processor records.
+   *
+   * @since 1.58.0
+   */
   public BatchLogRecordProcessorBuilder setInternalTelemetryVersion(
       InternalTelemetryVersion telemetryVersion) {
     requireNonNull(telemetryVersion, "telemetryVersion");

sdk/logs/src/main/java/io/opentelemetry/sdk/logs/export/SimpleLogRecordProcessor.java

@@ -65,7 +65,11 @@ public static LogRecordProcessor create(LogRecordExporter exporter) {
     return builder(exporter).build();
   }
 
-  /** Returns a new Builder for {@link SimpleLogRecordProcessor}. */
+  /**
+   * Returns a new Builder for {@link SimpleLogRecordProcessor}.
+   *
+   * @since 1.58.0
+   */
   public static SimpleLogRecordProcessorBuilder builder(LogRecordExporter exporter) {
     requireNonNull(exporter, "exporter");
     return new SimpleLogRecordProcessorBuilder(exporter);

sdk/logs/src/main/java/io/opentelemetry/sdk/logs/export/SimpleLogRecordProcessorBuilder.java

@@ -10,6 +10,11 @@
 import io.opentelemetry.api.metrics.MeterProvider;
 import java.util.function.Supplier;
 
+/**
+ * Builder for {@link SimpleLogRecordProcessor}.
+ *
+ * @since 1.58.0
+ */
 public final class SimpleLogRecordProcessorBuilder {
   private final LogRecordExporter exporter;
   private Supplier<MeterProvider> meterProvider = MeterProvider::noop;

sdk/trace/src/main/java/io/opentelemetry/sdk/trace/SdkTracerProviderBuilder.java

@@ -238,6 +238,8 @@ SdkTracerProviderBuilder setExceptionAttributeResolver(
    * Sets the {@link MeterProvider} to use to generate <a
    * href="https://opentelemetry.io/docs/specs/semconv/otel/sdk-metrics/#span-metrics">SDK Span
    * Metrics</a>.
+   *
+   * @since 1.58.0
    */
   public SdkTracerProviderBuilder setMeterProvider(Supplier<MeterProvider> meterProvider) {
     requireNonNull(meterProvider, "meterProvider");

sdk/trace/src/main/java/io/opentelemetry/sdk/trace/export/BatchSpanProcessorBuilder.java

@@ -155,14 +155,20 @@ public BatchSpanProcessorBuilder setMeterProvider(MeterProvider meterProvider) {
   /**
    * Sets the {@link MeterProvider} to use to collect metrics related to batch export. If not set,
    * metrics will not be collected.
+   *
+   * @since 1.58.0
    */
   public BatchSpanProcessorBuilder setMeterProvider(Supplier<MeterProvider> meterProvider) {
     requireNonNull(meterProvider, "meterProvider");
     this.meterProvider = meterProvider;
     return this;
   }
 
-  /** Sets the {@link InternalTelemetryVersion} defining which metrics this processor records. */
+  /**
+   * Sets the {@link InternalTelemetryVersion} defining which metrics this processor records.
+   *
+   * @since 1.58.0
+   */
   public BatchSpanProcessorBuilder setInternalTelemetryVersion(
       InternalTelemetryVersion telemetryVersion) {
     requireNonNull(telemetryVersion, "telemetryVersion");

sdk/trace/src/main/java/io/opentelemetry/sdk/trace/export/SimpleSpanProcessorBuilder.java

@@ -37,6 +37,8 @@ public SimpleSpanProcessorBuilder setExportUnsampledSpans(boolean exportUnsample
    * Sets the {@link MeterProvider} to use to generate <a
    * href="https://opentelemetry.io/docs/specs/semconv/otel/sdk-metrics/#span-metrics">SDK Span
    * Metrics</a>.
+   *
+   * @since 1.58.0
    */
   public SimpleSpanProcessorBuilder setMeterProvider(Supplier<MeterProvider> meterProvider) {
     requireNonNull(meterProvider, "meterProvider");