Merge remote-tracking branch 'otel/main' into span-start-end-metrics

# Conflicts:
#	docs/apidiffs/current_vs_latest/opentelemetry-sdk-trace.txt
#	sdk/trace/src/main/java/io/opentelemetry/sdk/trace/SdkTracerProviderBuilder.java

Author: JonasKunz

.github/workflows/build.yml

@@ -171,7 +171,7 @@ jobs:
           - 23
     steps:
       - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
-      - uses: graalvm/setup-graalvm@01ed653ac833fe80569f1ef9f25585ba2811baab # v1.3.3
+      - uses: graalvm/setup-graalvm@e1df20a713a4cc6ab5b0eb03f0e0dcdc0199b805 # v1.3.4
         with:
           java-version: ${{ matrix.test-graal-version }}
           distribution: 'graalvm'

.github/workflows/codeql.yml

@@ -45,7 +45,7 @@ jobs:
         uses: gradle/actions/setup-gradle@ac638b010cf58a27ee6c972d7336334ccaf61c96 # v4.4.1
 
       - name: Initialize CodeQL
-        uses: github/codeql-action/init@ce28f5bb42b7a9f2c824e633a3f6ee835bab6858 # v3.29.0
+        uses: github/codeql-action/init@181d5eefc20863364f96762470ba6f862bdef56b # v3.29.2
         with:
           languages: ${{ matrix.language }}
           # using "latest" helps to keep up with the latest Kotlin support
@@ -60,6 +60,6 @@ jobs:
         run: ./gradlew assemble --no-build-cache --no-daemon
 
       - name: Perform CodeQL analysis
-        uses: github/codeql-action/analyze@ce28f5bb42b7a9f2c824e633a3f6ee835bab6858 # v3.29.0
+        uses: github/codeql-action/analyze@181d5eefc20863364f96762470ba6f862bdef56b # v3.29.2
         with:
           category: "/language:${{matrix.language}}"

.github/workflows/ossf-scorecard.yml

@@ -42,6 +42,6 @@ jobs:
       # Upload the results to GitHub's code scanning dashboard (optional).
       # Commenting out will disable upload of results to your repo's Code Scanning dashboard
       - name: "Upload to code-scanning"
-        uses: github/codeql-action/upload-sarif@ce28f5bb42b7a9f2c824e633a3f6ee835bab6858 # v3.29.0
+        uses: github/codeql-action/upload-sarif@181d5eefc20863364f96762470ba6f862bdef56b # v3.29.2
         with:
           sarif_file: results.sarif

CHANGELOG.md

@@ -2,6 +2,62 @@
 
 ## Unreleased
 
