Update semantic conventions to 1.38.0 (#384)

* Initial plan

* Update semantic conventions to 1.38.0

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

* Exclude 'Uncategorized.' from deprecation messages in generated code

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

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
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",

buildscripts/templates/registry/incubating_java/IncubatingSemanticAttributes.java.j2

@@ -43,7 +43,11 @@ public final class {{ my_class_name }} {
   {%- for attribute in ctx.attributes | rejectattr("name", "in", ctx.excluded_attributes) | rejectattr("type", "eq", "any") -%}
     {%- if attribute is experimental -%}
       {%- if attribute is deprecated -%}
-        {%- set deprecated_javadoc = "@deprecated " ~ attribute.deprecated.note -%}
+        {%- if attribute.deprecated.note == "Uncategorized." -%}
+          {%- set deprecated_javadoc = "@deprecated" -%}
+        {%- else -%}
+          {%- set deprecated_javadoc = "@deprecated " ~ attribute.deprecated.note -%}
+        {%- endif -%}
       {%- else -%}
         {%- set deprecated_javadoc = "" -%}
       {%- endif -%}
@@ -80,7 +84,11 @@ public final class {{ my_class_name }} {
        *  @deprecated deprecated in favor of stable {@link {{stable_class_link}}}.
        */
     {%- elif attribute is deprecated -%}
-      {{ ["Values for {@link #" ~ attribute.name | screaming_snake_case ~ "}", "@deprecated " ~ attribute.deprecated.note ] | comment }}
+      {%- if attribute.deprecated.note == "Uncategorized." -%}
+        {{ ["Values for {@link #" ~ attribute.name | screaming_snake_case ~ "}", "@deprecated"] | comment }}
+      {%- else -%}
+        {{ ["Values for {@link #" ~ attribute.name | screaming_snake_case ~ "}", "@deprecated " ~ attribute.deprecated.note ] | comment }}
+      {%- endif -%}
     {%- else -%}
       /** Values for {@link #{{ attribute.name | screaming_snake_case }}}. */
     {%- endif -%}
@@ -90,7 +98,11 @@ public final class {{ my_class_name }} {
     public static final class {{ attribute.name | pascal_case }}IncubatingValues {
       {%- for member in attribute.type.members %}
         {%- if member is experimental and member is deprecated -%}
-          {{ [member.brief or (member.id ~ '.'), "@deprecated " ~ member.deprecated.note] | comment }}
+          {%- if member.deprecated.note == "Uncategorized." -%}
+            {{ [member.brief or (member.id ~ '.'), "@deprecated"] | comment }}
+          {%- else -%}
+            {{ [member.brief or (member.id ~ '.'), "@deprecated " ~ member.deprecated.note] | comment }}
+          {%- endif -%}
             @Deprecated public static final {{ attribute.type | instantiated_type | map_text("java_enum_type") }} {{ member.id | screaming_snake_case }} = {{ member.value | print_member_value }};
         {% elif member is experimental or enum_deprecated_in_favor_of_stable.value %}
           {{ [member.brief or (member.id ~ '.')] | comment }}

buildscripts/templates/registry/java/SemanticAttributes.java.j2

@@ -41,7 +41,11 @@ public final class {{ my_class_name }} {
   {%- for attribute in ctx.attributes | rejectattr("name", "in", ctx.excluded_attributes) -%}
     {%- if attribute is stable -%}
       {%- if attribute is deprecated -%}
-        {%- set deprecated_javadoc = "@deprecated " ~ attribute.deprecated.note -%}
+        {%- if attribute.deprecated.note == "Uncategorized." -%}
+          {%- set deprecated_javadoc = "@deprecated" -%}
+        {%- else -%}
+          {%- set deprecated_javadoc = "@deprecated " ~ attribute.deprecated.note -%}
+        {%- endif -%}
       {%- endif -%}
       {{ [attribute.brief, concat_if("\n\nNotes:\n\n", attribute.note), deprecated_javadoc] | comment }}
       {%- if attribute is deprecated -%}

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
    */
   @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");