opentelemetry-semantic_conventions 1.40.0 → 1.42.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ffb65318e9077b70e39094e8e36a040324a86efc2867623ecca7dafc65a9dfa2
-  data.tar.gz: ed3108a7b4bda42719148657e18a5c9eb4d88546901f4bb54c7ed011cb1ec01f
+  metadata.gz: dc7a3272858c8f6b81b0bf6fe79daaf2dbe86ea9998cdf8d9de9931ae39f8a78
+  data.tar.gz: 55c64947141573ee3c72b2e563c98aab71d84bf86a50076513da34ab552cf299
 SHA512:
-  metadata.gz: 42a11f6d13e431ddf77031dc2feee263fb262992977775b95ec55b6983f9aa620f982fed217d5c53ba34d852e3a8aca96de76ebd22c66e5d37de8a6eec5868e0
-  data.tar.gz: 72f1d1a8d50aea38822821325f5c311a9ae1e9f1e92c2f79d7670bf7480534bcd60a8cb3052152331d3d3e3f780eabc536e9d4dc1bd1e484169b9123a7c1c21c
+  metadata.gz: 581dc30386c954d919f3cb0ea205b2230f11e78035b92e68b6e79ebea143aa791aeab0f8c16f15730f92140f4f17e45b6189620839c0813f6022ae9c1d14eabc
+  data.tar.gz: ad1f871f3bfae12f3ab40f86ba999c8e759d1e16304c68353c52ab8da6abca50c58f9c46ecfb38189fc8128210309651a45133124906e65a0e32f1466717823a

data/CHANGELOG.md

@@ -1,5 +1,14 @@
 # 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)
