opentelemetry-semantic_conventions 1.41.0 → 1.42.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4c0338c46c79107495c86964d690d5f0db7b3cb222ed683ea4c81dd97040032b
-  data.tar.gz: a213a8550ea2b4aab219df00677c06f1f9f98f39a67c09ff82dab070a5013c09
+  metadata.gz: dc7a3272858c8f6b81b0bf6fe79daaf2dbe86ea9998cdf8d9de9931ae39f8a78
+  data.tar.gz: 55c64947141573ee3c72b2e563c98aab71d84bf86a50076513da34ab552cf299
 SHA512:
-  metadata.gz: 7ef135235380d18753a8fe2e12bd3967a85ad7502e7704644efe573e5966ca1399d91f5f157b0fa7811d06a11fe19551b5d52d55cfd0460c9dad624bc062b836
-  data.tar.gz: 96bf1f471baa38882224599fe57fcb61b5a1d9acac4af2458050ca6c92f855cf90e84dffd606ed4855825543bd7ed8d34308c548c6a39d832e1236b4b8a42f06
+  metadata.gz: 581dc30386c954d919f3cb0ea205b2230f11e78035b92e68b6e79ebea143aa791aeab0f8c16f15730f92140f4f17e45b6189620839c0813f6022ae9c1d14eabc
+  data.tar.gz: ad1f871f3bfae12f3ab40f86ba999c8e759d1e16304c68353c52ab8da6abca50c58f9c46ecfb38189fc8128210309651a45133124906e65a0e32f1466717823a

data/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Release History: opentelemetry-semantic_conventions
 
