Update the semantic conventions version to 1.40.0 (#418)

* Update the semantic conventions version to 1.40.0

* Update changelog PR link

* fixes

* spacing

---------

Co-authored-by: otelbot <197425009+otelbot@users.noreply.github.com>
Co-authored-by: Trask Stalnaker <trask.stalnaker@gmail.com>

Author: 3 people

.github/scripts/update-semconv-version.sh

@@ -15,7 +15,7 @@ sed -Ei "s/(    semanticConventionsVersion,)/\1\n    \"$old_version\",/" build.g
 
 # Add new version constant to SchemaUrls.java
 version_underscore=${version//./_}
-sed -Ei "s/(public final class SchemaUrls \{)/\1\n\n  public static final String V${version_underscore} = \"https:\/\/opentelemetry.io\/schemas\/${version}\";/" \
+sed -Ei "s/(public final class SchemaUrls \{)/\1\n  public static final String V${version_underscore} = \"https:\/\/opentelemetry.io\/schemas\/${version}\";/" \
   semconv/src/main/java/io/opentelemetry/semconv/SchemaUrls.java
 
 # Add changelog entry

.github/workflows/auto-update-semconv.yml

@@ -82,6 +82,9 @@ jobs:
       - name: Apply formatting
         run: ./gradlew spotlessApply
 
+      - name: Generate API diffs
+        run: ./gradlew jApiCmp
+
       - name: Use CLA approved bot
         run: .github/scripts/use-cla-approved-bot.sh
 
@@ -99,6 +102,7 @@ jobs:
           git checkout -b $branch
           git add -u
           git add semconv**/src/main/java
+          git add docs/apidiffs/
           git commit -m "$message"
           git push --set-upstream origin $branch
           pr_url=$(gh pr create --title "$message" \

CHANGELOG.md

@@ -2,6 +2,9 @@
 
 ## Unreleased
 
+* Bump to semconv v1.40.0
+  ([#418](https://github.com/open-telemetry/semantic-conventions-java/pull/418))
+
 ## Version 1.39.0 (2026-01-28)
 
 * Bump to semconv v1.39.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.39.0"
+var semanticConventionsVersion = "1.40.0"
 val schemaUrlVersions = listOf(
     semanticConventionsVersion,
+    "1.39.0",
     "1.38.0",
     "1.37.0",
     "1.36.0",

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

@@ -23,11 +23,14 @@
  */
 package io.opentelemetry.semconv.incubating;
 
+import static io.opentelemetry.api.common.AttributeKey.booleanArrayKey;
 import static io.opentelemetry.api.common.AttributeKey.booleanKey;
+import static io.opentelemetry.api.common.AttributeKey.doubleArrayKey;
 import static io.opentelemetry.api.common.AttributeKey.doubleKey;
+import static io.opentelemetry.api.common.AttributeKey.longArrayKey;
 import static io.opentelemetry.api.common.AttributeKey.longKey;
-import static io.opentelemetry.api.common.AttributeKey.stringKey;
 import static io.opentelemetry.api.common.AttributeKey.stringArrayKey;
+import static io.opentelemetry.api.common.AttributeKey.stringKey;
 
 import static io.opentelemetry.semconv.AttributeKeyTemplate.stringArrayKeyTemplate;
 import static io.opentelemetry.semconv.AttributeKeyTemplate.stringKeyTemplate;

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

@@ -22,11 +22,14 @@
  */
 package io.opentelemetry.semconv;
 
+import static io.opentelemetry.api.common.AttributeKey.booleanArrayKey;
 import static io.opentelemetry.api.common.AttributeKey.booleanKey;
+import static io.opentelemetry.api.common.AttributeKey.doubleArrayKey;
 import static io.opentelemetry.api.common.AttributeKey.doubleKey;
+import static io.opentelemetry.api.common.AttributeKey.longArrayKey;
 import static io.opentelemetry.api.common.AttributeKey.longKey;
-import static io.opentelemetry.api.common.AttributeKey.stringKey;
 import static io.opentelemetry.api.common.AttributeKey.stringArrayKey;
+import static io.opentelemetry.api.common.AttributeKey.stringKey;
 
 import static io.opentelemetry.semconv.AttributeKeyTemplate.stringArrayKeyTemplate;
 import static io.opentelemetry.semconv.AttributeKeyTemplate.stringKeyTemplate;

docs/apidiffs/current_vs_latest/opentelemetry-semconv.txt

@@ -1,2 +1,8 @@
-Comparing source compatibility of opentelemetry-semconv-1.39.0-SNAPSHOT.jar against opentelemetry-semconv-1.39.0.jar
-No changes.
+Comparing source compatibility of opentelemetry-semconv-1.40.0-SNAPSHOT.jar against opentelemetry-semconv-1.39.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_40_0
+***  MODIFIED CLASS: PUBLIC FINAL io.opentelemetry.semconv.ServiceAttributes  (not serializable)
+	===  CLASS FILE FORMAT VERSION: 52.0 <- 52.0
+	+++  NEW FIELD: PUBLIC(+) STATIC(+) FINAL(+) io.opentelemetry.api.common.AttributeKey<java.lang.String> SERVICE_INSTANCE_ID
+	+++  NEW FIELD: PUBLIC(+) STATIC(+) FINAL(+) io.opentelemetry.api.common.AttributeKey<java.lang.String> SERVICE_NAMESPACE

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

@@ -425,6 +425,11 @@ public final class DbIncubatingAttributes {
    * href="/docs/db/database-spans.md#generating-a-summary-of-the-query">Generating query
    * summary</a> section.
    *
+   * <p>For batch operations, if the individual operations are known to have the same query summary
+   * then that query summary SHOULD be used prepended by {@code BATCH }, otherwise {@code
+   * db.query.summary} SHOULD be {@code BATCH} or some other database system specific term if more
+   * applicable.
+   *
    * @deprecated deprecated in favor of stable {@link
    *     io.opentelemetry.semconv.DbAttributes#DB_QUERY_SUMMARY} attribute.
    */

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

@@ -24,8 +24,11 @@ public final class ErrorIncubatingAttributes {
    *
    * <p>{@code error.message} is NOT RECOMMENDED for metrics or spans due to its unbounded
    * cardinality and overlap with span status.
+   *
+   * @deprecated Use domain-specific error message attribute. For example, use {@code
+   *     feature_flag.error.message} for feature flag errors.
    */
-  public static final AttributeKey<String> ERROR_MESSAGE = stringKey("error.message");
+  @Deprecated public static final AttributeKey<String> ERROR_MESSAGE = stringKey("error.message");
 
   /**
    * Describes a class of error the operation ended with.

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

@@ -16,6 +16,16 @@ public final class ExceptionIncubatingAttributes {
   /**
    * The exception message.
    *
+   * <p>Notes:
+   *
+   * <blockquote>
+   *
+   * [!WARNING]
+   *
+   * <p>This attribute may contain sensitive information.
+   *
+   * </blockquote>
+   *
    * @deprecated deprecated in favor of stable {@link
    *     io.opentelemetry.semconv.ExceptionAttributes#EXCEPTION_MESSAGE} attribute.
    */