opentelemetry-semantic_conventions 1.42.0 → 1.44.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: dc7a3272858c8f6b81b0bf6fe79daaf2dbe86ea9998cdf8d9de9931ae39f8a78
-  data.tar.gz: 55c64947141573ee3c72b2e563c98aab71d84bf86a50076513da34ab552cf299
+  metadata.gz: 83a4fe1eefc8216b24d3c38fc0a6705987c5829681456ae0d84457f0f0d20e63
+  data.tar.gz: '0398ac350966985307a2987f9a5de63542b132afb7409ca013c2faf36a14f4d8'
 SHA512:
-  metadata.gz: 581dc30386c954d919f3cb0ea205b2230f11e78035b92e68b6e79ebea143aa791aeab0f8c16f15730f92140f4f17e45b6189620839c0813f6022ae9c1d14eabc
-  data.tar.gz: ad1f871f3bfae12f3ab40f86ba999c8e759d1e16304c68353c52ab8da6abca50c58f9c46ecfb38189fc8128210309651a45133124906e65a0e32f1466717823a
+  metadata.gz: 97fcd773f881a7489754145cebb68531a0ad94443e532127d0332d1ea08adea0a820ed3bd9965917734c9eedb1e5587f4ee2a3421214754aca2b6539838b5592
+  data.tar.gz: a9b7ef0a6a9bee697f0b13cd5658d8970742f26052dab4326e47d10a48785c51e7953a3cd01526b7f9d4966a7712a8ab01ba97425680558cdebda5242f7fc511

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Release History: opentelemetry-semantic_conventions
 