+
 ### v1.40.0 / 2026-06-09
 
 * ADDED: Update dependency open-telemetry/semantic-conventions to v1.40.0 (#2173)

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.40.0'
+    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.40.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/deployment/attributes.rb

@@ -0,0 +1,42 @@
+# 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 DEPLOYMENT
+      # @!group Attribute Names
+
+      # Name of the [deployment environment](https://wikipedia.org/wiki/Deployment_environment) (aka deployment tier).
+      #
+      # `deployment.environment.name` does not affect the uniqueness constraints defined through
+      # the `service.namespace`, `service.name` and `service.instance.id` resource attributes.
+      # This implies that resources carrying the following attribute combinations MUST be
+      # considered to be identifying the same service:
+      #
+      # - `service.name=frontend`, `deployment.environment.name=production`
+      # - `service.name=frontend`, `deployment.environment.name=staging`.
+      #
+      # @note Stability Level: stable
+      DEPLOYMENT_ENVIRONMENT_NAME = 'deployment.environment.name'
+
+      # @!endgroup
+    end
+  end
+end

data/lib/opentelemetry/semconv/deployment.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 'deployment/attributes'

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

@@ -30,6 +30,12 @@ module OpenTelemetry
       # When `error.type` is set to a type (e.g., an exception type), its
       # canonical class name identifying the type within the artifact SHOULD be used.
       #
+      # If the recorded error type is a wrapper that is not meaningful for
+      # failure classification, instrumentation MAY use the type of the inner
+      # error instead. For example, in Go, errors created with `fmt.Errorf`
+      # using `%w` MAY be unwrapped when the wrapper type does not help
+      # classify the failure.
+      #
       # Instrumentations SHOULD document the list of errors they report.
       #
       # The cardinality of `error.type` within one instrumentation library SHOULD be low.

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

@@ -43,6 +43,12 @@ module OpenTelemetry
 
       # The type of the exception (its fully-qualified class name, if applicable). The dynamic type of the exception should be preferred over the static type in languages that support it.
       #
+      # If the recorded exception type is a wrapper that is not meaningful for
+      # failure classification, instrumentation MAY use the type of the inner
+      # exception instead. For example, in Go, errors created with `fmt.Errorf`
+      # using `%w` MAY be unwrapped when the wrapper type does not help
+      # classify the failure.
+      #
       # @note Stability Level: stable
       EXCEPTION_TYPE = 'exception.type'
 

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/aws/attributes.rb

@@ -201,7 +201,7 @@ module OpenTelemetry
         # @note Stability Level: development
         AWS_LAMBDA_INVOKED_ARN = 'aws.lambda.invoked_arn'
 
-        # The UUID of the [AWS Lambda EvenSource Mapping](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html). An event source is mapped to a lambda function. It's contents are read by Lambda and used to trigger a function. This isn't available in the lambda execution context or the lambda runtime environtment. This is going to be populated by the AWS SDK for each language when that UUID is present. Some of these operations are Create/Delete/Get/List/Update EventSourceMapping.
+        # The UUID of the [AWS Lambda EvenSource Mapping](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html). An event source is mapped to a lambda function. It's contents are read by Lambda and used to trigger a function. This isn't available in the lambda execution context or the lambda runtime environment. This is going to be populated by the AWS SDK for each language when that UUID is present. Some of these operations are Create/Delete/Get/List/Update EventSourceMapping.
         #
         # @note Stability Level: development
         AWS_LAMBDA_RESOURCE_MAPPING_ID = 'aws.lambda.resource_mapping.id'
@@ -313,7 +313,7 @@ module OpenTelemetry
         # @note Stability Level: development
         AWS_S3_UPLOAD_ID = 'aws.s3.upload_id'
 
-        # The ARN of the Secret stored in the Secrets Mangger
+        # The ARN of the Secret stored in the Secrets Manager
         #
         # @note Stability Level: development
         AWS_SECRETSMANAGER_SECRET_ARN = 'aws.secretsmanager.secret.arn'

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

@@ -61,6 +61,8 @@ module OpenTelemetry
 
         # The unique identifier of a task run within a pipeline.
         #
+        # For a given pipeline run and task, the `cicd.pipeline.task.run.id` MUST be unique within that run. For the same task across different runs of the same pipeline, the `cicd.pipeline.task.run.id` MAY remain the same, enabling correlation of `cicd.pipeline.task.run.result` values across multiple pipeline runs.
+        #
         # @note Stability Level: development
         CICD_PIPELINE_TASK_RUN_ID = 'cicd.pipeline.task.run.id'
 
@@ -79,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: beta
+        # @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: beta
+        # @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: beta
+        # @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: beta
+        # @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
@@ -128,7 +136,7 @@ module OpenTelemetry
         # @deprecated Replaced by `container.runtime.name`.
         CONTAINER_RUNTIME = 'container.runtime'
 
-        # A description about the runtime which could include, for example details about the CRI/API version being used or other customisations.
+        # A description about the runtime which could include, for example details about the CRI/API version being used or other customizations.
         #
         # @note Stability Level: development
         CONTAINER_RUNTIME_DESCRIPTION = 'container.runtime.description'

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/deployment/attributes.rb

@@ -40,7 +40,9 @@ module OpenTelemetry
         # - `service.name=frontend`, `deployment.environment.name=production`
         # - `service.name=frontend`, `deployment.environment.name=staging`.
         #
-        # @note Stability Level: development
+        # @note Stability Level: stable
+        #
+        # @deprecated Now available in the stable namespace at {OpenTelemetry::SemConv::DEPLOYMENT::DEPLOYMENT_ENVIRONMENT_NAME}.
         DEPLOYMENT_ENVIRONMENT_NAME = 'deployment.environment.name'
 
         # The id of the deployment.

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

@@ -43,6 +43,12 @@ module OpenTelemetry
         # When `error.type` is set to a type (e.g., an exception type), its
         # canonical class name identifying the type within the artifact SHOULD be used.
         #
+        # If the recorded error type is a wrapper that is not meaningful for
+        # failure classification, instrumentation MAY use the type of the inner
+        # error instead. For example, in Go, errors created with `fmt.Errorf`
+        # using `%w` MAY be unwrapped when the wrapper type does not help
+        # classify the failure.
+        #
         # Instrumentations SHOULD document the list of errors they report.
         #
         # The cardinality of `error.type` within one instrumentation library SHOULD be low.

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

@@ -48,6 +48,12 @@ module OpenTelemetry
 
         # The type of the exception (its fully-qualified class name, if applicable). The dynamic type of the exception should be preferred over the static type in languages that support it.
         #
+        # If the recorded exception type is a wrapper that is not meaningful for
+        # failure classification, instrumentation MAY use the type of the inner
+        # exception instead. For example, in Go, errors created with `fmt.Errorf`
+        # using `%w` MAY be unwrapped when the wrapper type does not help
+        # classify the failure.
+        #
         # @note Stability Level: stable
         #
         # @deprecated Now available in the stable namespace at {OpenTelemetry::SemConv::EXCEPTION::EXCEPTION_TYPE}.

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