+### v1.42.0 / 2026-07-07
+
+* ADDED: Autoload namespaces so a single require exposes all constants (#2204)
+* ADDED: Update dependency open-telemetry/semantic-conventions to v1.42.0 (#2195)
+
 ### v1.41.0 / 2026-06-10
 
 * ADDED: Update dependency open-telemetry/semantic-conventions to v1.41.1 (#2184)

data/README.md

@@ -55,12 +55,19 @@ These constants will be preserved to avoid breaking changes for users who rely
 on the old constants. These constants do not differentiate between stable and
 unstable constants. New constants will not be added to this namespace.
 
-We recommend you require only the files that contain the constants you are going
-to use. For example, if you were creating instrumentation for an HTTP Client
-that emits only stable conventions, you would likely require:
+Require the gem once and reference any constant directly. Each namespace is
+registered with Ruby's `autoload`, so the file backing a namespace is only loaded
+the first time you reference one of its constants — you don't pay to load
+conventions you never use.
 
 ```rb
-require 'opentelemetry/semconv/http'
+require 'opentelemetry-semantic_conventions'
+
+# Stable
+OpenTelemetry::SemConv::HTTP::HTTP_REQUEST_METHOD            # => 'http.request.method'
+
+# Incubating (experimental/deprecated)
+OpenTelemetry::SemConv::Incubating::GEN_AI::GEN_AI_SYSTEM
 ```
 
 If you want to require all of the 1.11.0 constants, you can use:

data/lib/opentelemetry/semantic_conventions/version.rb

@@ -7,8 +7,8 @@
 module OpenTelemetry
   module SemanticConventions
     # Version of the OpenTelemetry Semantic Conventions from which this library was generated.
-    SPEC_VERSION = '1.41.1'
+    SPEC_VERSION = '1.42.0'
     # Release version of this gem. May not match SPEC_VERSION until gem is released after a spec update.
-    VERSION = '1.41.0'
+    VERSION = '1.42.0'
   end
 end

data/lib/opentelemetry/semconv/container/attributes.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+# Copyright The OpenTelemetry Authors
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+# SPDX-License-Identifier: Apache-2.0
+#
+# This file was autogenerated. Do not edit it by hand.
+
+module OpenTelemetry
+  module SemConv
+    module CONTAINER
+      # @!group Attribute Names
+
+      # Container ID. Usually a UUID, as for example used to [identify Docker containers](https://docs.docker.com/engine/containers/run/#container-identification). The UUID might be abbreviated.
+      #
+      # @note Stability Level: stable
+      CONTAINER_ID = 'container.id'
+
+      # Name of the image the container was built on.
+      #
+      # @note Stability Level: stable
+      CONTAINER_IMAGE_NAME = 'container.image.name'
+
+      # Repo digests of the container image as provided by the container runtime.
+      #
+      # [Docker](https://docs.docker.com/reference/api/engine/version/v1.52/#tag/Image/operation/ImageInspect) and [CRI](https://github.com/kubernetes/cri-api/blob/c75ef5b473bbe2d0a4fc92f82235efd665ea8e9f/pkg/apis/runtime/v1/api.proto#L1237-L1238) report those under the `RepoDigests` field.
+      #
+      # @note Stability Level: stable
+      CONTAINER_IMAGE_REPO_DIGESTS = 'container.image.repo_digests'
+
+      # Container image tags. An example can be found in [Docker Image Inspect](https://docs.docker.com/reference/api/engine/version/v1.52/#tag/Image/operation/ImageInspect). Should be only the `<tag>` section of the full name for example from `registry.example.com/my-org/my-image:<tag>`.
+      #
+      # @note Stability Level: stable
+      CONTAINER_IMAGE_TAGS = 'container.image.tags'
+
+      # @!endgroup
+    end
+  end
+end

data/lib/opentelemetry/semconv/container.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+# Copyright The OpenTelemetry Authors
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+# SPDX-License-Identifier: Apache-2.0
+
+# This file was autogenerated. Do not edit it by hand.
+
+require_relative 'container/attributes'

data/lib/opentelemetry/semconv/incubating/android/attributes.rb

@@ -26,7 +26,7 @@ module OpenTelemetry
 
         # This attribute represents the state of the application.
         #
-        # The Android lifecycle states are defined in [Activity lifecycle callbacks](https://developer.android.com/guide/components/activities/activity-lifecycle#lc), and from which the `OS identifiers` are derived.
+        # The Android lifecycle states are defined in [Activity lifecycle callbacks](https://developer.android.com/guide/components/activities/activity-lifecycle#lifecycle-callbacks), and from which the `OS identifiers` are derived.
         #
         # @note Stability Level: development
         ANDROID_APP_STATE = 'android.app.state'

data/lib/opentelemetry/semconv/incubating/app/attributes.rb

@@ -29,6 +29,16 @@ module OpenTelemetry
         # @note Stability Level: development
         APP_BUILD_ID = 'app.build_id'
 
+        # A unique identifier representing an instance of an end-user facing app crash.
+        #
+        # 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.
+        #
+        # @note Stability Level: development
+        APP_CRASH_ID = 'app.crash.id'
+
         # A unique identifier representing the installation of an application on a specific device
         #
         # Its value SHOULD persist across launches of the same application installation, including through application upgrades.

data/lib/opentelemetry/semconv/incubating/browser/attributes.rb

@@ -31,6 +31,11 @@ module OpenTelemetry
         # @note Stability Level: development
         BROWSER_BRANDS = 'browser.brands'
 
+        # Absolute URL of the current browser document according to [RFC3986](https://www.rfc-editor.org/rfc/rfc3986).
+        #
+        # @note Stability Level: development
+        BROWSER_DOCUMENT_URL_FULL = 'browser.document.url.full'
+
         # Preferred language of the user using the browser
         #
         # This value is intended to be taken from the Navigator API `navigator.language`.

data/lib/opentelemetry/semconv/incubating/cicd/attributes.rb

@@ -81,22 +81,22 @@ module OpenTelemetry
         # @note Stability Level: development
         CICD_PIPELINE_TASK_TYPE = 'cicd.pipeline.task.type'
 
-        # The name of a component of the CICD system.
+        # The name of a component of the CI/CD system.
         #
         # @note Stability Level: development
         CICD_SYSTEM_COMPONENT = 'cicd.system.component'
 
-        # The unique identifier of a worker within a CICD system.
+        # The unique identifier of a worker within a CI/CD system.
         #
         # @note Stability Level: development
         CICD_WORKER_ID = 'cicd.worker.id'
 
-        # The name of a worker within a CICD system.
+        # The name of a worker within a CI/CD system.
         #
         # @note Stability Level: development
         CICD_WORKER_NAME = 'cicd.worker.name'
 
-        # The state of a CICD worker / agent.
+        # The state of a CI/CD worker / agent.
         #
         # @note Stability Level: development
         CICD_WORKER_STATE = 'cicd.worker.state'

data/lib/opentelemetry/semconv/incubating/cicd/metrics.rb

@@ -42,14 +42,14 @@ module OpenTelemetry
         # @note Stability Level: development
         CICD_PIPELINE_RUN_ERRORS = 'cicd.pipeline.run.errors'
 
-        # The number of errors in a component of the CICD system (eg. controller, scheduler, agent).
+        # The number of errors in a component of the CI/CD system (eg. controller, scheduler, agent).
         #
         # Errors in pipeline run execution are explicitly excluded. Ie a test failure is not counted in this metric.
         #
         # @note Stability Level: development
         CICD_SYSTEM_ERRORS = 'cicd.system.errors'
 
-        # The number of workers on the CICD system by state.
+        # The number of workers on the CI/CD system by state.
         #
         # @note Stability Level: development
         CICD_WORKER_COUNT = 'cicd.worker.count'

data/lib/opentelemetry/semconv/incubating/container/attributes.rb

@@ -63,7 +63,9 @@ module OpenTelemetry
 
         # Container ID. Usually a UUID, as for example used to [identify Docker containers](https://docs.docker.com/engine/containers/run/#container-identification). The UUID might be abbreviated.
         #
-        # @note Stability Level: release_candidate
+        # @note Stability Level: stable
+        #
+        # @deprecated Now available in the stable namespace at {OpenTelemetry::SemConv::CONTAINER::CONTAINER_ID}.
         CONTAINER_ID = 'container.id'
 
         # Runtime specific image identifier. Usually a hash algorithm followed by a UUID.
@@ -77,19 +79,25 @@ module OpenTelemetry
 
         # Name of the image the container was built on.
         #
-        # @note Stability Level: release_candidate
+        # @note Stability Level: stable
+        #
+        # @deprecated Now available in the stable namespace at {OpenTelemetry::SemConv::CONTAINER::CONTAINER_IMAGE_NAME}.
         CONTAINER_IMAGE_NAME = 'container.image.name'
 
         # Repo digests of the container image as provided by the container runtime.
         #
         # [Docker](https://docs.docker.com/reference/api/engine/version/v1.52/#tag/Image/operation/ImageInspect) and [CRI](https://github.com/kubernetes/cri-api/blob/c75ef5b473bbe2d0a4fc92f82235efd665ea8e9f/pkg/apis/runtime/v1/api.proto#L1237-L1238) report those under the `RepoDigests` field.
         #
-        # @note Stability Level: release_candidate
+        # @note Stability Level: stable
+        #
+        # @deprecated Now available in the stable namespace at {OpenTelemetry::SemConv::CONTAINER::CONTAINER_IMAGE_REPO_DIGESTS}.
         CONTAINER_IMAGE_REPO_DIGESTS = 'container.image.repo_digests'
 
         # Container image tags. An example can be found in [Docker Image Inspect](https://docs.docker.com/reference/api/engine/version/v1.52/#tag/Image/operation/ImageInspect). Should be only the `<tag>` section of the full name for example from `registry.example.com/my-org/my-image:<tag>`.
         #
-        # @note Stability Level: release_candidate
+        # @note Stability Level: stable
+        #
+        # @deprecated Now available in the stable namespace at {OpenTelemetry::SemConv::CONTAINER::CONTAINER_IMAGE_TAGS}.
         CONTAINER_IMAGE_TAGS = 'container.image.tags'
 
         # Must be called with a key for the full attribute name. See notes below about the expectations

data/lib/opentelemetry/semconv/incubating/container/metrics.rb

@@ -24,11 +24,11 @@ module OpenTelemetry
       module CONTAINER
         # @!group Metrics Names
 
-        # Total CPU time consumed.
+        # CPU time consumed.
         #
-        # Total CPU time consumed by the specific container on all available CPU cores
+        # CPU time consumed by the specific container on all available CPU cores
         #
-        # @note Stability Level: development
+        # @note Stability Level: release_candidate
         CONTAINER_CPU_TIME = 'container.cpu.time'
 
         # Container's CPU usage, measured in cpus. Range from 0 to the number of allocatable CPUs.

data/lib/opentelemetry/semconv/incubating/cpu/attributes.rb

@@ -31,7 +31,7 @@ module OpenTelemetry
 
         # The mode of the CPU
         #
-        # @note Stability Level: development
+        # @note Stability Level: release_candidate
         CPU_MODE = 'cpu.mode'
 
         # @!endgroup

data/lib/opentelemetry/semconv/incubating/file/attributes.rb

@@ -87,6 +87,21 @@ module OpenTelemetry
         # @note Stability Level: development
         FILE_INODE = 'file.inode'
 
+        # The lock mechanism such as noted by [POSIX](https://pubs.opengroup.org/onlinepubs/9699919799/functions/fcntl.html)
+        #
+        # @note Stability Level: development
+        FILE_LOCK_MECHANISM = 'file.lock.mechanism'
+
+        # Mode of lock or operation such as documented by [POSIX](https://pubs.opengroup.org/onlinepubs/9699919799/functions/fcntl.html)
+        #
+        # @note Stability Level: development
+        FILE_LOCK_MODE = 'file.lock.mode'
+
+        # The lock type as represented by i.e. [POSIX](https://pubs.opengroup.org/onlinepubs/9699919799/functions/fcntl.html)'s l_type.
+        #
+        # @note Stability Level: development
+        FILE_LOCK_TYPE = 'file.lock.type'
+
         # Mode of the file in octal representation.
         #
         # @note Stability Level: development

data/lib/opentelemetry/semconv/incubating/gcp/attributes.rb

@@ -144,6 +144,19 @@ module OpenTelemetry
         # @note Stability Level: development
         GCP_GCE_INSTANCE_HOSTNAME = 'gcp.gce.instance.hostname'
 
+        # Must be called with a key for the full attribute name. See notes below about the expectations
+        # for the state of the key.
+        #
+        # @example Usage
+        #   GCP_GCE_INSTANCE_LABELS_LAMBDA.call('some-cool-key') #=> 'gcp.gce.instance.labels.some-cool-key'
+        #
+        # GCE instance labels, `<key>` being the label name and the value being the label value.
+        #
+        # For example, a GCE instance label `team` with value `observability` SHOULD be recorded as the `gcp.gce.instance.labels.team` attribute with value `"observability"`. The `<key>` MUST be the exact GCE instance label key.
+        #
+        # @note Stability Level: development
+        GCP_GCE_INSTANCE_LABELS_LAMBDA = ->(key) { "gcp.gce.instance.labels.#{key}" }
+
         # The instance name of a GCE instance. This is the value provided by `host.name`, the visible name of the instance in the Cloud Console UI, and the prefix for the default hostname of the instance as defined by the [default internal DNS name](https://cloud.google.com/compute/docs/internal-dns#instance-fully-qualified-domain-names).
         #
         # @note Stability Level: development