+## Version 1.52.0 (2025-07-11)
+
+### API
+
+#### Common
+
+* Promote `ComponentLoader` to new `opentelemetry-common` artifact,
+  standardize SPI loading
+  ([#7446](https://github.com/open-telemetry/opentelemetry-java/pull/7446))
+
+#### Context
+
+* LazyStorage passes its ClassLoader when loading ContextStorageProvider SPI
+  ([#7424](https://github.com/open-telemetry/opentelemetry-java/pull/7424))
+
+#### Incubator
+
+* Add context and severity params to ExtendedLogger#isEnabled
+  ([#7268](https://github.com/open-telemetry/opentelemetry-java/pull/7268))
+* Add new convenience methods for converting DeclarativeConfigProperties to config model
+  ([#7453](https://github.com/open-telemetry/opentelemetry-java/pull/7453))
+
+### SDK
+
+* Add custom stacktrace renderer which is length limit aware
+  ([#7281](https://github.com/open-telemetry/opentelemetry-java/pull/7281))
+
+#### Metrics
+
+* Propagate flush to PeriodicMetricReader's metricExporter.
+  ([#7410](https://github.com/open-telemetry/opentelemetry-java/pull/7410))
+
+#### Exporters
+
+* OTLP - JdkHttpSender: ensure proper closure of HttpClient in shutdown method
+  ([#7390](https://github.com/open-telemetry/opentelemetry-java/pull/7390))
+* OTLP: profile exporters fix and test improvements
+  ([#7442](https://github.com/open-telemetry/opentelemetry-java/pull/7442))
+* OTLP: Loading Compressor SPI via ComponentLoader configured through setComponentLoader
+  ([#7428](https://github.com/open-telemetry/opentelemetry-java/pull/7428))
+* Prometheus: add scope schema URL and attributes
+  ([#7356](https://github.com/open-telemetry/opentelemetry-java/pull/7356))
+* Prometheus: extend prometheus declarative config support to include without_scope_info,
+  with_resource_constant_labels
+  ([#6840](https://github.com/open-telemetry/opentelemetry-java/pull/6840))
+
+#### Extensions
+
+* Autoconfigure: fix race condition of `GlobalOpenTelemetry` initialization with
+  `AutoConfiguredOpenTelemetrySdkBuilder`
+  ([#7365](https://github.com/open-telemetry/opentelemetry-java/pull/7365))
+* Declarative config: update to declarative config 1.0-rc.1
+  ([#7436](https://github.com/open-telemetry/opentelemetry-java/pull/7436))
+* Declarative config: resolve environment variable substitution for mixed quotes
+  ([#7433](https://github.com/open-telemetry/opentelemetry-java/pull/7433))
+
 ## Version 1.51.0 (2025-06-06)
 
 ### API

README.md

@@ -28,7 +28,7 @@ class SdkDesignTest {
    * Ensures that all SDK methods that: - are defined in classes that extend or implement API model
    * and are public (to exclude protected builders) - are public (avoids issues with protected
    * methods returning classes unavailable to test's CL) - override or implement parent method
-   * return only API, Context or generic Java type.
+   * return only API, Context, Common, or generic Java type.
    */
   @Test
   void sdkImplementationOfApiClassesShouldReturnApiTypeOnly() {
@@ -45,7 +45,11 @@ void sdkImplementationOfApiClassesShouldReturnApiTypeOnly() {
             .and(implementOrOverride())
             .should()
             .haveRawReturnType(
-                inPackage("io.opentelemetry.api..", "io.opentelemetry.context..", "java.."))
+                inPackage(
+                    "io.opentelemetry.api..",
+                    "io.opentelemetry.context..",
+                    "io.opentelemetry.common..",
+                    "java.."))
             .orShould()
             .haveRawReturnType("void");
 

all/src/test/java/io/opentelemetry/all/SdkDesignTest.java

@@ -122,6 +122,8 @@ public static void set(OpenTelemetry openTelemetry) {
    *
    * <p>This method calls the given {@code supplier} and calls {@link #set(OpenTelemetry)}, all
    * while holding the {@link GlobalOpenTelemetry} mutex.
+   *
+   * @since 1.52.0
    */
   public static void set(Supplier<OpenTelemetry> supplier) {
     synchronized (mutex) {

api/all/src/main/java/io/opentelemetry/api/GlobalOpenTelemetry.java

@@ -12,6 +12,9 @@ otelJava.moduleName.set("io.opentelemetry.api.incubator")
 dependencies {
   api(project(":api:all"))
 
+  // Supports optional InstrumentationConfigUtil#convertToModel
+  compileOnly("com.fasterxml.jackson.core:jackson-databind")
+
   annotationProcessor("com.google.auto.value:auto-value")
 
   // To use parsed config file as input for InstrumentationConfigUtilTest
@@ -24,3 +27,16 @@ dependencies {
 
   testImplementation("com.google.guava:guava")
 }
+
+testing {
+  suites {
+    register<JvmTestSuite>("testConvertToModel") {
+      dependencies {
+        implementation("com.fasterxml.jackson.core:jackson-databind")
+        implementation(project(":sdk-extensions:incubator"))
+        implementation(project(":sdk-extensions:autoconfigure"))
+        implementation("com.google.guava:guava")
+      }
+    }
+  }
+}

api/incubator/build.gradle.kts

@@ -7,7 +7,9 @@
 
 import static io.opentelemetry.api.internal.ConfigUtil.defaultIfNull;
 
+import io.opentelemetry.common.ComponentLoader;
 import java.util.List;
+import java.util.Map;
 import java.util.Set;
 import javax.annotation.Nullable;
 
@@ -36,6 +38,11 @@ static DeclarativeConfigProperties empty() {
     return EmptyDeclarativeConfigProperties.getInstance();
   }
 
+  /** Return a map representation of the {@code declarativeConfigProperties}. */
+  static Map<String, Object> toMap(DeclarativeConfigProperties declarativeConfigProperties) {
+    return DeclarativeConfigPropertyUtil.toMap(declarativeConfigProperties);
+  }
+
   /**
    * Returns a {@link String} configuration property.
    *
@@ -222,4 +229,7 @@ default List<DeclarativeConfigProperties> getStructuredList(
    * @return the configuration property keys
    */
   Set<String> getPropertyKeys();
+
+  /** Return a {@link ComponentLoader} that should be used to load SPIs. */
+  ComponentLoader getComponentLoader();
 }

api/incubator/src/main/java/io/opentelemetry/api/incubator/config/DeclarativeConfigProperties.java

@@ -0,0 +1,126 @@
+/*
+ * Copyright The OpenTelemetry Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+package io.opentelemetry.api.incubator.config;
+
+import static java.util.stream.Collectors.toList;
+
+import java.util.Arrays;
+import java.util.HashMap;
+import java.util.List;
+import java.util.Map;
+import java.util.Optional;
+import java.util.Set;
+import java.util.function.BiFunction;
+import javax.annotation.Nullable;
+
+final class DeclarativeConfigPropertyUtil {
+
+  private DeclarativeConfigPropertyUtil() {}
+
+  private static final List<BiFunction<String, DeclarativeConfigProperties, Object>>
+      valueResolvers =
+          Arrays.asList(
+              DeclarativeConfigPropertyUtil::getString,
+              DeclarativeConfigPropertyUtil::getBoolean,
+              DeclarativeConfigPropertyUtil::getLong,
+              DeclarativeConfigPropertyUtil::getDouble,
+              DeclarativeConfigPropertyUtil::getStringList,
+              DeclarativeConfigPropertyUtil::getBooleanList,
+              DeclarativeConfigPropertyUtil::getLongList,
+              DeclarativeConfigPropertyUtil::getDoubleList,
+              DeclarativeConfigPropertyUtil::getStringList,
+              DeclarativeConfigPropertyUtil::getStructuredList,
+              DeclarativeConfigPropertyUtil::getStructured);
+
+  static Map<String, Object> toMap(DeclarativeConfigProperties declarativeConfigProperties) {
+    Set<String> propertyKeys = declarativeConfigProperties.getPropertyKeys();
+    Map<String, Object> result = new HashMap<>(propertyKeys.size());
+    for (String key : declarativeConfigProperties.getPropertyKeys()) {
+      result.put(key, resolveValue(key, declarativeConfigProperties));
+    }
+    return result;
+  }
+
+  @Nullable
+  private static Object resolveValue(
+      String key, DeclarativeConfigProperties declarativeConfigProperties) {
+    for (int i = 0; i < valueResolvers.size(); i++) {
+      try {
+        Object value = valueResolvers.get(i).apply(key, declarativeConfigProperties);
+        if (value != null) {
+          return value;
+        }
+      } catch (DeclarativeConfigException e) {
+        // Ignore and continue
+      }
+    }
+    return null;
+  }
+
+  @Nullable
+  private static Object getString(
+      String key, DeclarativeConfigProperties declarativeConfigProperties) {
+    return declarativeConfigProperties.getString(key);
+  }
+
+  @Nullable
+  private static Object getBoolean(
+      String key, DeclarativeConfigProperties declarativeConfigProperties) {
+    return declarativeConfigProperties.getBoolean(key);
+  }
+
+  @Nullable
+  private static Object getLong(
+      String key, DeclarativeConfigProperties declarativeConfigProperties) {
+    return declarativeConfigProperties.getLong(key);
+  }
+
+  @Nullable
+  private static Object getDouble(
+      String key, DeclarativeConfigProperties declarativeConfigProperties) {
+    return declarativeConfigProperties.getDouble(key);
+  }
+
+  @Nullable
+  private static Object getStringList(
+      String key, DeclarativeConfigProperties declarativeConfigProperties) {
+    return declarativeConfigProperties.getScalarList(key, String.class);
+  }
+
+  @Nullable
+  private static Object getBooleanList(
+      String key, DeclarativeConfigProperties declarativeConfigProperties) {
+    return declarativeConfigProperties.getScalarList(key, Boolean.class);
+  }
+
+  @Nullable
+  private static Object getLongList(
+      String key, DeclarativeConfigProperties declarativeConfigProperties) {
+    return declarativeConfigProperties.getScalarList(key, Long.class);
+  }
+
+  @Nullable
+  private static Object getDoubleList(
+      String key, DeclarativeConfigProperties declarativeConfigProperties) {
+    return declarativeConfigProperties.getScalarList(key, Double.class);
+  }
+
+  @Nullable
+  private static Object getStructuredList(
+      String key, DeclarativeConfigProperties declarativeConfigProperties) {
+    return Optional.ofNullable(declarativeConfigProperties.getStructuredList(key))
+        .map(list -> list.stream().map(DeclarativeConfigPropertyUtil::toMap).collect(toList()))
+        .orElse(null);
+  }
+
+  @Nullable
+  private static Object getStructured(
+      String key, DeclarativeConfigProperties declarativeConfigProperties) {
+    return Optional.ofNullable(declarativeConfigProperties.getStructured(key))
+        .map(DeclarativeConfigPropertyUtil::toMap)
+        .orElse(null);
+  }
+}