opentelemetry-semantic_conventions 1.39.0 → 1.41.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e49a9dbae06f7fa323d27e16cba48f7df45460602acd8969ac0a3172506b76b3
-  data.tar.gz: 8134974d85744209fc52e303de680691d4d049b5e54dff4b9a743a8b89afddf3
+  metadata.gz: 4c0338c46c79107495c86964d690d5f0db7b3cb222ed683ea4c81dd97040032b
+  data.tar.gz: a213a8550ea2b4aab219df00677c06f1f9f98f39a67c09ff82dab070a5013c09
 SHA512:
-  metadata.gz: f5c32ee66b18e56efbf598212ab1a0c5365a51ceda54bb6ad17bedae8fb8d75c6b8e82cb4ecd45f6a26cdf5d4d2c3b9830040f5efa9c6422a2fcc223b1db88a3
-  data.tar.gz: 46073d50823730d0b1c34c70a24982ea0de43692deb627a0da289c7b21ee0ff0067adbd7429fc52565728c30e0fe84886b8a93dd7f1684ce0cf71d196a566d4e
+  metadata.gz: 7ef135235380d18753a8fe2e12bd3967a85ad7502e7704644efe573e5966ca1399d91f5f157b0fa7811d06a11fe19551b5d52d55cfd0460c9dad624bc062b836
+  data.tar.gz: 96bf1f471baa38882224599fe57fcb61b5a1d9acac4af2458050ca6c92f855cf90e84dffd606ed4855825543bd7ed8d34308c548c6a39d832e1236b4b8a42f06

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Release History: opentelemetry-semantic_conventions
 
