opentelemetry-semantic_conventions 1.41.0 → 1.43.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4c0338c46c79107495c86964d690d5f0db7b3cb222ed683ea4c81dd97040032b
-  data.tar.gz: a213a8550ea2b4aab219df00677c06f1f9f98f39a67c09ff82dab070a5013c09
+  metadata.gz: c87619f45a9752cbd827768b88976c4636aba6abb0376efc480113bc4664ef73
+  data.tar.gz: b62d6d3745214c370d0316b2c95b0a0b35510dd53cb375d4ce15dcc07b7c5f6a
 SHA512:
-  metadata.gz: 7ef135235380d18753a8fe2e12bd3967a85ad7502e7704644efe573e5966ca1399d91f5f157b0fa7811d06a11fe19551b5d52d55cfd0460c9dad624bc062b836
-  data.tar.gz: 96bf1f471baa38882224599fe57fcb61b5a1d9acac4af2458050ca6c92f855cf90e84dffd606ed4855825543bd7ed8d34308c548c6a39d832e1236b4b8a42f06
+  metadata.gz: 3a2e44a598a565d9cedac1a31cfec2d5d8c5e9ba6c43b22e8cf34c7c94472ac516cee0f5bd56a58bd94cc8529d5c41ab5d73d3da3b8c36d01c7ba5da73dee6a9
+  data.tar.gz: 9b537d4df0f26facf57fa5e411660287f6e81c8627fd9d046fd7a6edb66055d6c3f8ce512ed21d872c630b01c264949bfd50d336853483cebb349e3e095ace82

data/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Release History: opentelemetry-semantic_conventions
 
