Update semantic conventions to 1.38.0

Co-authored-by: trask <218610+trask@users.noreply.github.com>

Author: Copilot

CHANGELOG.md

@@ -2,6 +2,8 @@
 
 ## Unreleased
 
+* Bump to semconv v1.38.0
+
 ## Version 1.37.0 (2025-08-27)
 
 * Bump to semconv v1.37.0

build.gradle.kts

@@ -11,9 +11,10 @@ val snapshot = true
 // end
 
 // The release version of https://github.com/open-telemetry/semantic-conventions used to generate classes
-var semanticConventionsVersion = "1.37.0"
+var semanticConventionsVersion = "1.38.0"
 val schemaUrlVersions = listOf(
     semanticConventionsVersion,
+    "1.37.0",
     "1.36.0",
     "1.35.0",
     "1.34.0",

docs/apidiffs/current_vs_latest/opentelemetry-semconv.txt

@@ -1,2 +1,4 @@
-Comparing source compatibility of opentelemetry-semconv-1.37.0-SNAPSHOT.jar against opentelemetry-semconv-1.37.0.jar
-No changes.
+Comparing source compatibility of opentelemetry-semconv-1.38.0-SNAPSHOT.jar against opentelemetry-semconv-1.37.0.jar
+***  MODIFIED CLASS: PUBLIC FINAL io.opentelemetry.semconv.SchemaUrls  (not serializable)
+	===  CLASS FILE FORMAT VERSION: 52.0 <- 52.0
+	+++  NEW FIELD: PUBLIC(+) STATIC(+) FINAL(+) java.lang.String V1_38_0

semconv-incubating/src/main/java/io/opentelemetry/semconv/incubating/AppIncubatingAttributes.java

@@ -77,6 +77,29 @@ public final class AppIncubatingAttributes {
   public static final AttributeKey<Long> APP_SCREEN_COORDINATE_Y =
       longKey("app.screen.coordinate.y");
 
+  /**
+   * An identifier that uniquely differentiates this screen from other screens in the same
+   * application.
+   *
+   * <p>Notes:
+   *
+   * <p>A screen represents only the part of the device display drawn by the app. It typically
+   * contains multiple widgets or UI components and is larger in scope than individual widgets.
+   * Multiple screens can coexist on the same display simultaneously (e.g., split view on tablets).
+   */
+  public static final AttributeKey<String> APP_SCREEN_ID = stringKey("app.screen.id");
+
+  /**
+   * The name of an application screen.
+   *
+   * <p>Notes:
+   *
+   * <p>A screen represents only the part of the device display drawn by the app. It typically
+   * contains multiple widgets or UI components and is larger in scope than individual widgets.
+   * Multiple screens can coexist on the same display simultaneously (e.g., split view on tablets).
+   */
+  public static final AttributeKey<String> APP_SCREEN_NAME = stringKey("app.screen.name");
+
   /**
    * An identifier that uniquely differentiates this widget from other widgets in the same
    * application.

semconv-incubating/src/main/java/io/opentelemetry/semconv/incubating/AzureIncubatingAttributes.java

@@ -39,7 +39,7 @@ public final class AzureIncubatingAttributes {
    * <p>Notes:
    *
    * <p>Region name matches the format of {@code displayName} in <a
-   * href="https://learn.microsoft.com/rest/api/subscription/subscriptions/list-locations?view=rest-subscription-2021-10-01&tabs=HTTP#location">Azure
+   * href="https://learn.microsoft.com/rest/api/resources/subscriptions/list-locations">Azure
    * Location API</a>
    */
   public static final AttributeKey<List<String>> AZURE_COSMOSDB_OPERATION_CONTACTED_REGIONS =

semconv-incubating/src/main/java/io/opentelemetry/semconv/incubating/ContainerIncubatingAttributes.java

@@ -82,7 +82,7 @@ public final class ContainerIncubatingAttributes {
    *
    * <p>Docker defines a sha256 of the image id; {@code container.image.id} corresponds to the
    * {@code Image} field from the Docker container inspect <a
-   * href="https://docs.docker.com/engine/api/v1.43/#tag/Container/operation/ContainerInspect">API</a>
+   * href="https://docs.docker.com/reference/api/engine/version/v1.43/#tag/Container/operation/ContainerInspect">API</a>
    * endpoint. K8s defines a link to the container registry repository with digest {@code "imageID":
    * "registry.azurecr.io
    * /namespace/service/dockerfile@sha256:bdeabd40c3a8a492eaf9e8e44d0ebbb84bac7ee25ac0cf8a7159d25f62555625"}.
@@ -101,7 +101,7 @@ public final class ContainerIncubatingAttributes {
    * <p>Notes:
    *
    * <p><a
-   * href="https://docs.docker.com/engine/api/v1.43/#tag/Image/operation/ImageInspect">Docker</a>
+   * href="https://docs.docker.com/reference/api/engine/version/v1.43/#tag/Image/operation/ImageInspect">Docker</a>
    * and <a
    * href="https://github.com/kubernetes/cri-api/blob/c75ef5b473bbe2d0a4fc92f82235efd665ea8e9f/pkg/apis/runtime/v1/api.proto#L1237-L1238">CRI</a>
    * report those under the {@code RepoDigests} field.
@@ -111,9 +111,9 @@ public final class ContainerIncubatingAttributes {
 
   /**
    * Container image tags. An example can be found in <a
-   * href="https://docs.docker.com/engine/api/v1.43/#tag/Image/operation/ImageInspect">Docker Image
-   * Inspect</a>. Should be only the {@code <tag>} section of the full name for example from {@code
-   * registry.example.com/my-org/my-image:<tag>}.
+   * href="https://docs.docker.com/reference/api/engine/version/v1.43/#tag/Image/operation/ImageInspect">Docker
+   * Image Inspect</a>. Should be only the {@code <tag>} section of the full name for example from
+   * {@code registry.example.com/my-org/my-image:<tag>}.
    */
   public static final AttributeKey<List<String>> CONTAINER_IMAGE_TAGS =
       stringArrayKey("container.image.tags");

semconv-incubating/src/main/java/io/opentelemetry/semconv/incubating/DbIncubatingAttributes.java

@@ -217,7 +217,7 @@ public final class DbIncubatingAttributes {
   /**
    * Deprecated, use {@code db.response.status_code} instead.
    *
-   * @deprecated Replaced by {@code db.response.status_code}.
+   * @deprecated Use {@code db.response.status_code} instead.
    */
   @Deprecated
   public static final AttributeKey<Long> DB_COSMOSDB_STATUS_CODE =
@@ -393,15 +393,18 @@ public final class DbIncubatingAttributes {
    * <p>{@code db.query.parameter.<key>} SHOULD match up with the parameterized placeholders present
    * in {@code db.query.text}.
    *
+   * <p>It is RECOMMENDED to capture the value as provided by the application without attempting to
+   * do any case normalization.
+   *
    * <p>{@code db.query.parameter.<key>} SHOULD NOT be captured on batch operations.
    *
    * <p>Examples:
    *
    * <ul>
    *   <li>For a query {@code SELECT * FROM users where username = %s} with the parameter {@code
    *       "jdoe"}, the attribute {@code db.query.parameter.0} SHOULD be set to {@code "jdoe"}.
-   *   <li>For a query {@code "SELECT * FROM users WHERE username = %(username)s;} with parameter
-   *       {@code username = "jdoe"}, the attribute {@code db.query.parameter.username} SHOULD be
+   *   <li>For a query {@code "SELECT * FROM users WHERE username = %(userName)s;} with parameter
+   *       {@code userName = "jdoe"}, the attribute {@code db.query.parameter.userName} SHOULD be
    *       set to {@code "jdoe"}.
    * </ul>
    */
@@ -452,7 +455,7 @@ public final class DbIncubatingAttributes {
   /**
    * Deprecated, use {@code db.namespace} instead.
    *
-   * @deprecated Replaced by {@code db.namespace}.
+   * @deprecated Uncategorized.
    */
   @Deprecated
   public static final AttributeKey<Long> DB_REDIS_DATABASE_INDEX =

semconv-incubating/src/main/java/io/opentelemetry/semconv/incubating/DnsIncubatingAttributes.java

@@ -23,10 +23,8 @@ public final class DnsIncubatingAttributes {
    *
    * <p>Notes:
    *
-   * <p>If the name field contains non-printable characters (below 32 or above 126), those
-   * characters should be represented as escaped base 10 integers (\DDD). Back slashes and quotes
-   * should be escaped. Tabs, carriage returns, and line feeds should be converted to \t, \r, and \n
-   * respectively.
+   * <p>The name represents the queried domain name as it appears in the DNS query without any
+   * additional normalization.
    */
   public static final AttributeKey<String> DNS_QUESTION_NAME = stringKey("dns.question.name");
 

semconv-incubating/src/main/java/io/opentelemetry/semconv/incubating/EnduserIncubatingAttributes.java

@@ -48,7 +48,7 @@ public final class EnduserIncubatingAttributes {
   /**
    * Deprecated, use {@code user.roles} instead.
    *
-   * @deprecated Replaced by {@code user.roles}.
+   * @deprecated Use {@code user.roles} instead.
    */
   @Deprecated public static final AttributeKey<String> ENDUSER_ROLE = stringKey("enduser.role");
 

semconv-incubating/src/main/java/io/opentelemetry/semconv/incubating/EventIncubatingAttributes.java

@@ -16,7 +16,8 @@ public final class EventIncubatingAttributes {
   /**
    * Identifies the class / type of event.
    *
-   * @deprecated Replaced by EventName top-level field on the LogRecord.
+   * @deprecated The value of this attribute MUST now be set as the value of the EventName field on
+   *     the LogRecord to indicate that the LogRecord represents an Event.
    */
   @Deprecated public static final AttributeKey<String> EVENT_NAME = stringKey("event.name");