+### v1.44.0 / 2026-08-07
+
+* ADDED: Update dependency open-telemetry/semantic-conventions to v1.44.0 (#2279)
+
+### v1.43.0 / 2026-07-08
+
+* ADDED: Update dependency open-telemetry/semantic-conventions to v1.43.0 (#2218)
+
 ### v1.42.0 / 2026-07-07
 
 * ADDED: Autoload namespaces so a single require exposes all constants (#2204)

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

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

@@ -23,7 +23,7 @@ module OpenTelemetry
     module CLIENT
       # @!group Attribute Names
 
-      # Client address - domain name if available without reverse DNS lookup; otherwise, IP address or Unix domain socket name.
+      # Client address - domain name if available without reverse DNS lookup; otherwise, IP address or UNIX domain socket name.
       #
       # When observed from the server side, and when communicating through an intermediary, `client.address` SHOULD represent the client address behind any intermediaries,  for example proxies, if it's available.
       #

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

@@ -28,7 +28,7 @@ module OpenTelemetry
       # @note Stability Level: stable
       CODE_COLUMN_NUMBER = 'code.column.number'
 
-      # The source code file name that identifies the code unit as uniquely as possible (preferably an absolute file path). This attribute MUST NOT be used on the Profile signal since the data is already captured in 'message Function'. This constraint is imposed to prevent redundancy and maintain data integrity.
+      # The source code filename that identifies the code unit as uniquely as possible (preferably an absolute file path). This attribute MUST NOT be used on the Profile signal since the data is already captured in 'message Function'. This constraint is imposed to prevent redundancy and maintain data integrity.
       #
       # @note Stability Level: stable
       CODE_FILE_PATH = 'code.file.path'

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

@@ -33,7 +33,7 @@ module OpenTelemetry
       # @note Stability Level: stable
       CONTAINER_IMAGE_NAME = 'container.image.name'
 
-      # Repo digests of the container image as provided by the container runtime.
+      # Repository 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.
       #

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

@@ -47,9 +47,30 @@ module OpenTelemetry
       # @note Stability Level: stable
       DB_NAMESPACE = 'db.namespace'
 
-      # The number of queries included in a batch operation.
+      # The number of database operations included in a batch operation.
       #
-      # Operations are only considered batches when they contain two or more operations, and so `db.operation.batch.size` SHOULD never be `1`.
+      # Except for empty batch requests described below, a batch operation contains two
+      # or more database operations explicitly submitted as separate operations in a single
+      # client call, protocol message, or database command.
+      #
+      # Requests to batch APIs that contain only one operation SHOULD be modeled as single
+      # operations, not as batch operations.
+      #
+      # A database call is not a batch operation solely because one operation accepts
+      # multiple operands, such as keys, rows, documents, points, or other data elements,
+      # including Redis [`MGET`](https://redis.io/docs/latest/commands/mget/) with
+      # multiple keys.
+      #
+      # In batch APIs that execute the same parameterized operation with parameter sets,
+      # each parameter set represents one database operation for determining whether the
+      # request is a batch operation. Requests with only one parameter set SHOULD be modeled
+      # as single operations, not as batch operations.
+      #
+      # `db.operation.batch.size` SHOULD be set to the number of operations in the batch.
+      # It SHOULD NOT be set for non-batch operations.
+      #
+      # A request to execute a batch operation with no operations SHOULD also be treated
+      # as a batch operation, and `db.operation.batch.size` SHOULD be set to `0`.
       #
       # @note Stability Level: stable
       DB_OPERATION_BATCH_SIZE = 'db.operation.batch.size'

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

@@ -31,7 +31,7 @@ module OpenTelemetry
         # @note Stability Level: development
         ANDROID_APP_STATE = 'android.app.state'
 
-        # Uniquely identifies the framework API revision offered by a version (`os.version`) of the android operating system. More information can be found in the [Android API levels documentation](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels).
+        # Uniquely identifies the framework API revision offered by a version (`os.version`) of the Android operating system. More information can be found in the [Android API levels documentation](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels).
         #
         # @note Stability Level: development
         ANDROID_OS_API_LEVEL = 'android.os.api_level'

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

@@ -29,7 +29,7 @@ module OpenTelemetry
         # @note Stability Level: development
         APP_BUILD_ID = 'app.build_id'
 
-        # A unique identifier representing an instance of an end-user facing app crash.
+        # A unique identifier representing an instance of an end user facing app crash.
         #
         # Its value MAY be meaningful and be used as a reference for telemetry and metadata recorded by
         # the same instrumentation (e.g. it is an ID generated by an external source that captured the crash).

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

@@ -34,14 +34,14 @@ module OpenTelemetry
         # @note Stability Level: development
         ARTIFACT_ATTESTATION_HASH = 'artifact.attestation.hash'
 
-        # The id of the build [software attestation](https://slsa.dev/attestation-model).
+        # The ID of the build [software attestation](https://slsa.dev/attestation-model).
         #
         # @note Stability Level: development
         ARTIFACT_ATTESTATION_ID = 'artifact.attestation.id'
 
-        # The human readable file name of the artifact, typically generated during build and release processes. Often includes the package name and version in the file name.
+        # The human readable filename of the artifact, typically generated during build and release processes. Often includes the package name and version in the filename.
         #
-        # This file name can also act as the [Package Name](https://slsa.dev/spec/v1.0/terminology#package-model)
+        # This filename can also act as the [Package Name](https://slsa.dev/spec/v1.0/terminology#package-model)
         # in cases where the package ecosystem maps accordingly.
         # Additionally, the artifact [can be published](https://slsa.dev/spec/v1.0/terminology#software-supply-chain)
         # for others, but that is not a guarantee.

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

@@ -61,6 +61,11 @@ module OpenTelemetry
         # @note Stability Level: development
         AZURE_COSMOSDB_RESPONSE_SUB_STATUS_CODE = 'azure.cosmosdb.response.sub_status_code'
 
+        # The name of the Azure [resource group](https://learn.microsoft.com/azure/azure-resource-manager/management/manage-resource-groups-portal) the resource belongs to.
+        #
+        # @note Stability Level: development
+        AZURE_RESOURCE_GROUP_NAME = 'azure.resource_group.name'
+
         # [Azure Resource Provider Namespace](https://learn.microsoft.com/azure/azure-resource-manager/management/azure-services-resource-providers) as recognized by the client.
         #
         # @note Stability Level: development

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

@@ -58,6 +58,36 @@ module OpenTelemetry
         # @note Stability Level: development
         BROWSER_PLATFORM = 'browser.platform'
 
+        # The delta between the current value and the last-reported value. See [delta](https://github.com/GoogleChrome/web-vitals?tab=readme-ov-file#report-only-the-delta-of-changes).
+        #
+        # @note Stability Level: development
+        BROWSER_WEB_VITAL_DELTA = 'browser.web_vital.delta'
+
+        # A unique ID representing this particular metric instance.
+        #
+        # @note Stability Level: development
+        BROWSER_WEB_VITAL_ID = 'browser.web_vital.id'
+
+        # Name of the web vital.
+        #
+        # @note Stability Level: development
+        BROWSER_WEB_VITAL_NAME = 'browser.web_vital.name'
+
+        # The type of navigation, as reported by the [Navigation Timing API](https://developer.mozilla.org/docs/Web/API/PerformanceNavigationTiming/type), with additional values reported by the web-vitals library.
+        #
+        # @note Stability Level: development
+        BROWSER_WEB_VITAL_NAVIGATION_TYPE = 'browser.web_vital.navigation_type'
+
+        # The rating of the web vital value against the "good", "needs improvement", and "poor" thresholds defined for the metric.
+        #
+        # @note Stability Level: development
+        BROWSER_WEB_VITAL_RATING = 'browser.web_vital.rating'
+
+        # Value of the web vital.
+        #
+        # @note Stability Level: development
+        BROWSER_WEB_VITAL_VALUE = 'browser.web_vital.value'
+
         # @!endgroup
       end
     end

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

@@ -26,84 +26,84 @@ module OpenTelemetry
 
         # The kind of action a pipeline run is performing.
         #
-        # @note Stability Level: development
+        # @note Stability Level: release_candidate
         CICD_PIPELINE_ACTION_NAME = 'cicd.pipeline.action.name'
 
         # The human readable name of the pipeline within a CI/CD system.
         #
-        # @note Stability Level: development
+        # @note Stability Level: release_candidate
         CICD_PIPELINE_NAME = 'cicd.pipeline.name'
 
         # The result of a pipeline run.
         #
-        # @note Stability Level: development
+        # @note Stability Level: release_candidate
         CICD_PIPELINE_RESULT = 'cicd.pipeline.result'
 
         # The unique identifier of a pipeline run within a CI/CD system.
         #
-        # @note Stability Level: development
+        # @note Stability Level: release_candidate
         CICD_PIPELINE_RUN_ID = 'cicd.pipeline.run.id'
 
         # The pipeline run goes through these states during its lifecycle.
         #
-        # @note Stability Level: development
+        # @note Stability Level: release_candidate
         CICD_PIPELINE_RUN_STATE = 'cicd.pipeline.run.state'
 
         # The [URL](https://wikipedia.org/wiki/URL) of the pipeline run, providing the complete address in order to locate and identify the pipeline run.
         #
-        # @note Stability Level: development
+        # @note Stability Level: release_candidate
         CICD_PIPELINE_RUN_URL_FULL = 'cicd.pipeline.run.url.full'
 
         # The human readable name of a task within a pipeline. Task here most closely aligns with a [computing process](https://wikipedia.org/wiki/Pipeline_(computing)) in a pipeline. Other terms for tasks include commands, steps, and procedures.
         #
-        # @note Stability Level: development
+        # @note Stability Level: release_candidate
         CICD_PIPELINE_TASK_NAME = 'cicd.pipeline.task.name'
 
         # 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
+        # @note Stability Level: release_candidate
         CICD_PIPELINE_TASK_RUN_ID = 'cicd.pipeline.task.run.id'
 
         # The result of a task run.
         #
-        # @note Stability Level: development
+        # @note Stability Level: release_candidate
         CICD_PIPELINE_TASK_RUN_RESULT = 'cicd.pipeline.task.run.result'
 
         # The [URL](https://wikipedia.org/wiki/URL) of the pipeline task run, providing the complete address in order to locate and identify the pipeline task run.
         #
-        # @note Stability Level: development
+        # @note Stability Level: release_candidate
         CICD_PIPELINE_TASK_RUN_URL_FULL = 'cicd.pipeline.task.run.url.full'
 
         # The type of the task within a pipeline.
         #
-        # @note Stability Level: development
+        # @note Stability Level: release_candidate
         CICD_PIPELINE_TASK_TYPE = 'cicd.pipeline.task.type'
 
         # The name of a component of the CI/CD system.
         #
-        # @note Stability Level: development
+        # @note Stability Level: release_candidate
         CICD_SYSTEM_COMPONENT = 'cicd.system.component'
 
         # The unique identifier of a worker within a CI/CD system.
         #
-        # @note Stability Level: development
+        # @note Stability Level: release_candidate
         CICD_WORKER_ID = 'cicd.worker.id'
 
         # The name of a worker within a CI/CD system.
         #
-        # @note Stability Level: development
+        # @note Stability Level: release_candidate
         CICD_WORKER_NAME = 'cicd.worker.name'
 
         # The state of a CI/CD worker / agent.
         #
-        # @note Stability Level: development
+        # @note Stability Level: release_candidate
         CICD_WORKER_STATE = 'cicd.worker.state'
 
         # The [URL](https://wikipedia.org/wiki/URL) of the worker, providing the complete address in order to locate and identify the worker.
         #
-        # @note Stability Level: development
+        # @note Stability Level: release_candidate
         CICD_WORKER_URL_FULL = 'cicd.worker.url.full'
 
         # @!endgroup

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

@@ -26,12 +26,12 @@ module OpenTelemetry
 
         # The number of pipeline runs currently active in the system by state.
         #
-        # @note Stability Level: development
+        # @note Stability Level: release_candidate
         CICD_PIPELINE_RUN_ACTIVE = 'cicd.pipeline.run.active'
 
         # Duration of a pipeline run grouped by pipeline, state and result.
         #
-        # @note Stability Level: development
+        # @note Stability Level: release_candidate
         CICD_PIPELINE_RUN_DURATION = 'cicd.pipeline.run.duration'
 
         # The number of errors encountered in pipeline runs (eg. compile, test failures).
@@ -39,19 +39,19 @@ module OpenTelemetry
         # There might be errors in a pipeline run that are non fatal (eg. they are suppressed) or in a parallel stage multiple stages could have a fatal error.
         # This means that this error count might not be the same as the count of metric `cicd.pipeline.run.duration` with run result `failure`.
         #
-        # @note Stability Level: development
+        # @note Stability Level: release_candidate
         CICD_PIPELINE_RUN_ERRORS = 'cicd.pipeline.run.errors'
 
         # The number of errors in a component of the CI/CD system (eg. controller, scheduler, agent).
         #
         # Errors in pipeline run execution are explicitly excluded. Ie a test failure is not counted in this metric.
         #
-        # @note Stability Level: development
+        # @note Stability Level: release_candidate
         CICD_SYSTEM_ERRORS = 'cicd.system.errors'
 
         # The number of workers on the CI/CD system by state.
         #
-        # @note Stability Level: development
+        # @note Stability Level: release_candidate
         CICD_WORKER_COUNT = 'cicd.worker.count'
 
         # @!endgroup

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

@@ -24,7 +24,7 @@ module OpenTelemetry
       module CLIENT
         # @!group Attribute Names
 
-        # Client address - domain name if available without reverse DNS lookup; otherwise, IP address or Unix domain socket name.
+        # Client address - domain name if available without reverse DNS lookup; otherwise, IP address or UNIX domain socket name.
         #
         # When observed from the server side, and when communicating through an intermediary, `client.address` SHOULD represent the client address behind any intermediaries,  for example proxies, if it's available.
         #

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

@@ -26,6 +26,8 @@ module OpenTelemetry
 
         # The cloud account ID the resource is assigned to.
         #
+        # For Azure, this is the subscription ID.
+        #
         # @note Stability Level: development
         CLOUD_ACCOUNT_ID = 'cloud.account.id'
 

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

@@ -129,7 +129,7 @@ module OpenTelemetry
         #
         # CloudFoundry defines the `instance_id` in the [Loggregator v2 envelope](https://github.com/cloudfoundry/loggregator-api#v2-envelope).
         # It is used for logs and metrics emitted by CloudFoundry. It is
-        # supposed to contain the vm id for CloudFoundry components.
+        # supposed to contain the vm ID for CloudFoundry components.
         #
         # When system components are instrumented, values from the
         # [Bosh spec](https://bosh.io/docs/jobs/#properties-spec)

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

@@ -37,7 +37,7 @@ module OpenTelemetry
         # @deprecated Now available in the stable namespace at {OpenTelemetry::SemConv::CODE::CODE_COLUMN_NUMBER}.
         CODE_COLUMN_NUMBER = 'code.column.number'
 
-        # The source code file name that identifies the code unit as uniquely as possible (preferably an absolute file path). This attribute MUST NOT be used on the Profile signal since the data is already captured in 'message Function'. This constraint is imposed to prevent redundancy and maintain data integrity.
+        # The source code filename that identifies the code unit as uniquely as possible (preferably an absolute file path). This attribute MUST NOT be used on the Profile signal since the data is already captured in 'message Function'. This constraint is imposed to prevent redundancy and maintain data integrity.
         #
         # @note Stability Level: stable
         #

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

@@ -70,7 +70,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/reference/api/engine/version/v1.52/#tag/Container/operation/ContainerInspect) endpoint.
+        # Docker defines a sha256 of the image ID; `container.image.id` corresponds to the `Image` field from the Docker container inspect [API](https://docs.docker.com/reference/api/engine/version/v1.52/#tag/Container/operation/ContainerInspect) endpoint.
         # K8s defines a link to the container registry repository with digest `"imageID": "registry.azurecr.io /namespace/service/dockerfile@sha256:bdeabd40c3a8a492eaf9e8e44d0ebbb84bac7ee25ac0cf8a7159d25f62555625"`.
         # The ID is assigned by the container runtime and can vary in different environments. Consider using `oci.manifest.digest` if it is important to identify the same image in different environments/runtimes.
         #
@@ -84,7 +84,7 @@ module OpenTelemetry
         # @deprecated Now available in the stable namespace at {OpenTelemetry::SemConv::CONTAINER::CONTAINER_IMAGE_NAME}.
         CONTAINER_IMAGE_NAME = 'container.image.name'
 
-        # Repo digests of the container image as provided by the container runtime.
+        # Repository 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.
         #
@@ -108,7 +108,7 @@ module OpenTelemetry
         #
         # Container labels, `<key>` being the label name, the value being the label value.
         #
-        # For example, a docker container label `app` with value `nginx` SHOULD be recorded as the `container.label.app` attribute with value `"nginx"`.
+        # For example, a Docker container label `app` with value `nginx` SHOULD be recorded as the `container.label.app` attribute with value `"nginx"`.
         #
         # @note Stability Level: development
         CONTAINER_LABEL_LAMBDA = ->(key) { "container.label.#{key}" }

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

@@ -24,16 +24,16 @@ module OpenTelemetry
       module CONTAINER
         # @!group Metrics Names
 
-        # CPU time consumed.
+        # Total CPU time consumed.
         #
         # CPU time consumed by the specific container on all available CPU cores
         #
         # @note Stability Level: release_candidate
         CONTAINER_CPU_TIME = 'container.cpu.time'
 
-        # Container's CPU usage, measured in cpus. Range from 0 to the number of allocatable CPUs.
+        # Container's CPU usage, measured in CPUs. Range from 0 to the number of allocatable CPUs.
         #
-        # CPU usage of the specific container on all available CPU cores, averaged over the sample window
+        # CPU usage of the specific container on all available CPU cores. It is calculated as the change in cumulative CPU time (container.cpu.time) over a measurement interval, divided by the elapsed time: usageCores = (cpuTimeEnd - cpuTimeStart) / elapsedSeconds
         #
         # @note Stability Level: development
         CONTAINER_CPU_USAGE = 'container.cpu.usage'
@@ -81,40 +81,43 @@ module OpenTelemetry
         #
         # 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.
+        # 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 [ContainerStats.Memory](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#ContainerStats) of the Kubelet's stats API.
         #
-        # @note Stability Level: development
+        # @note Stability Level: release_candidate
         CONTAINER_MEMORY_AVAILABLE = 'container.memory.available'
 
-        # Container memory paging faults.
+        # Deprecated, use `container.paging.faults` instead.
         #
         # 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
+        # @deprecated Replaced by `container.paging.faults`.
         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.
+        # 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 [ContainerStats.Memory](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#ContainerStats) of the Kubelet's stats API.
         #
-        # @note Stability Level: development
+        # @note Stability Level: release_candidate
         CONTAINER_MEMORY_RSS = 'container.memory.rss'
 
         # Memory usage of the container.
         #
-        # Memory usage of the container.
+        # Current memory usage, including all memory regardless of when it was accessed.
+        # 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_usage_bytes` metric.
+        # In K8s, this metric is derived from the [MemoryStats.UsageBytes](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#MemoryStats) field of the [ContainerStats.Memory](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#ContainerStats) of the Kubelet's stats API.
         #
-        # @note Stability Level: development
+        # @note Stability Level: release_candidate
         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.
+        # 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 [ContainerStats.Memory](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#ContainerStats) of the Kubelet's stats API.
         #
-        # @note Stability Level: development
+        # @note Stability Level: release_candidate
         CONTAINER_MEMORY_WORKING_SET = 'container.memory.working_set'
 
         # Network bytes for the container.
@@ -124,6 +127,14 @@ module OpenTelemetry
         # @note Stability Level: development
         CONTAINER_NETWORK_IO = 'container.network.io'
 
+        # 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 [ContainerStats.Memory](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#ContainerStats) of the Kubelet's stats API.
+        #
+        # @note Stability Level: development
+        CONTAINER_PAGING_FAULTS = 'container.paging.faults'
+
         # The time the container has been running.
         #
         # Instrumentations SHOULD use a gauge with type `double` and measure uptime in seconds as a floating point number with the highest precision available.

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

@@ -242,9 +242,30 @@ module OpenTelemetry
         # @deprecated Replaced by `db.operation.name`.
         DB_OPERATION = 'db.operation'
 
-        # The number of queries included in a batch operation.
+        # The number of database operations included in a batch operation.
         #
-        # Operations are only considered batches when they contain two or more operations, and so `db.operation.batch.size` SHOULD never be `1`.
+        # Except for empty batch requests described below, a batch operation contains two
+        # or more database operations explicitly submitted as separate operations in a single
+        # client call, protocol message, or database command.
+        #
+        # Requests to batch APIs that contain only one operation SHOULD be modeled as single
+        # operations, not as batch operations.
+        #
+        # A database call is not a batch operation solely because one operation accepts
+        # multiple operands, such as keys, rows, documents, points, or other data elements,
+        # including Redis [`MGET`](https://redis.io/docs/latest/commands/mget/) with
+        # multiple keys.
+        #
+        # In batch APIs that execute the same parameterized operation with parameter sets,
+        # each parameter set represents one database operation for determining whether the
+        # request is a batch operation. Requests with only one parameter set SHOULD be modeled
+        # as single operations, not as batch operations.
+        #
+        # `db.operation.batch.size` SHOULD be set to the number of operations in the batch.
+        # It SHOULD NOT be set for non-batch operations.
+        #
+        # A request to execute a batch operation with no operations SHOULD also be treated
+        # as a batch operation, and `db.operation.batch.size` SHOULD be set to `0`.
         #
         # @note Stability Level: stable
         #
@@ -305,7 +326,12 @@ module OpenTelemetry
         # 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.
+        # without attempting to do any case normalization or sanitization.
+        #
+        # Instrumentations SHOULD NOT capture `db.query.parameter.<key>` by default
+        # since values may contain PII or sensitive details.
+        # Application operators are expected to enable specific keys depending
+        # on their privacy and security considerations.
         #
         # `db.query.parameter.<key>` SHOULD NOT be captured on batch operations.
         #
@@ -355,7 +381,7 @@ module OpenTelemetry
         # Deprecated, use `db.namespace` instead.
         #
         # @note Stability Level: development
-        # @deprecated Uncategorized.
+        # @deprecated Replaced by `db.namespace` (string).
         DB_REDIS_DATABASE_INDEX = 'db.redis.database_index'
 
         # Number of rows returned by the operation.

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

@@ -45,7 +45,7 @@ module OpenTelemetry
         # @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.
+        # The ID of the deployment.
         #
         # @note Stability Level: development
         DEPLOYMENT_ID = 'deployment.id'

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

@@ -24,7 +24,7 @@ module OpenTelemetry
       module DESTINATION
         # @!group Attribute Names
 
-        # Destination address - domain name if available without reverse DNS lookup; otherwise, IP address or Unix domain socket name.
+        # Destination address - domain name if available without reverse DNS lookup; otherwise, IP address or UNIX domain socket name.
         #
         # When observed from the source side, and when communicating through an intermediary, `destination.address` SHOULD represent the destination address behind any intermediaries, for example proxies, if it's available.
         #

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

@@ -26,7 +26,7 @@ module OpenTelemetry
 
         # The disk IO operation direction.
         #
-        # @note Stability Level: development
+        # @note Stability Level: release_candidate
         DISK_IO_DIRECTION = 'disk.io.direction'
 
         # @!endgroup

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

@@ -59,7 +59,7 @@ module OpenTelemetry
 
         # File extension, excluding the leading dot.
         #
-        # When the file name has multiple extensions (example.tar.gz), only the last one should be captured ("gz", not "tar.gz").
+        # When the filename has multiple extensions (example.tar.gz), only the last one should be captured ("gz", not "tar.gz").
         #
         # @note Stability Level: development
         FILE_EXTENSION = 'file.extension'
@@ -67,7 +67,7 @@ module OpenTelemetry
         # Name of the fork. A fork is additional data associated with a filesystem object.
         #
         # On Linux, a resource fork is used to store additional data with a filesystem object. A file always has at least one fork for the data portion, and additional forks may exist.
-        # On NTFS, this is analogous to an Alternate Data Stream (ADS), and the default data stream for a file is just called $DATA. Zone.Identifier is commonly used by Windows to track contents downloaded from the Internet. An ADS is typically of the form: C:\path\to\filename.extension:some_fork_name, and some_fork_name is the value that should populate `fork_name`. `filename.extension` should populate `file.name`, and `extension` should populate `file.extension`. The full path, `file.path`, will include the fork name.
+        # On NTFS, this is analogous to an Alternate Data Stream (ADS), and the default data stream for a file is just called $DATA. Zone.Identifier is commonly used by Windows to track contents downloaded from the internet. An ADS is typically of the form: C:\path\to\filename.extension:some_fork_name, and some_fork_name is the value that should populate `fork_name`. `filename.extension` should populate `file.name`, and `extension` should populate `file.extension`. The full path, `file.path`, will include the fork name.
         #
         # @note Stability Level: development
         FILE_FORK_NAME = 'file.fork_name'
@@ -127,7 +127,7 @@ module OpenTelemetry
         # @note Stability Level: development
         FILE_OWNER_NAME = 'file.owner.name'
 
-        # Full path to the file, including the file name. It should include the drive letter, when appropriate.
+        # Full path to the file, including the filename. It should include the drive letter, when appropriate.
         #
         # @note Stability Level: development
         FILE_PATH = 'file.path'

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

@@ -95,7 +95,7 @@ module OpenTelemetry
         # @note Stability Level: development
         HOST_MAC = 'host.mac'
 
-        # Name of the host. On Unix systems, it may contain what the hostname command returns, or the fully qualified hostname, or another name specified by the user.
+        # Name of the host. On UNIX systems, it may contain what the hostname command returns, or the fully qualified hostname, or another name specified by the user.
         #
         # @note Stability Level: development
         HOST_NAME = 'host.name'