+### v1.43.0 / 2026-07-08
+
+* ADDED: Update dependency open-telemetry/semantic-conventions to v1.43.0 (#2218)
+
+### 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.43.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.43.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/db/attributes.rb

@@ -47,9 +47,30 @@ module OpenTelemetry
       # @note Stability Level: stable
       DB_NAMESPACE = 'db.namespace'
 
-      # The number of queries included in a batch operation.
+      # The number of database operations included in a batch operation.
       #
-      # Operations are only considered batches when they contain two or more operations, and so `db.operation.batch.size` SHOULD never be `1`.
+      # Except for empty batch requests described below, a batch operation contains two
+      # or more database operations explicitly submitted as separate operations in a single
+      # client call, protocol message, or database command.
+      #
+      # Requests to batch APIs that contain only one operation SHOULD be modeled as single
+      # operations, not as batch operations.
+      #
+      # A database call is not a batch operation solely because one operation accepts
+      # multiple operands, such as keys, rows, documents, points, or other data elements,
+      # including Redis [`MGET`](https://redis.io/docs/latest/commands/mget/) with
+      # multiple keys.
+      #
+      # In batch APIs that execute the same parameterized operation with parameter sets,
+      # each parameter set represents one database operation for determining whether the
+      # request is a batch operation. Requests with only one parameter set SHOULD be modeled
+      # as single operations, not as batch operations.
+      #
+      # `db.operation.batch.size` SHOULD be set to the number of operations in the batch.
+      # It SHOULD NOT be set for non-batch operations.
+      #
+      # A request to execute a batch operation with no operations SHOULD also be treated
+      # as a batch operation, and `db.operation.batch.size` SHOULD be set to `0`.
       #
       # @note Stability Level: stable
       DB_OPERATION_BATCH_SIZE = 'db.operation.batch.size'

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

@@ -61,6 +61,11 @@ module OpenTelemetry
         # @note Stability Level: development
         AZURE_COSMOSDB_RESPONSE_SUB_STATUS_CODE = 'azure.cosmosdb.response.sub_status_code'
 
+        # The name of the Azure [resource group](https://learn.microsoft.com/azure/azure-resource-manager/management/manage-resource-groups-portal) the resource belongs to.
+        #
+        # @note Stability Level: development
+        AZURE_RESOURCE_GROUP_NAME = 'azure.resource_group.name'
+
         # [Azure Resource Provider Namespace](https://learn.microsoft.com/azure/azure-resource-manager/management/azure-services-resource-providers) as recognized by the client.
         #
         # @note Stability Level: development

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

@@ -26,84 +26,84 @@ module OpenTelemetry
 
         # The kind of action a pipeline run is performing.
         #
-        # @note Stability Level: development
+        # @note Stability Level: release_candidate
         CICD_PIPELINE_ACTION_NAME = 'cicd.pipeline.action.name'
 
         # The human readable name of the pipeline within a CI/CD system.
         #
-        # @note Stability Level: development
+        # @note Stability Level: release_candidate
         CICD_PIPELINE_NAME = 'cicd.pipeline.name'
 
         # The result of a pipeline run.
         #
-        # @note Stability Level: development
+        # @note Stability Level: release_candidate
         CICD_PIPELINE_RESULT = 'cicd.pipeline.result'
 
         # The unique identifier of a pipeline run within a CI/CD system.
         #
-        # @note Stability Level: development
+        # @note Stability Level: release_candidate
         CICD_PIPELINE_RUN_ID = 'cicd.pipeline.run.id'
 
         # The pipeline run goes through these states during its lifecycle.
         #
-        # @note Stability Level: development
+        # @note Stability Level: release_candidate
         CICD_PIPELINE_RUN_STATE = 'cicd.pipeline.run.state'
 
         # The [URL](https://wikipedia.org/wiki/URL) of the pipeline run, providing the complete address in order to locate and identify the pipeline run.
         #
-        # @note Stability Level: development
+        # @note Stability Level: release_candidate
         CICD_PIPELINE_RUN_URL_FULL = 'cicd.pipeline.run.url.full'
 
         # The human readable name of a task within a pipeline. Task here most closely aligns with a [computing process](https://wikipedia.org/wiki/Pipeline_(computing)) in a pipeline. Other terms for tasks include commands, steps, and procedures.
         #
-        # @note Stability Level: development
+        # @note Stability Level: release_candidate
         CICD_PIPELINE_TASK_NAME = 'cicd.pipeline.task.name'
 
         # 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
+        # @note Stability Level: release_candidate
         CICD_PIPELINE_TASK_RUN_ID = 'cicd.pipeline.task.run.id'
 
         # The result of a task run.
         #
-        # @note Stability Level: development
+        # @note Stability Level: release_candidate
         CICD_PIPELINE_TASK_RUN_RESULT = 'cicd.pipeline.task.run.result'
 
         # The [URL](https://wikipedia.org/wiki/URL) of the pipeline task run, providing the complete address in order to locate and identify the pipeline task run.
         #
-        # @note Stability Level: development
+        # @note Stability Level: release_candidate
         CICD_PIPELINE_TASK_RUN_URL_FULL = 'cicd.pipeline.task.run.url.full'
 
         # The type of the task within a pipeline.
         #
-        # @note Stability Level: development
+        # @note Stability Level: release_candidate
         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
+        # @note Stability Level: release_candidate
         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
+        # @note Stability Level: release_candidate
         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
+        # @note Stability Level: release_candidate
         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
+        # @note Stability Level: release_candidate
         CICD_WORKER_STATE = 'cicd.worker.state'
 
         # The [URL](https://wikipedia.org/wiki/URL) of the worker, providing the complete address in order to locate and identify the worker.
         #
-        # @note Stability Level: development
+        # @note Stability Level: release_candidate
         CICD_WORKER_URL_FULL = 'cicd.worker.url.full'
 
         # @!endgroup

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

@@ -26,12 +26,12 @@ module OpenTelemetry
 
         # The number of pipeline runs currently active in the system by state.
         #
-        # @note Stability Level: development
+        # @note Stability Level: release_candidate
         CICD_PIPELINE_RUN_ACTIVE = 'cicd.pipeline.run.active'
 
         # Duration of a pipeline run grouped by pipeline, state and result.
         #
-        # @note Stability Level: development
+        # @note Stability Level: release_candidate
         CICD_PIPELINE_RUN_DURATION = 'cicd.pipeline.run.duration'
 
         # The number of errors encountered in pipeline runs (eg. compile, test failures).
@@ -39,19 +39,19 @@ module OpenTelemetry
         # There might be errors in a pipeline run that are non fatal (eg. they are suppressed) or in a parallel stage multiple stages could have a fatal error.
         # This means that this error count might not be the same as the count of metric `cicd.pipeline.run.duration` with run result `failure`.
         #
-        # @note Stability Level: development
+        # @note Stability Level: release_candidate
         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
+        # @note Stability Level: release_candidate
         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
+        # @note Stability Level: release_candidate
         CICD_WORKER_COUNT = 'cicd.worker.count'
 
         # @!endgroup

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

@@ -26,6 +26,8 @@ module OpenTelemetry
 
         # The cloud account ID the resource is assigned to.
         #
+        # For Azure, this is the subscription ID.
+        #
         # @note Stability Level: development
         CLOUD_ACCOUNT_ID = 'cloud.account.id'
 

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

@@ -242,9 +242,30 @@ module OpenTelemetry
         # @deprecated Replaced by `db.operation.name`.
         DB_OPERATION = 'db.operation'
 
-        # The number of queries included in a batch operation.
+        # The number of database operations included in a batch operation.
         #
-        # Operations are only considered batches when they contain two or more operations, and so `db.operation.batch.size` SHOULD never be `1`.
+        # Except for empty batch requests described below, a batch operation contains two
+        # or more database operations explicitly submitted as separate operations in a single
+        # client call, protocol message, or database command.
+        #
+        # Requests to batch APIs that contain only one operation SHOULD be modeled as single
+        # operations, not as batch operations.
+        #
+        # A database call is not a batch operation solely because one operation accepts
+        # multiple operands, such as keys, rows, documents, points, or other data elements,
+        # including Redis [`MGET`](https://redis.io/docs/latest/commands/mget/) with
+        # multiple keys.
+        #
+        # In batch APIs that execute the same parameterized operation with parameter sets,
+        # each parameter set represents one database operation for determining whether the
+        # request is a batch operation. Requests with only one parameter set SHOULD be modeled
+        # as single operations, not as batch operations.
+        #
+        # `db.operation.batch.size` SHOULD be set to the number of operations in the batch.
+        # It SHOULD NOT be set for non-batch operations.
+        #
+        # A request to execute a batch operation with no operations SHOULD also be treated
+        # as a batch operation, and `db.operation.batch.size` SHOULD be set to `0`.
         #
         # @note Stability Level: stable
         #

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

@@ -26,7 +26,7 @@ module OpenTelemetry
 
         # The disk IO operation direction.
         #
-        # @note Stability Level: development
+        # @note Stability Level: release_candidate
         DISK_IO_DIRECTION = 'disk.io.direction'
 
         # @!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