Update the semantic conventions version to 1.42.0

CHANGELOG.md

@@ -2,6 +2,9 @@
 
 ## Unreleased
 
+* Bump to semconv v1.42.0
+  ([#497](https://github.com/open-telemetry/semantic-conventions-java/pull/497))
+
 ## Version 1.41.1 (2026-05-12)
 
 * Bump to semconv v1.41.1

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.41.1"
+var semanticConventionsVersion = "1.42.0"
 val schemaUrlVersions = listOf(
     semanticConventionsVersion,
+    "1.41.1",
     "1.41.0",
     "1.40.0",
     "1.39.0",

docs/apidiffs/current_vs_latest/opentelemetry-semconv.txt

@@ -1,2 +1,56 @@
-Comparing source compatibility of opentelemetry-semconv-1.41.1-SNAPSHOT.jar against opentelemetry-semconv-1.41.1.jar
-No changes.
+Comparing source compatibility of opentelemetry-semconv-1.42.0-SNAPSHOT.jar against opentelemetry-semconv-1.41.1.jar
++++  NEW CLASS: PUBLIC(+) FINAL(+) io.opentelemetry.semconv.ContainerAttributes  (not serializable)
+	+++  CLASS FILE FORMAT VERSION: 52.0 <- n.a.
+	+++  NEW SUPERCLASS: java.lang.Object
+	+++  NEW FIELD: PUBLIC(+) STATIC(+) FINAL(+) io.opentelemetry.api.common.AttributeKey<java.lang.String> CONTAINER_IMAGE_NAME
+	+++  NEW FIELD: PUBLIC(+) STATIC(+) FINAL(+) io.opentelemetry.api.common.AttributeKey<java.util.List<java.lang.String>> CONTAINER_IMAGE_TAGS
+	+++  NEW FIELD: PUBLIC(+) STATIC(+) FINAL(+) io.opentelemetry.api.common.AttributeKey<java.util.List<java.lang.String>> CONTAINER_IMAGE_REPO_DIGESTS
+	+++  NEW FIELD: PUBLIC(+) STATIC(+) FINAL(+) io.opentelemetry.api.common.AttributeKey<java.lang.String> CONTAINER_ID
++++  NEW CLASS: PUBLIC(+) FINAL(+) io.opentelemetry.semconv.K8sAttributes  (not serializable)
+	+++  CLASS FILE FORMAT VERSION: 52.0 <- n.a.
+	+++  NEW SUPERCLASS: java.lang.Object
+	+++  NEW FIELD: PUBLIC(+) STATIC(+) FINAL(+) io.opentelemetry.api.common.AttributeKey<java.lang.String> K8S_CONTAINER_NAME
+	+++  NEW FIELD: PUBLIC(+) STATIC(+) FINAL(+) io.opentelemetry.api.common.AttributeKey<java.lang.String> K8S_POD_UID
+	+++  NEW FIELD: PUBLIC(+) STATIC(+) FINAL(+) io.opentelemetry.api.common.AttributeKey<java.lang.String> K8S_REPLICASET_UID
+	+++  NEW FIELD: PUBLIC(+) STATIC(+) FINAL(+) io.opentelemetry.api.common.AttributeKey<java.lang.String> K8S_POD_NAME
+	+++  NEW FIELD: PUBLIC(+) STATIC(+) FINAL(+) io.opentelemetry.semconv.AttributeKeyTemplate<java.lang.String> K8S_CRONJOB_LABEL
+	+++  NEW FIELD: PUBLIC(+) STATIC(+) FINAL(+) io.opentelemetry.semconv.AttributeKeyTemplate<java.lang.String> K8S_DAEMONSET_ANNOTATION
+	+++  NEW FIELD: PUBLIC(+) STATIC(+) FINAL(+) io.opentelemetry.semconv.AttributeKeyTemplate<java.lang.String> K8S_JOB_ANNOTATION
+	+++  NEW FIELD: PUBLIC(+) STATIC(+) FINAL(+) io.opentelemetry.semconv.AttributeKeyTemplate<java.lang.String> K8S_REPLICASET_ANNOTATION
+	+++  NEW FIELD: PUBLIC(+) STATIC(+) FINAL(+) io.opentelemetry.semconv.AttributeKeyTemplate<java.lang.String> K8S_STATEFULSET_LABEL
+	+++  NEW FIELD: PUBLIC(+) STATIC(+) FINAL(+) io.opentelemetry.api.common.AttributeKey<java.lang.String> K8S_DEPLOYMENT_UID
+	+++  NEW FIELD: PUBLIC(+) STATIC(+) FINAL(+) io.opentelemetry.api.common.AttributeKey<java.lang.String> K8S_NAMESPACE_NAME
+	+++  NEW FIELD: PUBLIC(+) STATIC(+) FINAL(+) io.opentelemetry.api.common.AttributeKey<java.lang.String> K8S_JOB_UID
+	+++  NEW FIELD: PUBLIC(+) STATIC(+) FINAL(+) io.opentelemetry.api.common.AttributeKey<java.lang.String> K8S_NODE_NAME
+	+++  NEW FIELD: PUBLIC(+) STATIC(+) FINAL(+) io.opentelemetry.api.common.AttributeKey<java.lang.String> K8S_POD_HOSTNAME
+	+++  NEW FIELD: PUBLIC(+) STATIC(+) FINAL(+) io.opentelemetry.api.common.AttributeKey<java.lang.String> K8S_JOB_NAME
+	+++  NEW FIELD: PUBLIC(+) STATIC(+) FINAL(+) io.opentelemetry.semconv.AttributeKeyTemplate<java.lang.String> K8S_DAEMONSET_LABEL
+	+++  NEW FIELD: PUBLIC(+) STATIC(+) FINAL(+) io.opentelemetry.api.common.AttributeKey<java.lang.String> K8S_POD_IP
+	+++  NEW FIELD: PUBLIC(+) STATIC(+) FINAL(+) io.opentelemetry.semconv.AttributeKeyTemplate<java.lang.String> K8S_DEPLOYMENT_LABEL
+	+++  NEW FIELD: PUBLIC(+) STATIC(+) FINAL(+) io.opentelemetry.api.common.AttributeKey<java.lang.String> K8S_CRONJOB_NAME
+	+++  NEW FIELD: PUBLIC(+) STATIC(+) FINAL(+) io.opentelemetry.api.common.AttributeKey<java.lang.String> K8S_NODE_UID
+	+++  NEW FIELD: PUBLIC(+) STATIC(+) FINAL(+) io.opentelemetry.api.common.AttributeKey<java.lang.String> K8S_CRONJOB_UID
+	+++  NEW FIELD: PUBLIC(+) STATIC(+) FINAL(+) io.opentelemetry.semconv.AttributeKeyTemplate<java.lang.String> K8S_POD_ANNOTATION
+	+++  NEW FIELD: PUBLIC(+) STATIC(+) FINAL(+) io.opentelemetry.api.common.AttributeKey<java.lang.String> K8S_CLUSTER_UID
+	+++  NEW FIELD: PUBLIC(+) STATIC(+) FINAL(+) io.opentelemetry.semconv.AttributeKeyTemplate<java.lang.String> K8S_CRONJOB_ANNOTATION
+	+++  NEW FIELD: PUBLIC(+) STATIC(+) FINAL(+) io.opentelemetry.api.common.AttributeKey<java.lang.String> K8S_DAEMONSET_NAME
+	+++  NEW FIELD: PUBLIC(+) STATIC(+) FINAL(+) io.opentelemetry.semconv.AttributeKeyTemplate<java.lang.String> K8S_DEPLOYMENT_ANNOTATION
+	+++  NEW FIELD: PUBLIC(+) STATIC(+) FINAL(+) io.opentelemetry.semconv.AttributeKeyTemplate<java.lang.String> K8S_NODE_ANNOTATION
+	+++  NEW FIELD: PUBLIC(+) STATIC(+) FINAL(+) io.opentelemetry.api.common.AttributeKey<java.lang.String> K8S_DEPLOYMENT_NAME
+	+++  NEW FIELD: PUBLIC(+) STATIC(+) FINAL(+) io.opentelemetry.semconv.AttributeKeyTemplate<java.lang.String> K8S_JOB_LABEL
+	+++  NEW FIELD: PUBLIC(+) STATIC(+) FINAL(+) io.opentelemetry.semconv.AttributeKeyTemplate<java.lang.String> K8S_NAMESPACE_LABEL
+	+++  NEW FIELD: PUBLIC(+) STATIC(+) FINAL(+) io.opentelemetry.semconv.AttributeKeyTemplate<java.lang.String> K8S_REPLICASET_LABEL
+	+++  NEW FIELD: PUBLIC(+) STATIC(+) FINAL(+) io.opentelemetry.api.common.AttributeKey<java.lang.String> K8S_STATEFULSET_NAME
+	+++  NEW FIELD: PUBLIC(+) STATIC(+) FINAL(+) io.opentelemetry.api.common.AttributeKey<java.lang.String> K8S_POD_START_TIME
+	+++  NEW FIELD: PUBLIC(+) STATIC(+) FINAL(+) io.opentelemetry.semconv.AttributeKeyTemplate<java.lang.String> K8S_NODE_LABEL
+	+++  NEW FIELD: PUBLIC(+) STATIC(+) FINAL(+) io.opentelemetry.semconv.AttributeKeyTemplate<java.lang.String> K8S_STATEFULSET_ANNOTATION
+	+++  NEW FIELD: PUBLIC(+) STATIC(+) FINAL(+) io.opentelemetry.api.common.AttributeKey<java.lang.String> K8S_STATEFULSET_UID
+	+++  NEW FIELD: PUBLIC(+) STATIC(+) FINAL(+) io.opentelemetry.semconv.AttributeKeyTemplate<java.lang.String> K8S_NAMESPACE_ANNOTATION
+	+++  NEW FIELD: PUBLIC(+) STATIC(+) FINAL(+) io.opentelemetry.semconv.AttributeKeyTemplate<java.lang.String> K8S_POD_LABEL
+	+++  NEW FIELD: PUBLIC(+) STATIC(+) FINAL(+) io.opentelemetry.api.common.AttributeKey<java.lang.String> K8S_REPLICASET_NAME
+	+++  NEW FIELD: PUBLIC(+) STATIC(+) FINAL(+) io.opentelemetry.api.common.AttributeKey<java.lang.String> K8S_DAEMONSET_UID
+	+++  NEW FIELD: PUBLIC(+) STATIC(+) FINAL(+) io.opentelemetry.api.common.AttributeKey<java.lang.Long> K8S_CONTAINER_RESTART_COUNT
+	+++  NEW FIELD: PUBLIC(+) STATIC(+) FINAL(+) io.opentelemetry.api.common.AttributeKey<java.lang.String> K8S_CLUSTER_NAME
+***  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_42_0

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

@@ -19,7 +19,7 @@ public final class AndroidIncubatingAttributes {
    * <p>Notes:
    *
    * <p>The Android lifecycle states are defined in <a
-   * href="https://developer.android.com/guide/components/activities/activity-lifecycle#lc">Activity
+   * href="https://developer.android.com/guide/components/activities/activity-lifecycle#lifecycle-callbacks">Activity
    * lifecycle callbacks</a>, and from which the {@code OS identifiers} are derived.
    */
   public static final AttributeKey<String> ANDROID_APP_STATE = stringKey("android.app.state");

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

@@ -18,6 +18,18 @@ public final class AppIncubatingAttributes {
   /** Unique identifier for a particular build or compilation of the application. */
   public static final AttributeKey<String> APP_BUILD_ID = stringKey("app.build_id");
 
+  /**
+   * A unique identifier representing an instance of an end-user facing app crash.
+   *
+   * <p>Notes:
+   *
+   * <p>Its value MAY be meaningful and be used as a reference for telemetry and metadata recorded
+   * by the same instrumentation (e.g. it is an ID generated by an external source that captured the
+   * crash). It MAY come from a source external to the instrumentation such that it can be used to
+   * look up additional data from other sources as well as facilitate deduplication.
+   */
+  public static final AttributeKey<String> APP_CRASH_ID = stringKey("app.crash.id");
+
   /**
    * A unique identifier representing the installation of an application on a specific device
    *

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

@@ -27,6 +27,13 @@ public final class BrowserIncubatingAttributes {
    */
   public static final AttributeKey<List<String>> BROWSER_BRANDS = stringArrayKey("browser.brands");
 
+  /**
+   * Absolute URL of the current browser document according to <a
+   * href="https://www.rfc-editor.org/rfc/rfc3986">RFC3986</a>.
+   */
+  public static final AttributeKey<String> BROWSER_DOCUMENT_URL_FULL =
+      stringKey("browser.document.url.full");
+
   /**
    * Preferred language of the user using the browser
    *

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

@@ -73,17 +73,17 @@ public final class CicdIncubatingAttributes {
   public static final AttributeKey<String> CICD_PIPELINE_TASK_TYPE =
       stringKey("cicd.pipeline.task.type");
 
-  /** The name of a component of the CICD system. */
+  /** The name of a component of the CI/CD system. */
   public static final AttributeKey<String> CICD_SYSTEM_COMPONENT =
       stringKey("cicd.system.component");
 
-  /** The unique identifier of a worker within a CICD system. */
+  /** The unique identifier of a worker within a CI/CD system. */
   public static final AttributeKey<String> CICD_WORKER_ID = stringKey("cicd.worker.id");
 
-  /** The name of a worker within a CICD system. */
+  /** The name of a worker within a CI/CD system. */
   public static final AttributeKey<String> CICD_WORKER_NAME = stringKey("cicd.worker.name");
 
-  /** The state of a CICD worker / agent. */
+  /** The state of a CI/CD worker / agent. */
   public static final AttributeKey<String> CICD_WORKER_STATE = stringKey("cicd.worker.state");
 
   /**
@@ -121,7 +121,7 @@ public static final class CicdPipelineResultIncubatingValues {
     public static final String FAILURE = "failure";
 
     /**
-     * The pipeline run failed due to an error in the CICD system, eg. due to the worker being
+     * The pipeline run failed due to an error in the CI/CD system, eg. due to the worker being
      * killed.
      */
     public static final String ERROR = "error";
@@ -170,7 +170,7 @@ public static final class CicdPipelineTaskRunResultIncubatingValues {
     public static final String FAILURE = "failure";
 
     /**
-     * The task run failed due to an error in the CICD system, eg. due to the worker being killed.
+     * The task run failed due to an error in the CI/CD system, eg. due to the worker being killed.
      */
     public static final String ERROR = "error";
 
@@ -203,15 +203,15 @@ private CicdPipelineTaskTypeIncubatingValues() {}
   /** Values for {@link #CICD_WORKER_STATE}. */
   public static final class CicdWorkerStateIncubatingValues {
     /**
-     * The worker is not performing work for the CICD system. It is available to the CICD system to
-     * perform work on (online / idle).
+     * The worker is not performing work for the CI/CD system. It is available to the CI/CD system
+     * to perform work on (online / idle).
      */
     public static final String AVAILABLE = "available";
 
-    /** The worker is performing work for the CICD system. */
+    /** The worker is performing work for the CI/CD system. */
     public static final String BUSY = "busy";
 
-    /** The worker is not available to the CICD system (disconnected / down). */
+    /** The worker is not available to the CI/CD system (disconnected / down). */
     public static final String OFFLINE = "offline";
 
     private CicdWorkerStateIncubatingValues() {}

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

@@ -72,8 +72,11 @@ public final class ContainerIncubatingAttributes {
    * Container ID. Usually a UUID, as for example used to <a
    * href="https://docs.docker.com/engine/containers/run/#container-identification">identify Docker
    * containers</a>. The UUID might be abbreviated.
+   *
+   * @deprecated deprecated in favor of stable {@link
+   *     io.opentelemetry.semconv.ContainerAttributes#CONTAINER_ID} attribute.
    */
-  public static final AttributeKey<String> CONTAINER_ID = stringKey("container.id");
+  @Deprecated public static final AttributeKey<String> CONTAINER_ID = stringKey("container.id");
 
   /**
    * Runtime specific image identifier. Usually a hash algorithm followed by a UUID.
@@ -92,7 +95,13 @@ public final class ContainerIncubatingAttributes {
    */
   public static final AttributeKey<String> CONTAINER_IMAGE_ID = stringKey("container.image.id");
 
-  /** Name of the image the container was built on. */
+  /**
+   * Name of the image the container was built on.
+   *
+   * @deprecated deprecated in favor of stable {@link
+   *     io.opentelemetry.semconv.ContainerAttributes#CONTAINER_IMAGE_NAME} attribute.
+   */
+  @Deprecated
   public static final AttributeKey<String> CONTAINER_IMAGE_NAME = stringKey("container.image.name");
 
   /**
@@ -105,7 +114,11 @@ public final class ContainerIncubatingAttributes {
    * 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.
+   *
+   * @deprecated deprecated in favor of stable {@link
+   *     io.opentelemetry.semconv.ContainerAttributes#CONTAINER_IMAGE_REPO_DIGESTS} attribute.
    */
+  @Deprecated
   public static final AttributeKey<List<String>> CONTAINER_IMAGE_REPO_DIGESTS =
       stringArrayKey("container.image.repo_digests");
 
@@ -114,7 +127,11 @@ public final class ContainerIncubatingAttributes {
    * href="https://docs.docker.com/reference/api/engine/version/v1.52/#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>}.
+   *
+   * @deprecated deprecated in favor of stable {@link
+   *     io.opentelemetry.semconv.ContainerAttributes#CONTAINER_IMAGE_TAGS} attribute.
    */
+  @Deprecated
   public static final AttributeKey<List<String>> CONTAINER_IMAGE_TAGS =
       stringArrayKey("container.image.tags");
 

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

@@ -45,8 +45,12 @@ public static final class CpuModeIncubatingValues {
     /** Steal */
     public static final String STEAL = "steal";
 
-    /** Kernel */
-    public static final String KERNEL = "kernel";
+    /**
+     * Deprecated. Use {@code system} instead.
+     *
+     * @deprecated Replaced by {@code system}.
+     */
+    @Deprecated public static final String KERNEL = "kernel";
 
     private CpuModeIncubatingValues() {}
   }

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

@@ -100,6 +100,25 @@ public final class FileIncubatingAttributes {
   /** Inode representing the file in the filesystem. */
   public static final AttributeKey<String> FILE_INODE = stringKey("file.inode");
 
+  /**
+   * The lock mechanism such as noted by <a
+   * href="https://pubs.opengroup.org/onlinepubs/9699919799/functions/fcntl.html">POSIX</a>
+   */
+  public static final AttributeKey<String> FILE_LOCK_MECHANISM = stringKey("file.lock.mechanism");
+
+  /**
+   * Mode of lock or operation such as documented by <a
+   * href="https://pubs.opengroup.org/onlinepubs/9699919799/functions/fcntl.html">POSIX</a>
+   */
+  public static final AttributeKey<String> FILE_LOCK_MODE = stringKey("file.lock.mode");
+
+  /**
+   * The lock type as represented by i.e. <a
+   * href="https://pubs.opengroup.org/onlinepubs/9699919799/functions/fcntl.html">POSIX</a>'s
+   * l_type.
+   */
+  public static final AttributeKey<String> FILE_LOCK_TYPE = stringKey("file.lock.type");
+
   /** Mode of the file in octal representation. */
   public static final AttributeKey<String> FILE_MODE = stringKey("file.mode");
 
@@ -136,5 +155,16 @@ public final class FileIncubatingAttributes {
 
   // Enum definitions
 
+  /** Values for {@link #FILE_LOCK_TYPE}. */
+  public static final class FileLockTypeIncubatingValues {
+    /** read. */
+    public static final String READ = "read";
+
+    /** write. */
+    public static final String WRITE = "write";
+
+    private FileLockTypeIncubatingValues() {}
+  }
+
   private FileIncubatingAttributes() {}
 }

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

@@ -7,8 +7,10 @@
 
 import static io.opentelemetry.api.common.AttributeKey.longKey;
 import static io.opentelemetry.api.common.AttributeKey.stringKey;
+import static io.opentelemetry.semconv.AttributeKeyTemplate.stringKeyTemplate;
 
 import io.opentelemetry.api.common.AttributeKey;
+import io.opentelemetry.semconv.AttributeKeyTemplate;
 
 // DO NOT EDIT, this is an Auto-generated file from
 // buildscripts/templates/registry/incubating_java/IncubatingSemanticAttributes.java.j2
@@ -166,6 +168,18 @@ public final class GcpIncubatingAttributes {
   public static final AttributeKey<String> GCP_GCE_INSTANCE_HOSTNAME =
       stringKey("gcp.gce.instance.hostname");
 
+  /**
+   * GCE instance labels, {@code <key>} being the label name and the value being the label value.
+   *
+   * <p>Notes:
+   *
+   * <p>For example, a GCE instance label {@code team} with value {@code observability} SHOULD be
+   * recorded as the {@code gcp.gce.instance.labels.team} attribute with value {@code
+   * "observability"}. The {@code <key>} MUST be the exact GCE instance label key.
+   */
+  public static final AttributeKeyTemplate<String> GCP_GCE_INSTANCE_LABELS =
+      stringKeyTemplate("gcp.gce.instance.labels");
+
   /**
    * The instance name of a GCE instance. This is the value provided by {@code host.name}, the
    * visible name of the instance in the Cloud Console UI, and the prefix for the default hostname