+### v1.41.0 / 2026-06-10
+
+* ADDED: Update dependency open-telemetry/semantic-conventions to v1.41.1 (#2184)
+
+### v1.40.0 / 2026-06-09
+
+* ADDED: Update dependency open-telemetry/semantic-conventions to v1.40.0 (#2173)
+
 ### v1.39.0 / 2026-06-03
 
 * ADDED: Update dependency open-telemetry/semantic-conventions to v1.39.0 (#2137)

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

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

@@ -86,6 +86,11 @@ module OpenTelemetry
       # [Generating query summary](/docs/db/database-spans.md#generating-a-summary-of-the-query)
       # section.
       #
+      # For batch operations, if the individual operations are known to have the same query summary
+      # then that query summary SHOULD be used prepended by `BATCH `,
+      # otherwise `db.query.summary` SHOULD be `BATCH` or some other database
+      # system specific term if more applicable.
+      #
       # @note Stability Level: stable
       DB_QUERY_SUMMARY = 'db.query.summary'
 

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

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+# Copyright The OpenTelemetry Authors
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+# SPDX-License-Identifier: Apache-2.0
+#
+# This file was autogenerated. Do not edit it by hand.
+
+module OpenTelemetry
+  module SemConv
+    module DEPLOYMENT
+      # @!group Attribute Names
+
+      # Name of the [deployment environment](https://wikipedia.org/wiki/Deployment_environment) (aka deployment tier).
+      #
+      # `deployment.environment.name` does not affect the uniqueness constraints defined through
+      # the `service.namespace`, `service.name` and `service.instance.id` resource attributes.
+      # This implies that resources carrying the following attribute combinations MUST be
+      # considered to be identifying the same service:
+      #
+      # - `service.name=frontend`, `deployment.environment.name=production`
+      # - `service.name=frontend`, `deployment.environment.name=staging`.
+      #
+      # @note Stability Level: stable
+      DEPLOYMENT_ENVIRONMENT_NAME = 'deployment.environment.name'
+
+      # @!endgroup
+    end
+  end
+end

data/lib/opentelemetry/semconv/deployment.rb

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

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

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

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

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

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

@@ -62,8 +62,15 @@ module OpenTelemetry
       #
       # If the HTTP instrumentation could end up converting valid HTTP request methods to `_OTHER`, then it MUST provide a way to override
       # the list of known HTTP methods. If this override is done via environment variable, then the environment variable MUST be named
-      # OTEL_INSTRUMENTATION_HTTP_KNOWN_METHODS and support a comma-separated list of case-sensitive known HTTP methods
-      # (this list MUST be a full override of the default known method, it is not a list of known methods in addition to the defaults).
+      # OTEL_INSTRUMENTATION_HTTP_KNOWN_METHODS and support a comma-separated list of case-sensitive known HTTP methods.
+      #
+      #
+      # If this override is done via declarative configuration, then the list MUST be configurable via the `known_methods` property
+      # (an array of case-sensitive strings with minimum items 0) under `.instrumentation/development.general.http.client` and/or
+      # `.instrumentation/development.general.http.server`.
+      #
+      # In either case, this list MUST be a full override of the default known methods,
+      # it is not a list of known methods in addition to the defaults.
       #
       # HTTP method names are case-sensitive and `http.request.method` attribute value MUST match a known HTTP method name exactly.
       # Instrumentations for specific web frameworks that consider HTTP methods to be case insensitive, SHOULD populate a canonical equivalent.

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

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

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

@@ -61,6 +61,8 @@ module OpenTelemetry
 
         # The unique identifier of a task run within a pipeline.
         #
+        # For a given pipeline run and task, the `cicd.pipeline.task.run.id` MUST be unique within that run. For the same task across different runs of the same pipeline, the `cicd.pipeline.task.run.id` MAY remain the same, enabling correlation of `cicd.pipeline.task.run.result` values across multiple pipeline runs.
+        #
         # @note Stability Level: development
         CICD_PIPELINE_TASK_RUN_ID = 'cicd.pipeline.task.run.id'
 

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

@@ -63,7 +63,7 @@ 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: alpha
+        # @note Stability Level: release_candidate
         CONTAINER_ID = 'container.id'
 
         # Runtime specific image identifier. Usually a hash algorithm followed by a UUID.
@@ -77,19 +77,19 @@ module OpenTelemetry
 
         # Name of the image the container was built on.
         #
-        # @note Stability Level: alpha
+        # @note Stability Level: release_candidate
         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: alpha
+        # @note Stability Level: release_candidate
         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: alpha
+        # @note Stability Level: release_candidate
         CONTAINER_IMAGE_TAGS = 'container.image.tags'
 
         # Must be called with a key for the full attribute name. See notes below about the expectations
@@ -128,7 +128,7 @@ module OpenTelemetry
         # @deprecated Replaced by `container.runtime.name`.
         CONTAINER_RUNTIME = 'container.runtime'
 
-        # A description about the runtime which could include, for example details about the CRI/API version being used or other customisations.
+        # A description about the runtime which could include, for example details about the CRI/API version being used or other customizations.
         #
         # @note Stability Level: development
         CONTAINER_RUNTIME_DESCRIPTION = 'container.runtime.description'

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

@@ -331,6 +331,11 @@ module OpenTelemetry
         # [Generating query summary](/docs/db/database-spans.md#generating-a-summary-of-the-query)
         # section.
         #
+        # For batch operations, if the individual operations are known to have the same query summary
+        # then that query summary SHOULD be used prepended by `BATCH `,
+        # otherwise `db.query.summary` SHOULD be `BATCH` or some other database
+        # system specific term if more applicable.
+        #
         # @note Stability Level: stable
         #
         # @deprecated Now available in the stable namespace at {OpenTelemetry::SemConv::DB::DB_QUERY_SUMMARY}.

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

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

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

@@ -33,6 +33,7 @@ module OpenTelemetry
         # `error.message` is NOT RECOMMENDED for metrics or spans due to its unbounded cardinality and overlap with span status.
         #
         # @note Stability Level: development
+        # @deprecated Use domain-specific error message attribute. For example, use `feature_flag.error.message` for feature flag errors.
         ERROR_MESSAGE = 'error.message'
 
         # Describes a class of error the operation ended with.
@@ -42,6 +43,12 @@ module OpenTelemetry
         # When `error.type` is set to a type (e.g., an exception type), its
         # canonical class name identifying the type within the artifact SHOULD be used.
         #
+        # If the recorded error type is a wrapper that is not meaningful for
+        # failure classification, instrumentation MAY use the type of the inner
+        # error instead. For example, in Go, errors created with `fmt.Errorf`
+        # using `%w` MAY be unwrapped when the wrapper type does not help
+        # classify the failure.
+        #
         # Instrumentations SHOULD document the list of errors they report.
         #
         # The cardinality of `error.type` within one instrumentation library SHOULD be low.

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

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

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

@@ -29,10 +29,15 @@ module OpenTelemetry
         # @note Stability Level: release_candidate
         FEATURE_FLAG_CONTEXT_ID = 'feature_flag.context.id'
 
-        # Deprecated, use `error.message` instead.
+        # A message providing more detail about an error that occurred during feature flag evaluation in human-readable form.
+        #
+        # @note Stability Level: release_candidate
+        FEATURE_FLAG_ERROR_MESSAGE = 'feature_flag.error.message'
+
+        # Deprecated, use `feature_flag.error.message` instead.
         #
         # @note Stability Level: development
-        # @deprecated Replaced by `error.message`.
+        # @deprecated Replaced by `feature_flag.error.message`.
         FEATURE_FLAG_EVALUATION_ERROR_MESSAGE = 'feature_flag.evaluation.error.message'
 
         # Deprecated, use `feature_flag.result.reason` instead.

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

@@ -149,6 +149,21 @@ module OpenTelemetry
         # @note Stability Level: development
         GCP_GCE_INSTANCE_NAME = 'gcp.gce.instance.name'
 
+        # The name of the Instance Group Manager (IGM) that manages this VM, if any.
+        #
+        # @note Stability Level: development
+        GCP_GCE_INSTANCE_GROUP_MANAGER_NAME = 'gcp.gce.instance_group_manager.name'
+
+        # The region of a **regional** Instance Group Manager (e.g., `us-central1`). Set this **only** when the IGM is regional.
+        #
+        # @note Stability Level: development
+        GCP_GCE_INSTANCE_GROUP_MANAGER_REGION = 'gcp.gce.instance_group_manager.region'
+
+        # The zone of a **zonal** Instance Group Manager (e.g., `us-central1-a`). Set this **only** when the IGM is zonal.
+        #
+        # @note Stability Level: development
+        GCP_GCE_INSTANCE_GROUP_MANAGER_ZONE = 'gcp.gce.instance_group_manager.zone'
+
         # @!endgroup
       end
     end

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

@@ -39,6 +39,11 @@ module OpenTelemetry
         # @note Stability Level: development
         GEN_AI_AGENT_NAME = 'gen_ai.agent.name'
 
+        # The version of the GenAI agent.
+        #
+        # @note Stability Level: development
+        GEN_AI_AGENT_VERSION = 'gen_ai.agent.version'
+
         # Deprecated, use Event API to report completions contents.
         #
         # @note Stability Level: development
@@ -252,6 +257,11 @@ module OpenTelemetry
         # @note Stability Level: development
         GEN_AI_REQUEST_STOP_SEQUENCES = 'gen_ai.request.stop_sequences'
 
+        # Indicates whether the GenAI request was made in streaming mode.
+        #
+        # @note Stability Level: development
+        GEN_AI_REQUEST_STREAM = 'gen_ai.request.stream'
+
         # The temperature setting for the GenAI request.
         #
         # @note Stability Level: development
@@ -282,6 +292,32 @@ module OpenTelemetry
         # @note Stability Level: development
         GEN_AI_RESPONSE_MODEL = 'gen_ai.response.model'
 
+        # Time to first chunk in a streaming response, measured from request issuance, in seconds. The value is measured from when the client issues the generation request to when the first chunk is received in the response stream.
+        #
+        # @note Stability Level: development
+        GEN_AI_RESPONSE_TIME_TO_FIRST_CHUNK = 'gen_ai.response.time_to_first_chunk'
+
+        # The documents retrieved.
+        #
+        # Instrumentations MUST follow [Retrieval documents JSON schema](/docs/gen-ai/gen-ai-retrieval-documents.json).
+        # When the attribute is recorded on events, it MUST be recorded in structured
+        # form. 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.
+        #
+        # Each document object SHOULD contain at least the following properties:
+        # `id` (string): A unique identifier for the document, `score` (double): The relevance score of the document
+        #
+        # @note Stability Level: development
+        GEN_AI_RETRIEVAL_DOCUMENTS = 'gen_ai.retrieval.documents'
+
+        # The query text used for retrieval.
+        #
+        # > [!Warning]
+        # > This attribute may contain sensitive information.
+        #
+        # @note Stability Level: development
+        GEN_AI_RETRIEVAL_QUERY_TEXT = 'gen_ai.retrieval.query.text'
+
         # Deprecated, use `gen_ai.provider.name` instead.
         #
         # @note Stability Level: development
@@ -348,17 +384,17 @@ module OpenTelemetry
         # @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 list of tool definitions available to the GenAI agent or model.
         #
-        # The value of this attribute matches source system tool definition format.
+        # Instrumentations MUST follow [Tool Definitions JSON Schema](/docs/gen-ai/gen-ai-tool-definitions.json).
         #
-        # 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.
+        # When the attribute is recorded on events, it MUST be recorded in structured
+        # form. 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.
+        # non-required properties by default. Instrumentations MAY provide a way
+        # to enable populating optional properties.
         #
         # @note Stability Level: development
         GEN_AI_TOOL_DEFINITIONS = 'gen_ai.tool.definitions'
@@ -384,6 +420,20 @@ module OpenTelemetry
         # @note Stability Level: development
         GEN_AI_TOOL_TYPE = 'gen_ai.tool.type'
 
+        # The number of input tokens written to a provider-managed cache.
+        #
+        # The value SHOULD be included in `gen_ai.usage.input_tokens`.
+        #
+        # @note Stability Level: development
+        GEN_AI_USAGE_CACHE_CREATION_INPUT_TOKENS = 'gen_ai.usage.cache_creation.input_tokens'
+
+        # The number of input tokens served from a provider-managed cache.
+        #
+        # The value SHOULD be included in `gen_ai.usage.input_tokens`.
+        #
+        # @note Stability Level: development
+        GEN_AI_USAGE_CACHE_READ_INPUT_TOKENS = 'gen_ai.usage.cache_read.input_tokens'
+
         # Deprecated, use `gen_ai.usage.output_tokens` instead.
         #
         # @note Stability Level: development
@@ -392,6 +442,11 @@ module OpenTelemetry
 
         # The number of tokens used in the GenAI input (prompt).
         #
+        # This value SHOULD include all types of input tokens, including cached tokens.
+        # Instrumentations SHOULD make a best effort to populate this value, using a total
+        # provided by the provider when available or, depending on the provider API,
+        # by summing different token types parsed from the provider output.
+        #
         # @note Stability Level: development
         GEN_AI_USAGE_INPUT_TOKENS = 'gen_ai.usage.input_tokens'
 
@@ -406,6 +461,20 @@ module OpenTelemetry
         # @deprecated Replaced by `gen_ai.usage.input_tokens`.
         GEN_AI_USAGE_PROMPT_TOKENS = 'gen_ai.usage.prompt_tokens'
 
+        # The number of output tokens used for reasoning (e.g. chain-of-thought, extended thinking).
+        #
+        # The value SHOULD be included in `gen_ai.usage.output_tokens`.
+        #
+        # @note Stability Level: development
+        GEN_AI_USAGE_REASONING_OUTPUT_TOKENS = 'gen_ai.usage.reasoning.output_tokens'
+
+        # Human-readable name of the GenAI workflow provided by the application.
+        #
+        # This attribute can be populated in different frameworks eg: name of the first chain in LangChain OR name of the crew in CrewAI.
+        #
+        # @note Stability Level: development
+        GEN_AI_WORKFLOW_NAME = 'gen_ai.workflow.name'
+
         # @!endgroup
       end
     end

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

@@ -29,6 +29,20 @@ module OpenTelemetry
         # @note Stability Level: development
         GEN_AI_CLIENT_OPERATION_DURATION = 'gen_ai.client.operation.duration'
 
+        # Time per output chunk, recorded for each chunk received after the first one, measured as the time elapsed from the end of the previous chunk to the end of the current chunk.
+        #
+        # This metrics SHOULD be reported for streaming calls and SHOULD NOT be reported otherwise.
+        #
+        # @note Stability Level: development
+        GEN_AI_CLIENT_OPERATION_TIME_PER_OUTPUT_CHUNK = 'gen_ai.client.operation.time_per_output_chunk'
+
+        # Time to receive the first chunk, measured from when the client issues the generation request to when the first chunk is received in the response stream.
+        #
+        # This metrics SHOULD be reported for streaming calls and SHOULD NOT be reported otherwise.
+        #
+        # @note Stability Level: development
+        GEN_AI_CLIENT_OPERATION_TIME_TO_FIRST_CHUNK = 'gen_ai.client.operation.time_to_first_chunk'
+
         # Number of input and output tokens used.
         #
         # @note Stability Level: development

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

@@ -24,6 +24,25 @@ module OpenTelemetry
       module GO
         # @!group Attribute Names
 
+        # The detailed state of the CPU.
+        #
+        # Value SHOULD match the specific CPU class reported by the Go runtime under `/cpu/classes/...`. The list of possible values is subject to change with the Go version used.
+        #
+        # @note Stability Level: development
+        GO_CPU_DETAILED_STATE = 'go.cpu.detailed_state'
+
+        # The state of the CPU.
+        #
+        # @note Stability Level: development
+        GO_CPU_STATE = 'go.cpu.state'
+
+        # The detailed type of memory.
+        #
+        # Value SHOULD match the specific memory class reported by the Go runtime under `/memory/classes/...`. The list of possible values is subject to change with the Go version used.
+        #
+        # @note Stability Level: development
+        GO_MEMORY_DETAILED_TYPE = 'go.memory.detailed_type'
+
         # The type of memory.
         #
         # @note Stability Level: development

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

@@ -31,6 +31,13 @@ module OpenTelemetry
         # @note Stability Level: development
         GO_CONFIG_GOGC = 'go.config.gogc'
 
+        # Estimated CPU time spent by the Go runtime.
+        #
+        # Computed from `/cpu/classes/...` metrics. This metric is an overestimate, and not directly comparable to system CPU time measurements. Compare only with other `go.cpu.time` metrics.
+        #
+        # @note Stability Level: development
+        GO_CPU_TIME = 'go.cpu.time'
+
         # Count of live goroutines.
         #
         # Computed from `/sched/goroutines:goroutines`.
@@ -52,6 +59,13 @@ module OpenTelemetry
         # @note Stability Level: development
         GO_MEMORY_ALLOCATIONS = 'go.memory.allocations'
 
+        # Number of completed GC cycles.
+        #
+        # Computed from `/gc/cycles/total:gc-cycles`.
+        #
+        # @note Stability Level: development
+        GO_MEMORY_GC_CYCLES = 'go.memory.gc.cycles'
+
         # Heap size target for the end of the GC cycle.
         #
         # Computed from `/gc/heap/goal:bytes`.
@@ -59,6 +73,13 @@ module OpenTelemetry
         # @note Stability Level: development
         GO_MEMORY_GC_GOAL = 'go.memory.gc.goal'
 
+        # Distribution of individual GC-related stop-the-world pause latencies. This is the time from deciding to stop the world until the world is started again.
+        #
+        # Computed from `/sched/pauses/total/gc:seconds`. Bucket boundaries are provided by the runtime, and are subject to change.
+        #
+        # @note Stability Level: development
+        GO_MEMORY_GC_PAUSE_DURATION = 'go.memory.gc.pause.duration'
+
         # Go runtime memory limit configured by the user, if a limit exists.
         #
         # Computed from `/gc/gomemlimit:bytes`. This metric is excluded if the limit obtained from the Go runtime is math.MaxInt64.

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

@@ -26,7 +26,7 @@ module OpenTelemetry
 
         # The GraphQL document being executed.
         #
-        # The value may be sanitized to exclude sensitive information.
+        # If instrumentation can reliably identify and redact sensitive information it SHOULD do it.
         #
         # @note Stability Level: development
         GRAPHQL_DOCUMENT = 'graphql.document'

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

@@ -99,8 +99,15 @@ module OpenTelemetry
         #
         # If the HTTP instrumentation could end up converting valid HTTP request methods to `_OTHER`, then it MUST provide a way to override
         # the list of known HTTP methods. If this override is done via environment variable, then the environment variable MUST be named
-        # OTEL_INSTRUMENTATION_HTTP_KNOWN_METHODS and support a comma-separated list of case-sensitive known HTTP methods
-        # (this list MUST be a full override of the default known method, it is not a list of known methods in addition to the defaults).
+        # OTEL_INSTRUMENTATION_HTTP_KNOWN_METHODS and support a comma-separated list of case-sensitive known HTTP methods.
+        #
+        #
+        # If this override is done via declarative configuration, then the list MUST be configurable via the `known_methods` property
+        # (an array of case-sensitive strings with minimum items 0) under `.instrumentation/development.general.http.client` and/or
+        # `.instrumentation/development.general.http.server`.
+        #
+        # In either case, this list MUST be a full override of the default known methods,
+        # it is not a list of known methods in addition to the defaults.
         #
         # HTTP method names are case-sensitive and `http.request.method` attribute value MUST match a known HTTP method name exactly.
         # Instrumentations for specific web frameworks that consider HTTP methods to be case insensitive, SHOULD populate a canonical equivalent.

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

@@ -24,7 +24,7 @@ module OpenTelemetry
       module HW
         # @!group Attribute Names
 
-        # Design capacity in Watts-hours or Amper-hours
+        # Design capacity in Watts-hours or Ampere-hours
         #
         # @note Stability Level: development
         HW_BATTERY_CAPACITY = 'hw.battery.capacity'

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

@@ -94,6 +94,11 @@ module OpenTelemetry
         # @note Stability Level: development
         JVM_FILE_DESCRIPTOR_COUNT = 'jvm.file_descriptor.count'
 
+        # Measure of max open file descriptors as reported by the JVM.
+        #
+        # @note Stability Level: development
+        JVM_FILE_DESCRIPTOR_LIMIT = 'jvm.file_descriptor.limit'
+
         # Duration of JVM garbage collection actions.
         #
         # @note Stability Level: stable