opentelemetry-semantic_conventions 1.40.0 → 1.41.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ffb65318e9077b70e39094e8e36a040324a86efc2867623ecca7dafc65a9dfa2
-  data.tar.gz: ed3108a7b4bda42719148657e18a5c9eb4d88546901f4bb54c7ed011cb1ec01f
+  metadata.gz: 4c0338c46c79107495c86964d690d5f0db7b3cb222ed683ea4c81dd97040032b
+  data.tar.gz: a213a8550ea2b4aab219df00677c06f1f9f98f39a67c09ff82dab070a5013c09
 SHA512:
-  metadata.gz: 42a11f6d13e431ddf77031dc2feee263fb262992977775b95ec55b6983f9aa620f982fed217d5c53ba34d852e3a8aca96de76ebd22c66e5d37de8a6eec5868e0
-  data.tar.gz: 72f1d1a8d50aea38822821325f5c311a9ae1e9f1e92c2f79d7670bf7480534bcd60a8cb3052152331d3d3e3f780eabc536e9d4dc1bd1e484169b9123a7c1c21c
+  metadata.gz: 7ef135235380d18753a8fe2e12bd3967a85ad7502e7704644efe573e5966ca1399d91f5f157b0fa7811d06a11fe19551b5d52d55cfd0460c9dad624bc062b836
+  data.tar.gz: 96bf1f471baa38882224599fe57fcb61b5a1d9acac4af2458050ca6c92f855cf90e84dffd606ed4855825543bd7ed8d34308c548c6a39d832e1236b4b8a42f06

data/CHANGELOG.md

@@ -1,5 +1,9 @@
 # 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)

data/lib/opentelemetry/semantic_conventions/version.rb

@@ -7,8 +7,8 @@
 module OpenTelemetry
   module SemanticConventions
     # Version of the OpenTelemetry Semantic Conventions from which this library was generated.
-    SPEC_VERSION = '1.40.0'
+    SPEC_VERSION = '1.41.1'
     # Release version of this gem. May not match SPEC_VERSION until gem is released after a spec update.
-    VERSION = '1.40.0'
+    VERSION = '1.41.0'
   end
 end

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

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

data/lib/opentelemetry/semconv/deployment.rb

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

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

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

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

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

data/lib/opentelemetry/semconv/incubating/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: beta
+        # @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: beta
+        # @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: beta
+        # @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: beta
+        # @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/deployment/attributes.rb

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

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

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

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

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

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

@@ -257,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
@@ -287,6 +292,11 @@ 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).
@@ -374,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'
@@ -451,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/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'