opentelemetry-semantic_conventions 1.39.0 → 1.40.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e49a9dbae06f7fa323d27e16cba48f7df45460602acd8969ac0a3172506b76b3
-  data.tar.gz: 8134974d85744209fc52e303de680691d4d049b5e54dff4b9a743a8b89afddf3
+  metadata.gz: ffb65318e9077b70e39094e8e36a040324a86efc2867623ecca7dafc65a9dfa2
+  data.tar.gz: ed3108a7b4bda42719148657e18a5c9eb4d88546901f4bb54c7ed011cb1ec01f
 SHA512:
-  metadata.gz: f5c32ee66b18e56efbf598212ab1a0c5365a51ceda54bb6ad17bedae8fb8d75c6b8e82cb4ecd45f6a26cdf5d4d2c3b9830040f5efa9c6422a2fcc223b1db88a3
-  data.tar.gz: 46073d50823730d0b1c34c70a24982ea0de43692deb627a0da289c7b21ee0ff0067adbd7429fc52565728c30e0fe84886b8a93dd7f1684ce0cf71d196a566d4e
+  metadata.gz: 42a11f6d13e431ddf77031dc2feee263fb262992977775b95ec55b6983f9aa620f982fed217d5c53ba34d852e3a8aca96de76ebd22c66e5d37de8a6eec5868e0
+  data.tar.gz: 72f1d1a8d50aea38822821325f5c311a9ae1e9f1e92c2f79d7670bf7480534bcd60a8cb3052152331d3d3e3f780eabc536e9d4dc1bd1e484169b9123a7c1c21c

data/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Release History: opentelemetry-semantic_conventions
 
+### 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.40.0'
     # Release version of this gem. May not match SPEC_VERSION until gem is released after a spec update.
-    VERSION = '1.39.0'
+    VERSION = '1.40.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/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'
 

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/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: beta
         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: beta
         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: beta
         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: beta
         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/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/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.

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}.

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
@@ -282,6 +287,27 @@ module OpenTelemetry
         # @note Stability Level: development
         GEN_AI_RESPONSE_MODEL = 'gen_ai.response.model'
 
+        # 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
@@ -384,6 +410,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 +432,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'
 

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/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