opentelemetry-semantic_conventions 1.37.0 → 1.39.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ae5e00b9714aa7b343b498aa617582048e0713aa12ed975d0c4ef9350ce8532e
-  data.tar.gz: 5e8c4e48bda8d05d69652457fd07d11497d154acb603dbb876aa16b697108d7d
+  metadata.gz: e49a9dbae06f7fa323d27e16cba48f7df45460602acd8969ac0a3172506b76b3
+  data.tar.gz: 8134974d85744209fc52e303de680691d4d049b5e54dff4b9a743a8b89afddf3
 SHA512:
-  metadata.gz: cf7612172fe08e1fc05445a50d3abb8e3911946a2b1fc97098c787baa9b7e3e16bf08b5239d392c2eec45fc6af12931a590a5d4e98ba609d42fcfa050002855f
-  data.tar.gz: d399cbaaf4cad564fe862bc7e2fce0cf6dbfd9be628c4175b6e1cd336a4164b6a9ab08f164746975d411f762198c777a6e8162ff61361079ff6985a9423252d6
+  metadata.gz: f5c32ee66b18e56efbf598212ab1a0c5365a51ceda54bb6ad17bedae8fb8d75c6b8e82cb4ecd45f6a26cdf5d4d2c3b9830040f5efa9c6422a2fcc223b1db88a3
+  data.tar.gz: 46073d50823730d0b1c34c70a24982ea0de43692deb627a0da289c7b21ee0ff0067adbd7429fc52565728c30e0fe84886b8a93dd7f1684ce0cf71d196a566d4e

data/.yardopts

@@ -1,7 +1,6 @@
 --no-private
 --title=OpenTelemetry Semantic Conventions
 --markup=markdown
---markup-provider=kramdown
 --main=README.md
 ./lib/opentelemetry/**/*.rb
 -

data/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Release History: opentelemetry-semantic_conventions
 
