opentelemetry-semantic_conventions 1.37.1 → 1.38.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 266fdf2702c166bf304d39da3add16b30935c97c0645386ab508abd5d210d787
-  data.tar.gz: 5120eadf8c2749f70e15299a4ee5668fc92efd4e330934f45346e8a603e17a7a
+  metadata.gz: 7f2fada6bbb37ecc40d58611b0d01eef0b300b58e48188c17612eade244b4a17
+  data.tar.gz: e5ad6b628fb2d0ba8c82c8b8bbba9e47e6f39dc886fd72b363275a1d237c5bcf
 SHA512:
-  metadata.gz: b04705a2d24ff643c8df644e1bc009ddc0f05e258d2c8ec16430c71b87ab1689d4dc6b7a58768672ab16ab270219f9a4e56654a31384a81574e0f0fba36124aa
-  data.tar.gz: 7cd6d2c314df1bd86a9a0e63f88747d98b946aa753e8ca6f35fe718f49c31010adeb078b5c71464a4db9da21446133aff8503f861cfdba85bd4fd198dd865c3c
+  metadata.gz: 6c4ef25f9bea68b4555d1e471f3fc3011d0145d3946b5394a6c8f30dfc8f9ff47afff1a5bb1d983d6a99a3e6ed341b131841dba4bb127959bd7b83d99878ab2a
+  data.tar.gz: 19868afdd8e0d8838100446b83006801267d4b552586886c1bd24e0b06c867e164dd977bc7b967285ed2df61475c9db7d4f7d806a50f4312c1207e68486ffc97

data/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Release History: opentelemetry-semantic_conventions
 
+### 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)

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

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

@@ -68,7 +68,7 @@ module OpenTelemetry
 
         # 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.43/#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.
         #
@@ -82,12 +82,12 @@ module OpenTelemetry
 
         # 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.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.
         #
         # @note Stability Level: development
         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.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>`.
         #
         # @note Stability Level: development
         CONTAINER_IMAGE_TAGS = 'container.image.tags'

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}" }
@@ -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/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).
@@ -287,11 +314,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/k8s/attributes.rb

@@ -484,6 +484,16 @@ module OpenTelemetry
         # @note Stability Level: development
         K8S_POD_NAME = 'k8s.pod.name'
 
+        # The phase for the pod. Corresponds to the `phase` field of the: [K8s PodStatus](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.33/#podstatus-v1-core)
+        #
+        # @note Stability Level: development
+        K8S_POD_STATUS_PHASE = 'k8s.pod.status.phase'
+
+        # The reason for the pod state. Corresponds to the `reason` field of the: [K8s PodStatus](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.33/#podstatus-v1-core)
+        #
+        # @note Stability Level: development
+        K8S_POD_STATUS_REASON = 'k8s.pod.status.reason'
+
         # The UID of the Pod.
         #
         # @note Stability Level: development
@@ -552,7 +562,7 @@ module OpenTelemetry
 
         # The name of the K8s resource a resource quota defines.
         #
-        # The value for this attribute can be either the full `count/<resource>[.<group>]` string (e.g., count/deployments.apps, count/pods), or, for certain core Kubernetes resources, just the resource name (e.g., pods, services, configmaps). Both forms are supported by Kubernetes for object count quotas. See [Kubernetes Resource Quotas documentation](https://kubernetes.io/docs/concepts/policy/resource-quotas/#object-count-quota) for more details.
+        # The value for this attribute can be either the full `count/<resource>[.<group>]` string (e.g., count/deployments.apps, count/pods), or, for certain core Kubernetes resources, just the resource name (e.g., pods, services, configmaps). Both forms are supported by Kubernetes for object count quotas. See [Kubernetes Resource Quotas documentation](https://kubernetes.io/docs/concepts/policy/resource-quotas/#quota-on-object-count) for more details.
         #
         # @note Stability Level: development
         K8S_RESOURCEQUOTA_RESOURCE_NAME = 'k8s.resourcequota.resource_name'