+### v1.39.0 / 2026-06-03
+
+* ADDED: Update dependency open-telemetry/semantic-conventions to v1.39.0 (#2137)
+
+### v1.38.0 / 2026-05-21
+
+* ADDED: Update semantic conventions to v1.38.0 (#2136)
+
+### v1.37.1 / 2026-05-12
+
+* ADDED: Add git tag to source URI in gemspec (#2101)
+
 ### v1.37.0 / 2026-04-07
 
 * ADDED: Bump semantic conventions to version 1.37.0 (#1952)

data/README.md

@@ -38,6 +38,7 @@ The gem's versions match the corresponding
 [OpenTelemetry Semantic Convention versions][semconv].
 
 In version 1.36.0, we established a new pattern for naming the constants:
+
 * `OpenTelemetry::SemConv::Incubating::#{CATEGORY_NAME}` is the prefix for
 experimental, development, or deprecated constants
 * `OpenTelemetry::SemConv::#{CATEGORY_NAME}` is the prefix for stable constants
@@ -63,6 +64,7 @@ require 'opentelemetry/semconv/http'
 ```
 
 If you want to require all of the 1.11.0 constants, you can use:
+
 ```rb
 require 'opentelemetry/semantic_conventions'
 

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.37.0'
+    SPEC_VERSION = '1.39.0'
     # Release version of this gem. May not match SPEC_VERSION until gem is released after a spec update.
-    VERSION = '1.37.0'
+    VERSION = '1.39.0'
   end
 end

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

@@ -83,7 +83,7 @@ module OpenTelemetry
       # Summary may be available to the instrumentation through
       # instrumentation hooks or other means. If it is not available, instrumentations
       # that support query parsing SHOULD generate a summary following
-      # [Generating query summary](/docs/database/database-spans.md#generating-a-summary-of-the-query)
+      # [Generating query summary](/docs/db/database-spans.md#generating-a-summary-of-the-query)
       # section.
       #
       # @note Stability Level: stable
@@ -91,7 +91,7 @@ module OpenTelemetry
 
       # The database query being executed.
       #
-      # For sanitization see [Sanitization of `db.query.text`](/docs/database/database-spans.md#sanitization-of-dbquerytext).
+      # For sanitization see [Sanitization of `db.query.text`](/docs/db/database-spans.md#sanitization-of-dbquerytext).
       # For batch operations, if the individual operations are known to have the same query text then that query text SHOULD be used, otherwise all of the individual query texts SHOULD be concatenated with separator `; ` or some other database system specific separator if more applicable.
       # Parameterized query text SHOULD NOT be sanitized. Even though parameterized query text can potentially have sensitive data, by using a parameterized query the user is giving a strong signal that any sensitive data will be passed as parameter values, and the benefit to observability of capturing the static part of the query text by default outweighs the risk.
       #

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

@@ -39,7 +39,7 @@ module OpenTelemetry
       #
       # If the operation has completed successfully, instrumentations SHOULD NOT set `error.type`.
       #
-      # If a specific domain defines its own set of error identifiers (such as HTTP or gRPC status codes),
+      # If a specific domain defines its own set of error identifiers (such as HTTP or RPC status codes),
       # it's RECOMMENDED to:
       #
       # - Use a domain-specific attribute

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

@@ -54,8 +54,9 @@ module OpenTelemetry
       # HTTP request method.
       #
       # HTTP request method value SHOULD be "known" to the instrumentation.
-      # By default, this convention defines "known" methods as the ones listed in [RFC9110](https://www.rfc-editor.org/rfc/rfc9110.html#name-methods)
-      # and the PATCH method defined in [RFC5789](https://www.rfc-editor.org/rfc/rfc5789.html).
+      # By default, this convention defines "known" methods as the ones listed in [RFC9110](https://www.rfc-editor.org/rfc/rfc9110.html#name-methods),
+      # the PATCH method defined in [RFC5789](https://www.rfc-editor.org/rfc/rfc5789.html)
+      # and the QUERY method defined in [httpbis-safe-method-w-body](https://datatracker.ietf.org/doc/draft-ietf-httpbis-safe-method-w-body/?include_text=1).
       #
       # If the HTTP request method is not known to instrumentation, it MUST set the `http.request.method` attribute to `_OTHER`.
       #
@@ -115,11 +116,19 @@ module OpenTelemetry
       # @note Stability Level: stable
       HTTP_RESPONSE_STATUS_CODE = 'http.response.status_code'
 
-      # The matched route, that is, the path template in the format used by the respective server framework.
+      # The matched route template for the request. This MUST be low-cardinality and include all static path segments, with dynamic path segments represented with placeholders.
       #
       # MUST NOT be populated when this is not supported by the HTTP server framework as the route attribute should have low-cardinality and the URI path can NOT substitute it.
       # SHOULD include the [application root](/docs/http/http-spans.md#http-server-definitions) if there is one.
       #
+      # A static path segment is a part of the route template with a fixed, low-cardinality value. This includes literal strings like `/users/` and placeholders that
+      # are constrained to a finite, predefined set of values, e.g. `{controller}` or `{action}`.
+      #
+      # A dynamic path segment is a placeholder for a value that can have high cardinality and is not constrained to a predefined list like static path segments.
+      #
+      # Instrumentations SHOULD use routing information provided by the corresponding web framework. They SHOULD pick the most precise source of routing information and MAY
+      # support custom route formatting. Instrumentations SHOULD document the format and the API used to obtain the route string.
+      #
       # @note Stability Level: stable
       HTTP_ROUTE = 'http.route'
 

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

@@ -79,6 +79,20 @@ module OpenTelemetry
         # @note Stability Level: development
         APP_SCREEN_COORDINATE_Y = 'app.screen.coordinate.y'
 
+        # An identifier that uniquely differentiates this screen from other screens in the same application.
+        #
+        # A screen represents only the part of the device display drawn by the app. It typically contains multiple widgets or UI components and is larger in scope than individual widgets. Multiple screens can coexist on the same display simultaneously (e.g., split view on tablets).
+        #
+        # @note Stability Level: development
+        APP_SCREEN_ID = 'app.screen.id'
+
+        # The name of an application screen.
+        #
+        # A screen represents only the part of the device display drawn by the app. It typically contains multiple widgets or UI components and is larger in scope than individual widgets. Multiple screens can coexist on the same display simultaneously (e.g., split view on tablets).
+        #
+        # @note Stability Level: development
+        APP_SCREEN_NAME = 'app.screen.name'
+
         # An identifier that uniquely differentiates this widget from other widgets in the same application.
         #
         # A widget is an application component, typically an on-screen visual GUI element.

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 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.
+        # 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.
         #
         # @note Stability Level: development
         AWS_LAMBDA_RESOURCE_MAPPING_ID = 'aws.lambda.resource_mapping.id'

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

@@ -41,7 +41,7 @@ module OpenTelemetry
 
         # List of regions contacted during operation in the order that they were contacted. If there is more than one region listed, it indicates that the operation was performed on multiple regions i.e. cross-regional call.
         #
-        # Region name matches the format of `displayName` in [Azure Location API](https://learn.microsoft.com/rest/api/subscription/subscriptions/list-locations?view=rest-subscription-2021-10-01&tabs=HTTP#location)
+        # Region name matches the format of `displayName` in [Azure Location API](https://learn.microsoft.com/rest/api/resources/subscriptions/list-locations)
         #
         # @note Stability Level: development
         AZURE_COSMOSDB_OPERATION_CONTACTED_REGIONS = 'azure.cosmosdb.operation.contacted_regions'

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

@@ -63,12 +63,12 @@ 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: development
+        # @note Stability Level: alpha
         CONTAINER_ID = 'container.id'
 
         # Runtime specific image identifier. Usually a hash algorithm followed by a UUID.
         #
-        # Docker defines a sha256 of the image id; `container.image.id` corresponds to the `Image` field from the Docker container inspect [API](https://docs.docker.com/engine/api/v1.43/#tag/Container/operation/ContainerInspect) endpoint.
+        # Docker defines a sha256 of the image id; `container.image.id` corresponds to the `Image` field from the Docker container inspect [API](https://docs.docker.com/reference/api/engine/version/v1.52/#tag/Container/operation/ContainerInspect) endpoint.
         # K8s defines a link to the container registry repository with digest `"imageID": "registry.azurecr.io /namespace/service/dockerfile@sha256:bdeabd40c3a8a492eaf9e8e44d0ebbb84bac7ee25ac0cf8a7159d25f62555625"`.
         # The ID is assigned by the container runtime and can vary in different environments. Consider using `oci.manifest.digest` if it is important to identify the same image in different environments/runtimes.
         #
@@ -77,19 +77,19 @@ module OpenTelemetry
 
         # Name of the image the container was built on.
         #
-        # @note Stability Level: development
+        # @note Stability Level: alpha
         CONTAINER_IMAGE_NAME = 'container.image.name'
 
         # Repo digests of the container image as provided by the container runtime.
         #
-        # [Docker](https://docs.docker.com/engine/api/v1.43/#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.
+        # [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: development
+        # @note Stability Level: alpha
         CONTAINER_IMAGE_REPO_DIGESTS = 'container.image.repo_digests'
 
-        # Container image tags. An example can be found in [Docker Image Inspect](https://docs.docker.com/engine/api/v1.43/#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>`.
+        # 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: development
+        # @note Stability Level: alpha
         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

@@ -77,6 +77,31 @@ module OpenTelemetry
         # @note Stability Level: development
         CONTAINER_FILESYSTEM_USAGE = 'container.filesystem.usage'
 
+        # Container memory available.
+        #
+        # Available memory for use.  This is defined as the memory limit - workingSetBytes. If memory limit is undefined, the available bytes is omitted.
+        # In general, this metric can be derived from [cadvisor](https://github.com/google/cadvisor/blob/v0.53.0/docs/storage/prometheus.md#prometheus-container-metrics) and by subtracting the `container_memory_working_set_bytes` metric from the `container_spec_memory_limit_bytes` metric.
+        # In K8s, this metric is derived from the [MemoryStats.AvailableBytes](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#MemoryStats) field of the [PodStats.Memory](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#PodStats) of the Kubelet's stats API.
+        #
+        # @note Stability Level: development
+        CONTAINER_MEMORY_AVAILABLE = 'container.memory.available'
+
+        # Container memory paging faults.
+        #
+        # In general, this metric can be derived from [cadvisor](https://github.com/google/cadvisor/blob/v0.53.0/docs/storage/prometheus.md#prometheus-container-metrics) and specifically the `container_memory_failures_total{failure_type=pgfault, scope=container}` and `container_memory_failures_total{failure_type=pgmajfault, scope=container}`metric.
+        # In K8s, this metric is derived from the [MemoryStats.PageFaults](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#MemoryStats) and [MemoryStats.MajorPageFaults](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#MemoryStats) field of the [PodStats.Memory](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#PodStats) of the Kubelet's stats API.
+        #
+        # @note Stability Level: development
+        CONTAINER_MEMORY_PAGING_FAULTS = 'container.memory.paging.faults'
+
+        # Container memory RSS.
+        #
+        # In general, this metric can be derived from [cadvisor](https://github.com/google/cadvisor/blob/v0.53.0/docs/storage/prometheus.md#prometheus-container-metrics) and specifically the `container_memory_rss` metric.
+        # In K8s, this metric is derived from the [MemoryStats.RSSBytes](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#MemoryStats) field of the [PodStats.Memory](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#PodStats) of the Kubelet's stats API.
+        #
+        # @note Stability Level: development
+        CONTAINER_MEMORY_RSS = 'container.memory.rss'
+
         # Memory usage of the container.
         #
         # Memory usage of the container.
@@ -84,6 +109,14 @@ module OpenTelemetry
         # @note Stability Level: development
         CONTAINER_MEMORY_USAGE = 'container.memory.usage'
 
+        # Container memory working set.
+        #
+        # In general, this metric can be derived from [cadvisor](https://github.com/google/cadvisor/blob/v0.53.0/docs/storage/prometheus.md#prometheus-container-metrics) and specifically the `container_memory_working_set_bytes` metric.
+        # In K8s, this metric is derived from the [MemoryStats.WorkingSetBytes](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#MemoryStats) field of the [PodStats.Memory](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#PodStats) of the Kubelet's stats API.
+        #
+        # @note Stability Level: development
+        CONTAINER_MEMORY_WORKING_SET = 'container.memory.working_set'
+
         # Network bytes for the container.
         #
         # The number of bytes sent/received on all network interfaces by the container.

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

@@ -162,7 +162,7 @@ module OpenTelemetry
         # Deprecated, use `db.response.status_code` instead.
         #
         # @note Stability Level: development
-        # @deprecated Replaced by `db.response.status_code`.
+        # @deprecated Use `db.response.status_code` instead.
         DB_COSMOSDB_STATUS_CODE = 'db.cosmosdb.status_code'
 
         # Deprecated, use `azure.cosmosdb.response.sub_status_code` instead.
@@ -304,14 +304,17 @@ module OpenTelemetry
         # `db.query.parameter.<key>` SHOULD match
         # up with the parameterized placeholders present in `db.query.text`.
         #
+        # It is RECOMMENDED to capture the value as provided by the application
+        # without attempting to do any case normalization.
+        #
         # `db.query.parameter.<key>` SHOULD NOT be captured on batch operations.
         #
         # Examples:
         #
         # - For a query `SELECT * FROM users where username =  %s` with the parameter `"jdoe"`,
         #   the attribute `db.query.parameter.0` SHOULD be set to `"jdoe"`.
-        # - For a query `"SELECT * FROM users WHERE username = %(username)s;` with parameter
-        #   `username = "jdoe"`, the attribute `db.query.parameter.username` SHOULD be set to `"jdoe"`.
+        # - For a query `"SELECT * FROM users WHERE username = %(userName)s;` with parameter
+        #   `userName = "jdoe"`, the attribute `db.query.parameter.userName` SHOULD be set to `"jdoe"`.
         #
         # @note Stability Level: development
         DB_QUERY_PARAMETER_LAMBDA = ->(key) { "db.query.parameter.#{key}" }
@@ -325,7 +328,7 @@ module OpenTelemetry
         # Summary may be available to the instrumentation through
         # instrumentation hooks or other means. If it is not available, instrumentations
         # that support query parsing SHOULD generate a summary following
-        # [Generating query summary](/docs/database/database-spans.md#generating-a-summary-of-the-query)
+        # [Generating query summary](/docs/db/database-spans.md#generating-a-summary-of-the-query)
         # section.
         #
         # @note Stability Level: stable
@@ -335,7 +338,7 @@ module OpenTelemetry
 
         # The database query being executed.
         #
-        # For sanitization see [Sanitization of `db.query.text`](/docs/database/database-spans.md#sanitization-of-dbquerytext).
+        # For sanitization see [Sanitization of `db.query.text`](/docs/db/database-spans.md#sanitization-of-dbquerytext).
         # For batch operations, if the individual operations are known to have the same query text then that query text SHOULD be used, otherwise all of the individual query texts SHOULD be concatenated with separator `; ` or some other database system specific separator if more applicable.
         # Parameterized query text SHOULD NOT be sanitized. Even though parameterized query text can potentially have sensitive data, by using a parameterized query the user is giving a strong signal that any sensitive data will be passed as parameter values, and the benefit to observability of capturing the static part of the query text by default outweighs the risk.
         #
@@ -347,7 +350,7 @@ module OpenTelemetry
         # Deprecated, use `db.namespace` instead.
         #
         # @note Stability Level: development
-        # @deprecated Replaced by `db.namespace`.
+        # @deprecated Uncategorized.
         DB_REDIS_DATABASE_INDEX = 'db.redis.database_index'
 
         # Number of rows returned by the operation.

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

@@ -31,7 +31,7 @@ module OpenTelemetry
 
         # The name being queried.
         #
-        # If the name field contains non-printable characters (below 32 or above 126), those characters should be represented as escaped base 10 integers (\DDD). Back slashes and quotes should be escaped. Tabs, carriage returns, and line feeds should be converted to \t, \r, and \n respectively.
+        # The name represents the queried domain name as it appears in the DNS query without any additional normalization.
         #
         # @note Stability Level: development
         DNS_QUESTION_NAME = 'dns.question.name'

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

@@ -47,7 +47,7 @@ module OpenTelemetry
         # Deprecated, use `user.roles` instead.
         #
         # @note Stability Level: development
-        # @deprecated Replaced by `user.roles`.
+        # @deprecated Use `user.roles` instead.
         ENDUSER_ROLE = 'enduser.role'
 
         # Deprecated, no replacement at this time.

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

@@ -51,7 +51,7 @@ module OpenTelemetry
         #
         # If the operation has completed successfully, instrumentations SHOULD NOT set `error.type`.
         #
-        # If a specific domain defines its own set of error identifiers (such as HTTP or gRPC status codes),
+        # If a specific domain defines its own set of error identifiers (such as HTTP or RPC status codes),
         # it's RECOMMENDED to:
         #
         # - Use a domain-specific attribute

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

@@ -27,7 +27,7 @@ module OpenTelemetry
         # Identifies the class / type of event.
         #
         # @note Stability Level: development
-        # @deprecated Replaced by EventName top-level field on the LogRecord.
+        # @deprecated The value of this attribute MUST now be set as the value of the EventName field on the LogRecord to indicate that the LogRecord represents an Event.
         EVENT_NAME = 'event.name'
 
         # @!endgroup

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

@@ -135,7 +135,7 @@ module OpenTelemetry
         # - **Google Cloud Run (Services):** The [revision](https://cloud.google.com/run/docs/managing/revisions)
         #   (i.e., the function name plus the revision suffix).
         # - **Google Cloud Functions:** The value of the
-        #   [`K_REVISION` environment variable](https://cloud.google.com/functions/docs/env-var#runtime_environment_variables_set_automatically).
+        #   [`K_REVISION` environment variable](https://cloud.google.com/run/docs/container-contract#services-env-vars).
         # - **Azure Functions:** Not applicable. Do not set this attribute.
         #
         # @note Stability Level: development

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

@@ -77,6 +77,51 @@ module OpenTelemetry
         # @note Stability Level: development
         GCP_APPHUB_WORKLOAD_ID = 'gcp.apphub.workload.id'
 
+        # The container within GCP where the AppHub destination application is defined.
+        #
+        # @note Stability Level: development
+        GCP_APPHUB_DESTINATION_APPLICATION_CONTAINER = 'gcp.apphub_destination.application.container'
+
+        # The name of the destination application as configured in AppHub.
+        #
+        # @note Stability Level: development
+        GCP_APPHUB_DESTINATION_APPLICATION_ID = 'gcp.apphub_destination.application.id'
+
+        # The GCP zone or region where the destination application is defined.
+        #
+        # @note Stability Level: development
+        GCP_APPHUB_DESTINATION_APPLICATION_LOCATION = 'gcp.apphub_destination.application.location'
+
+        # Criticality of a destination workload indicates its importance to the business as specified in [AppHub type enum](https://cloud.google.com/app-hub/docs/reference/rest/v1/Attributes#type)
+        #
+        # @note Stability Level: development
+        GCP_APPHUB_DESTINATION_SERVICE_CRITICALITY_TYPE = 'gcp.apphub_destination.service.criticality_type'
+
+        # Software lifecycle stage of a destination service as defined [AppHub environment type](https://cloud.google.com/app-hub/docs/reference/rest/v1/Attributes#type_1)
+        #
+        # @note Stability Level: development
+        GCP_APPHUB_DESTINATION_SERVICE_ENVIRONMENT_TYPE = 'gcp.apphub_destination.service.environment_type'
+
+        # The name of the destination service as configured in AppHub.
+        #
+        # @note Stability Level: development
+        GCP_APPHUB_DESTINATION_SERVICE_ID = 'gcp.apphub_destination.service.id'
+
+        # Criticality of a destination workload indicates its importance to the business as specified in [AppHub type enum](https://cloud.google.com/app-hub/docs/reference/rest/v1/Attributes#type)
+        #
+        # @note Stability Level: development
+        GCP_APPHUB_DESTINATION_WORKLOAD_CRITICALITY_TYPE = 'gcp.apphub_destination.workload.criticality_type'
+
+        # Environment of a destination workload is the stage of a software lifecycle as provided in the [AppHub environment type](https://cloud.google.com/app-hub/docs/reference/rest/v1/Attributes#type_1)
+        #
+        # @note Stability Level: development
+        GCP_APPHUB_DESTINATION_WORKLOAD_ENVIRONMENT_TYPE = 'gcp.apphub_destination.workload.environment_type'
+
+        # The name of the destination workload as configured in AppHub.
+        #
+        # @note Stability Level: development
+        GCP_APPHUB_DESTINATION_WORKLOAD_ID = 'gcp.apphub_destination.workload.id'
+
         # Identifies the Google Cloud service for which the official client library is intended.
         #
         # Intended to be a stable identifier for Google Cloud client libraries that is uniform across implementation languages. The value should be derived from the canonical service domain for the service; for example, 'foo.googleapis.com' should result in a value of 'foo'.

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

@@ -57,6 +57,33 @@ module OpenTelemetry
         # @note Stability Level: development
         GEN_AI_DATA_SOURCE_ID = 'gen_ai.data_source.id'
 
+        # The number of dimensions the resulting output embeddings should have.
+        #
+        # @note Stability Level: development
+        GEN_AI_EMBEDDINGS_DIMENSION_COUNT = 'gen_ai.embeddings.dimension.count'
+
+        # A free-form explanation for the assigned score provided by the evaluator.
+        #
+        # @note Stability Level: development
+        GEN_AI_EVALUATION_EXPLANATION = 'gen_ai.evaluation.explanation'
+
+        # The name of the evaluation metric used for the GenAI response.
+        #
+        # @note Stability Level: development
+        GEN_AI_EVALUATION_NAME = 'gen_ai.evaluation.name'
+
+        # Human readable label for evaluation.
+        #
+        # This attribute provides a human-readable interpretation of the evaluation score produced by an evaluator. For example, a score value of 1 could mean "relevant" in one evaluation system and "not relevant" in another, depending on the scoring range and evaluator. The label SHOULD have low cardinality. Possible values depend on the evaluation metric and evaluator used; implementations SHOULD document the possible values.
+        #
+        # @note Stability Level: development
+        GEN_AI_EVALUATION_SCORE_LABEL = 'gen_ai.evaluation.score.label'
+
+        # The evaluation score returned by the evaluator.
+        #
+        # @note Stability Level: development
+        GEN_AI_EVALUATION_SCORE_VALUE = 'gen_ai.evaluation.score.value'
+
         # The chat history provided to the model as an input.
         #
         # Instrumentations MUST follow [Input messages JSON schema](/docs/gen-ai/gen-ai-input-messages.json).
@@ -154,6 +181,11 @@ module OpenTelemetry
         # @deprecated Removed, no replacement at this time.
         GEN_AI_PROMPT = 'gen_ai.prompt'
 
+        # The name of the prompt that uniquely identifies it.
+        #
+        # @note Stability Level: development
+        GEN_AI_PROMPT_NAME = 'gen_ai.prompt.name'
+
         # The Generative AI provider as identified by the client or server instrumentation.
         #
         # The attribute SHOULD be set based on the instrumentation's best
@@ -287,11 +319,50 @@ module OpenTelemetry
         # @note Stability Level: development
         GEN_AI_TOKEN_TYPE = 'gen_ai.token.type'
 
+        # Parameters passed to the tool call.
+        #
+        # > [!WARNING]
+        # > This attribute may contain sensitive information.
+        #
+        # It's expected to be an object - in case a serialized string is available
+        # to the instrumentation, the instrumentation SHOULD do the best effort to
+        # deserialize it to an object. When recorded on spans, it MAY be recorded as a JSON string if structured format is not supported and SHOULD be recorded in structured form otherwise.
+        #
+        # @note Stability Level: development
+        GEN_AI_TOOL_CALL_ARGUMENTS = 'gen_ai.tool.call.arguments'
+
         # The tool call identifier.
         #
         # @note Stability Level: development
         GEN_AI_TOOL_CALL_ID = 'gen_ai.tool.call.id'
 
+        # The result returned by the tool call (if any and if execution was successful).
+        #
+        # > [!WARNING]
+        # > This attribute may contain sensitive information.
+        #
+        # It's expected to be an object - in case a serialized string is available
+        # to the instrumentation, the instrumentation SHOULD do the best effort to
+        # deserialize it to an object. When recorded on spans, it MAY be recorded as a JSON string if structured format is not supported and SHOULD be recorded in structured form otherwise.
+        #
+        # @note Stability Level: development
+        GEN_AI_TOOL_CALL_RESULT = 'gen_ai.tool.call.result'
+
+        # The list of source system tool definitions available to the GenAI agent or model.
+        #
+        # The value of this attribute matches source system tool definition format.
+        #
+        # It's expected to be an array of objects where each object represents a tool definition. In case a serialized string is available
+        # to the instrumentation, the instrumentation SHOULD do the best effort to
+        # deserialize it to an array. When recorded on spans, it MAY be recorded as a JSON string if structured format is not supported and SHOULD be recorded in structured form otherwise.
+        #
+        # Since this attribute could be large, it's NOT RECOMMENDED to populate
+        # it by default. Instrumentations MAY provide a way to enable
+        # populating this attribute.
+        #
+        # @note Stability Level: development
+        GEN_AI_TOOL_DEFINITIONS = 'gen_ai.tool.definitions'
+
         # The tool description.
         #
         # @note Stability Level: development

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

@@ -35,10 +35,10 @@ module OpenTelemetry
         # @note Stability Level: development
         HTTP_CONNECTION_STATE = 'http.connection.state'
 
-        # Deprecated, use `network.protocol.name` instead.
+        # Deprecated, use `network.protocol.name` and `network.protocol.version` instead.
         #
         # @note Stability Level: development
-        # @deprecated Replaced by `network.protocol.name`.
+        # @deprecated Split into `network.protocol.name` and `network.protocol.version`
         HTTP_FLAVOR = 'http.flavor'
 
         # Deprecated, use one of `server.address`, `client.address` or `http.request.header.host` instead, depending on the usage.
@@ -91,8 +91,9 @@ module OpenTelemetry
         # HTTP request method.
         #
         # HTTP request method value SHOULD be "known" to the instrumentation.
-        # By default, this convention defines "known" methods as the ones listed in [RFC9110](https://www.rfc-editor.org/rfc/rfc9110.html#name-methods)
-        # and the PATCH method defined in [RFC5789](https://www.rfc-editor.org/rfc/rfc5789.html).
+        # By default, this convention defines "known" methods as the ones listed in [RFC9110](https://www.rfc-editor.org/rfc/rfc9110.html#name-methods),
+        # the PATCH method defined in [RFC5789](https://www.rfc-editor.org/rfc/rfc5789.html)
+        # and the QUERY method defined in [httpbis-safe-method-w-body](https://datatracker.ietf.org/doc/draft-ietf-httpbis-safe-method-w-body/?include_text=1).
         #
         # If the HTTP request method is not known to instrumentation, it MUST set the `http.request.method` attribute to `_OTHER`.
         #
@@ -201,11 +202,19 @@ module OpenTelemetry
         # @deprecated Replaced by `http.response.body.size`.
         HTTP_RESPONSE_CONTENT_LENGTH_UNCOMPRESSED = 'http.response_content_length_uncompressed'
 
-        # The matched route, that is, the path template in the format used by the respective server framework.
+        # The matched route template for the request. This MUST be low-cardinality and include all static path segments, with dynamic path segments represented with placeholders.
         #
         # MUST NOT be populated when this is not supported by the HTTP server framework as the route attribute should have low-cardinality and the URI path can NOT substitute it.
         # SHOULD include the [application root](/docs/http/http-spans.md#http-server-definitions) if there is one.
         #
+        # A static path segment is a part of the route template with a fixed, low-cardinality value. This includes literal strings like `/users/` and placeholders that
+        # are constrained to a finite, predefined set of values, e.g. `{controller}` or `{action}`.
+        #
+        # A dynamic path segment is a placeholder for a value that can have high cardinality and is not constrained to a predefined list like static path segments.
+        #
+        # Instrumentations SHOULD use routing information provided by the corresponding web framework. They SHOULD pick the most precise source of routing information and MAY
+        # support custom route formatting. Instrumentations SHOULD document the format and the API used to obtain the route string.
+        #
         # @note Stability Level: stable
         #
         # @deprecated Now available in the stable namespace at {OpenTelemetry::SemConv::HTTP::HTTP_ROUTE}.

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

@@ -0,0 +1,44 @@
+# 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 Incubating
+      module JSONRPC
+        # @!group Attribute Names
+
+        # Protocol version, as specified in the `jsonrpc` property of the request and its corresponding response.
+        #
+        # @note Stability Level: development
+        JSONRPC_PROTOCOL_VERSION = 'jsonrpc.protocol.version'
+
+        # A string representation of the `id` property of the request and its corresponding response.
+        #
+        # Under the [JSON-RPC specification](https://www.jsonrpc.org/specification), the `id` property may be a string, number, null, or omitted entirely. When omitted, the request is treated as a notification. Using `null` is not equivalent to omitting the `id`, but it is discouraged.
+        # Instrumentations SHOULD NOT capture this attribute when the `id` is `null` or omitted.
+        #
+        # @note Stability Level: development
+        JSONRPC_REQUEST_ID = 'jsonrpc.request.id'
+
+        # @!endgroup
+      end
+    end
+  end
+end