chore: prepare next release (#5795)

Co-authored-by: otelbot <197425009+otelbot@users.noreply.github.com>

.github/workflows/codeql-analysis.yml

@@ -7,11 +7,12 @@ on:
   pull_request:
 
 permissions:
-  security-events: write
   contents: read
 
 jobs:
   CodeQL-Build:
+    permissions:
+      security-events: write
     runs-on: ubuntu-latest
 
     steps:

README.md

@@ -277,26 +277,26 @@ Typically, members of this are [component owners](https://github.com/open-teleme
 - [Motti](https://github.com/mottibec)
 - [Punya Biswal](https://github.com/punya), Google
 - [Siim Kallas](https://github.com/seemk), Splunk
-- [Trivikram Kamat](https://github.com/trivikr), AWS
 - [t2t2](https://github.com/t2t2), Splunk
+- [Trivikram Kamat](https://github.com/trivikr), AWS
 
 For more information about the triager role, see the [community repository](https://github.com/open-telemetry/community/blob/main/guides/contributor/membership.md#triager).
 
 ### Emeriti
 
-- [Bartlomiej Obecny](https://github.com/obecny), LightStep, Maintainer
-- [Daniel Khan](https://github.com/dkhan), Dynatrace, Maintainer
-- [Mayur Kale](https://github.com/mayurkale22), Google, Maintainer
+- [Bartlomiej Obecny](https://github.com/obecny), Maintainer
+- [Brandon Gonzalez](https://github.com/bg451), Approver
+- [Daniel Khan](https://github.com/dkhan), Maintainer
+- [Gerhard Stöbich](https://github.com/Flarna), Approver
+- [Haddas Bronfman](https://github.com/haddasbronfman), Approver
+- [John Bley](https://github.com/johnbley), Approver
+- [Mark Wolff](https://github.com/markwolff), Approver
+- [Mayur Kale](https://github.com/mayurkale22), Maintainer
+- [Naseem K. Ullah](https://github.com/naseemkullah), Approver
+- [Olivier Albertini](https://github.com/OlivierAlbertini), Approver
 - [Rauno Viskus](https://github.com/rauno56), Maintainer
+- [Roch Devost](https://github.com/rochdev), Approver
 - [Valentin Marchaud](https://github.com/vmarchaud), Maintainer
-- [Brandon Gonzalez](https://github.com/bg451), LightStep, Approver
-- [Roch Devost](https://github.com/rochdev), DataDog, Approver
-- [John Bley](https://github.com/johnbley), Splunk, Approver
-- [Mark Wolff](https://github.com/markwolff), Microsoft, Approver
-- [Olivier Albertini](https://github.com/OlivierAlbertini), Ville de Montréal, Approver
-- [Gerhard Stöbich](https://github.com/Flarna), Dynatrace, Approver
-- [Haddas Bronfman](https://github.com/haddasbronfman), Cisco, Approver
-- [Naseem K. Ullah](https://github.com/naseemkullah), Transit, Approver
 
 For more information about the emeritus role, see the [community repository](https://github.com/open-telemetry/community/blob/main/guides/contributor/membership.md#emeritus-maintainerapprovertriager).
 

scripts/semconv/generate.sh

@@ -7,9 +7,9 @@ ROOT_DIR="${SCRIPT_DIR}/../../"
 
 # Get latest version by running `git tag -l --sort=version:refname | tail -1`
 # ... in git@github.com:open-telemetry/semantic-conventions.git
-SPEC_VERSION=v1.34.0
+SPEC_VERSION=v1.36.0
 # ... in git@github.com:open-telemetry/weaver.git
-GENERATOR_VERSION=v0.15.0
+GENERATOR_VERSION=v0.16.1
 
 # When running on windows and you are getting references to ";C" (like Telemetry;C)
 # then this is an issue with the bash shell, so first run the following in your shell:

scripts/semconv/templates/registry/ts-experimental/attributes.ts.j2

@@ -32,12 +32,10 @@ export const ATTR_{{ attribute.name | screaming_snake_case }} = (key: string) =>
 {% endif %}
 {% endif %}
 {% if attribute.type is mapping %}
-{% for espec in attribute.type.members | sort(attribute='value') %}
-{% if espec is not stable %}
-/**
- * Enum value {{ espec.value | print_member_value }} for attribute {@link ATTR_{{ attribute.name | screaming_snake_case }}}.
- */
-export const {{ attribute.name | screaming_snake_case }}_VALUE_{{ espec.id | screaming_snake_case }} = {{ espec.value | print_member_value }} as const;
+{% for member in attribute.type.members | sort(attribute='value') %}
+{% if member is not stable %}
+{{d.docstring_enum_value(member, attribute)}}
+export const {{ attribute.name | screaming_snake_case }}_VALUE_{{ member.id | screaming_snake_case }} = {{ member.value | print_member_value }} as const;
 
 {% endif %}
 {% endfor %}

scripts/semconv/templates/registry/ts-experimental/docstring.ts.j2

@@ -1,5 +1,6 @@
 {% macro strong_rfc2119(string) -%}{{ string | regex_replace("\\b(MUST NOT|MUST|REQUIRED|SHALL NOT|SHALL|SHOULD NOT|SHOULD|RECOMMENDED|MAY|OPTIONAL)\\b", "**$1**") }}{% endmacro -%}
 
+
 {% macro docstring(obj, type="value") -%}
 {%- set examples_jsdoc %}
   {% if obj.examples is sequence %}
@@ -32,3 +33,28 @@
   deprecated_jsdoc,
 ] | comment }}
 {%- endmacro -%}
+
+
+{% macro docstring_enum_value(member, attribute) -%}
+
+{%- if member.brief %}
+  {% set brief_jsdoc = "\n" ~ strong_rfc2119(member.brief) %}
+{% endif -%}
+
+{%- if member.stability != "stable" %}
+  {% set stability_jsdoc = "\n@experimental This enum value is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`." %}
+{% endif -%}
+
+{%- if member.deprecated %}
+  {%- set deprecated_jsdoc = "\n@deprecated " ~ strong_rfc2119(member.deprecated) -%}
+{%- endif -%}
+
+{%- set enum_jsdoc = "Enum value " ~ member.value | print_member_value ~ " for attribute {@link ATTR_" ~ attribute.name | screaming_snake_case ~ "}." -%}
+
+{{ [
+  enum_jsdoc,
+  brief_jsdoc,
+  stability_jsdoc,
+  deprecated_jsdoc,
+] | comment }}
+{%- endmacro -%}

scripts/semconv/templates/registry/ts-stable/attributes.ts.j2

@@ -30,12 +30,10 @@ export const ATTR_{{ attribute.name | screaming_snake_case }} = (key: string) =>
 
 {% endif %}
 {% if attribute.type is mapping %}
-{% for espec in attribute.type.members | sort(attribute='value') %}
-{% if espec is stable %}
-/**
- * Enum value {{ espec.value | print_member_value }} for attribute {@link ATTR_{{ attribute.name | screaming_snake_case }}}.
- */
-export const {{ attribute.name | screaming_snake_case }}_VALUE_{{ espec.id | screaming_snake_case }} = {{ espec.value | print_member_value }} as const;
+{% for member in attribute.type.members | sort(attribute='value') %}
+{% if member is stable %}
+{{d.docstring_enum_value(member, attribute)}}
+export const {{ attribute.name | screaming_snake_case }}_VALUE_{{ member.id | screaming_snake_case }} = {{ member.value | print_member_value }} as const;
 
 {% endif %}
 {% endfor %}

scripts/semconv/templates/registry/ts-stable/docstring.ts.j2

@@ -1,5 +1,6 @@
 {% macro strong_rfc2119(string) -%}{{ string | regex_replace("\\b(MUST NOT|MUST|REQUIRED|SHALL NOT|SHALL|SHOULD NOT|SHOULD|RECOMMENDED|MAY|OPTIONAL)\\b", "**$1**") }}{% endmacro -%}
 
+
 {% macro docstring(obj, type="value") -%}
 {%- set examples_jsdoc %}
   {% if obj.examples is sequence %}
@@ -32,3 +33,28 @@
   deprecated_jsdoc,
 ] | comment }}
 {%- endmacro -%}
+
+
+{% macro docstring_enum_value(member, attribute) -%}
+
+{%- if member.brief %}
+  {% set brief_jsdoc = "\n" ~ strong_rfc2119(member.brief) %}
+{% endif -%}
+
+{%- if member.stability != "stable" %}
+  {% set stability_jsdoc = "\n@experimental This enum value is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`." %}
+{% endif -%}
+
+{%- if member.deprecated %}
+  {%- set deprecated_jsdoc = "\n@deprecated " ~ strong_rfc2119(member.deprecated) -%}
+{%- endif -%}
+
+{%- set enum_jsdoc = "Enum value " ~ member.value | print_member_value ~ " for attribute {@link ATTR_" ~ attribute.name | screaming_snake_case ~ "}." -%}
+
+{{ [
+  enum_jsdoc,
+  brief_jsdoc,
+  stability_jsdoc,
+  deprecated_jsdoc,
+] | comment }}
+{%- endmacro -%}

semantic-conventions/CHANGELOG.md

@@ -15,6 +15,179 @@ All notable changes to the semantic-conventions package will be documented in th
 
 ### :house: Internal
 
+## 1.36.0
+
+### :rocket: Features
+
+* feat: update semantic conventions to v1.36.0 [#5779](https://github.com/open-telemetry/opentelemetry-js/pull/5779) @trentm
+  * Semantic Conventions v1.36.0: [changelog](https://github.com/open-telemetry/semantic-conventions/blob/main/CHANGELOG.md#v1360) | [latest docs](https://opentelemetry.io/docs/specs/semconv/)
+  * `@opentelemetry/semantic-conventions` (stable) changes: *none*
+  * `@opentelemetry/semantic-conventions/incubating` (unstable) changes: *8 exported values changed, 7 newly deprecated exports, 3 newly undeprecated exports, 88 added exports*
+
+#### Unstable changes in v1.36.0
+
+<details>
+<summary>8 exported values changed</summary>
+
+```js
+CLOUD_PLATFORM_VALUE_AZURE_AKS                 // "azure_aks" -> "azure.aks"
+CLOUD_PLATFORM_VALUE_AZURE_APP_SERVICE         // "azure_app_service" -> "azure.app_service"
+CLOUD_PLATFORM_VALUE_AZURE_CONTAINER_APPS      // "azure_container_apps" -> "azure.container_apps"
+CLOUD_PLATFORM_VALUE_AZURE_CONTAINER_INSTANCES // "azure_container_instances" -> "azure.container_instances"
+CLOUD_PLATFORM_VALUE_AZURE_FUNCTIONS           // "azure_functions" -> "azure.functions"
+CLOUD_PLATFORM_VALUE_AZURE_OPENSHIFT           // "azure_openshift" -> "azure.openshift"
+CLOUD_PLATFORM_VALUE_AZURE_VM                  // "azure_vm" -> "azure.vm"
+GEN_AI_SYSTEM_VALUE_AZ_AI_OPENAI               // "az.ai.openai" -> "azure.ai.openai"
+```
+
+</details>
+
+<details>
+<summary>7 newly deprecated exports</summary>
+
+```js
+METRIC_CPU_FREQUENCY              // cpu.frequency: Replaced by `system.cpu.frequency`.
+METRIC_CPU_TIME                   // cpu.time: Replaced by `system.cpu.time`.
+METRIC_CPU_UTILIZATION            // cpu.utilization: Replaced by `system.cpu.utilization`.
+METRIC_OTEL_SDK_SPAN_ENDED        // otel.sdk.span.ended: Obsoleted.
+METRIC_SYSTEM_NETWORK_CONNECTIONS // system.network.connections: Replaced by `system.network.connection.count`.
+ATTR_AZ_NAMESPACE                 // az.namespace: Replaced by `azure.resource_provider.namespace`.
+ATTR_AZ_SERVICE_REQUEST_ID        // az.service_request_id: Replaced by `azure.service.request.id`.
+```
+
+</details>
+
+<details>
+<summary>3 newly undeprecated exports</summary>
+
+```js
+METRIC_SYSTEM_CPU_FREQUENCY   // system.cpu.frequency
+METRIC_SYSTEM_CPU_TIME        // system.cpu.time
+METRIC_SYSTEM_CPU_UTILIZATION // system.cpu.utilization
+```
+
+</details>
+
+<details>
+<summary>88 added exports</summary>
+
+```js
+METRIC_K8S_CONTAINER_CPU_LIMIT                                  // k8s.container.cpu.limit
+METRIC_K8S_CONTAINER_CPU_REQUEST                                // k8s.container.cpu.request
+METRIC_K8S_CONTAINER_EPHEMERAL_STORAGE_LIMIT                    // k8s.container.ephemeral_storage.limit
+METRIC_K8S_CONTAINER_EPHEMERAL_STORAGE_REQUEST                  // k8s.container.ephemeral_storage.request
+METRIC_K8S_CONTAINER_MEMORY_LIMIT                               // k8s.container.memory.limit
+METRIC_K8S_CONTAINER_MEMORY_REQUEST                             // k8s.container.memory.request
+METRIC_K8S_CONTAINER_READY                                      // k8s.container.ready
+METRIC_K8S_CONTAINER_RESTART_COUNT                              // k8s.container.restart.count
+METRIC_K8S_CONTAINER_STATUS_REASON                              // k8s.container.status.reason
+METRIC_K8S_CONTAINER_STATUS_STATE                               // k8s.container.status.state
+METRIC_K8S_CONTAINER_STORAGE_LIMIT                              // k8s.container.storage.limit
+METRIC_K8S_CONTAINER_STORAGE_REQUEST                            // k8s.container.storage.request
+METRIC_K8S_HPA_METRIC_TARGET_CPU_AVERAGE_UTILIZATION            // k8s.hpa.metric.target.cpu.average_utilization
+METRIC_K8S_HPA_METRIC_TARGET_CPU_AVERAGE_VALUE                  // k8s.hpa.metric.target.cpu.average_value
+METRIC_K8S_HPA_METRIC_TARGET_CPU_VALUE                          // k8s.hpa.metric.target.cpu.value
+METRIC_K8S_NODE_ALLOCATABLE_CPU                                 // k8s.node.allocatable.cpu
+METRIC_K8S_NODE_ALLOCATABLE_EPHEMERAL_STORAGE                   // k8s.node.allocatable.ephemeral_storage
+METRIC_K8S_NODE_ALLOCATABLE_MEMORY                              // k8s.node.allocatable.memory
+METRIC_K8S_NODE_ALLOCATABLE_PODS                                // k8s.node.allocatable.pods
+METRIC_K8S_NODE_CONDITION_STATUS                                // k8s.node.condition.status
+METRIC_K8S_RESOURCEQUOTA_CPU_LIMIT_HARD                         // k8s.resourcequota.cpu.limit.hard
+METRIC_K8S_RESOURCEQUOTA_CPU_LIMIT_USED                         // k8s.resourcequota.cpu.limit.used
+METRIC_K8S_RESOURCEQUOTA_CPU_REQUEST_HARD                       // k8s.resourcequota.cpu.request.hard
+METRIC_K8S_RESOURCEQUOTA_CPU_REQUEST_USED                       // k8s.resourcequota.cpu.request.used
+METRIC_K8S_RESOURCEQUOTA_EPHEMERAL_STORAGE_LIMIT_HARD           // k8s.resourcequota.ephemeral_storage.limit.hard
+METRIC_K8S_RESOURCEQUOTA_EPHEMERAL_STORAGE_LIMIT_USED           // k8s.resourcequota.ephemeral_storage.limit.used
+METRIC_K8S_RESOURCEQUOTA_EPHEMERAL_STORAGE_REQUEST_HARD         // k8s.resourcequota.ephemeral_storage.request.hard
+METRIC_K8S_RESOURCEQUOTA_EPHEMERAL_STORAGE_REQUEST_USED         // k8s.resourcequota.ephemeral_storage.request.used
+METRIC_K8S_RESOURCEQUOTA_HUGEPAGE_COUNT_REQUEST_HARD            // k8s.resourcequota.hugepage_count.request.hard
+METRIC_K8S_RESOURCEQUOTA_HUGEPAGE_COUNT_REQUEST_USED            // k8s.resourcequota.hugepage_count.request.used
+METRIC_K8S_RESOURCEQUOTA_MEMORY_LIMIT_HARD                      // k8s.resourcequota.memory.limit.hard
+METRIC_K8S_RESOURCEQUOTA_MEMORY_LIMIT_USED                      // k8s.resourcequota.memory.limit.used
+METRIC_K8S_RESOURCEQUOTA_MEMORY_REQUEST_HARD                    // k8s.resourcequota.memory.request.hard
+METRIC_K8S_RESOURCEQUOTA_MEMORY_REQUEST_USED                    // k8s.resourcequota.memory.request.used
+METRIC_K8S_RESOURCEQUOTA_OBJECT_COUNT_HARD                      // k8s.resourcequota.object_count.hard
+METRIC_K8S_RESOURCEQUOTA_OBJECT_COUNT_USED                      // k8s.resourcequota.object_count.used
+METRIC_K8S_RESOURCEQUOTA_PERSISTENTVOLUMECLAIM_COUNT_HARD       // k8s.resourcequota.persistentvolumeclaim_count.hard
+METRIC_K8S_RESOURCEQUOTA_PERSISTENTVOLUMECLAIM_COUNT_USED       // k8s.resourcequota.persistentvolumeclaim_count.used
+METRIC_K8S_RESOURCEQUOTA_STORAGE_REQUEST_HARD                   // k8s.resourcequota.storage.request.hard
+METRIC_K8S_RESOURCEQUOTA_STORAGE_REQUEST_USED                   // k8s.resourcequota.storage.request.used
+
+METRIC_OTEL_SDK_SPAN_STARTED                                    // otel.sdk.span.started
+
+METRIC_SYSTEM_NETWORK_CONNECTION_COUNT                          // system.network.connection.count
+
+ATTR_AZURE_RESOURCE_PROVIDER_NAMESPACE                          // azure.resource_provider.namespace
+ATTR_AZURE_SERVICE_REQUEST_ID                                   // azure.service.request.id
+
+ATTR_DNS_ANSWERS                                                // dns.answers
+
+GEN_AI_SYSTEM_VALUE_AZURE_AI_INFERENCE                          // "azure.ai.inference"
+GEN_AI_SYSTEM_VALUE_AZURE_AI_OPENAI                             // "azure.ai.openai"
+
+ATTR_K8S_CONTAINER_STATUS_REASON                                // k8s.container.status.reason
+  K8S_CONTAINER_STATUS_REASON_VALUE_COMPLETED                     // "Completed"
+  K8S_CONTAINER_STATUS_REASON_VALUE_CONTAINER_CANNOT_RUN          // "ContainerCannotRun"
+  K8S_CONTAINER_STATUS_REASON_VALUE_CONTAINER_CREATING            // "ContainerCreating"
+  K8S_CONTAINER_STATUS_REASON_VALUE_CRASH_LOOP_BACK_OFF           // "CrashLoopBackOff"
+  K8S_CONTAINER_STATUS_REASON_VALUE_CREATE_CONTAINER_CONFIG_ERROR // "CreateContainerConfigError"
+  K8S_CONTAINER_STATUS_REASON_VALUE_ERR_IMAGE_PULL                // "ErrImagePull"
+  K8S_CONTAINER_STATUS_REASON_VALUE_ERROR                         // "Error"
+  K8S_CONTAINER_STATUS_REASON_VALUE_IMAGE_PULL_BACK_OFF           // "ImagePullBackOff"
+  K8S_CONTAINER_STATUS_REASON_VALUE_OOM_KILLED                    // "OOMKilled"
+ATTR_K8S_CONTAINER_STATUS_STATE                                 // k8s.container.status.state
+  K8S_CONTAINER_STATUS_STATE_VALUE_RUNNING                        // "running"
+  K8S_CONTAINER_STATUS_STATE_VALUE_TERMINATED                     // "terminated"
+  K8S_CONTAINER_STATUS_STATE_VALUE_WAITING                        // "waiting"
+ATTR_K8S_HPA_METRIC_TYPE                                        // k8s.hpa.metric.type
+ATTR_K8S_HPA_SCALETARGETREF_API_VERSION                         // k8s.hpa.scaletargetref.api_version
+ATTR_K8S_HPA_SCALETARGETREF_KIND                                // k8s.hpa.scaletargetref.kind
+ATTR_K8S_HPA_SCALETARGETREF_NAME                                // k8s.hpa.scaletargetref.name
+ATTR_K8S_HUGEPAGE_SIZE                                          // k8s.hugepage.size
+ATTR_K8S_NODE_CONDITION_STATUS                                  // k8s.node.condition.status
+  K8S_NODE_CONDITION_STATUS_VALUE_CONDITION_FALSE                 // "false"
+  K8S_NODE_CONDITION_STATUS_VALUE_CONDITION_TRUE                  // "true"
+  K8S_NODE_CONDITION_STATUS_VALUE_CONDITION_UNKNOWN               // "unknown"
+ATTR_K8S_NODE_CONDITION_TYPE                                    // k8s.node.condition.type
+  K8S_NODE_CONDITION_TYPE_VALUE_DISK_PRESSURE                     // "DiskPressure"
+  K8S_NODE_CONDITION_TYPE_VALUE_MEMORY_PRESSURE                   // "MemoryPressure"
+  K8S_NODE_CONDITION_TYPE_VALUE_NETWORK_UNAVAILABLE               // "NetworkUnavailable"
+  K8S_NODE_CONDITION_TYPE_VALUE_PID_PRESSURE                      // "PIDPressure"
+  K8S_NODE_CONDITION_TYPE_VALUE_READY                             // "Ready"
+ATTR_K8S_RESOURCEQUOTA_RESOURCE_NAME                            // k8s.resourcequota.resource_name
+ATTR_K8S_STORAGECLASS_NAME                                      // k8s.storageclass.name
+
+ATTR_MAINFRAME_LPAR_NAME                                        // mainframe.lpar.name
+
+OS_TYPE_VALUE_ZOS                                               // "zos"
+
+OTEL_COMPONENT_TYPE_VALUE_PROMETHEUS_HTTP_TEXT_METRIC_EXPORTER  // "prometheus_http_text_metric_exporter"
+OTEL_COMPONENT_TYPE_VALUE_ZIPKIN_HTTP_SPAN_EXPORTER             // "zipkin_http_span_exporter"
+ATTR_OTEL_SPAN_PARENT_ORIGIN                                    // otel.span.parent.origin
+  OTEL_SPAN_PARENT_ORIGIN_VALUE_LOCAL                             // "local"
+  OTEL_SPAN_PARENT_ORIGIN_VALUE_NONE                              // "none"
+  OTEL_SPAN_PARENT_ORIGIN_VALUE_REMOTE                            // "remote"
+
+ATTR_ZOS_SMF_ID                                                 // zos.smf.id
+ATTR_ZOS_SYSPLEX_NAME                                           // zos.sysplex.name
+```
+
+</details>
+
+## 1.35.0
+
+**Known issue:** Changes from semantic conventions **v1.36.0** where accidentally released in this JS package with version **1.35.0**. Please use `@opentelemetry/semantic-conventions@1.36.0`.
+
+### :rocket: Features
+
+* feat: update semantic conventions to v1.36.0 [#5779](https://github.com/open-telemetry/opentelemetry-js/pull/5779) @trentm
+  * Changes from semantic conventions **v1.36.0** were incorrectly included in this release. See note above.
+
+* feat: improve the jsdoc comment on exported constants for enum values [#5784](https://github.com/open-telemetry/opentelemetry-js/pull/5784) @trentm
+  * The jsdoc comment for enum values now includes the 'brief', an
+    `@experimental` tag, and a `@deprecated` tag if the corresponding fields
+    exist on the semconv definition.
+
 ## 1.34.0
 
 ### :rocket: Features

semantic-conventions/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opentelemetry/semantic-conventions",
-  "version": "1.34.0",
+  "version": "1.36.0",
   "description": "OpenTelemetry semantic conventions",
   "main": "build/src/index.js",
   "module": "build/esm/index.js",

semantic-conventions/src/experimental_metrics.ts

@@ -127,23 +127,29 @@ export const METRIC_CONTAINER_NETWORK_IO = 'container.network.io' as const;
 export const METRIC_CONTAINER_UPTIME = 'container.uptime' as const;
 
 /**
- * Operating frequency of the logical CPU in Hertz.
+ * Deprecated. Use `system.cpu.frequency` instead.
  *
  * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
+ *
+ * @deprecated Replaced by `system.cpu.frequency`.
  */
 export const METRIC_CPU_FREQUENCY = 'cpu.frequency' as const;
 
 /**
- * Seconds each logical CPU spent on each mode
+ * Deprecated. Use `system.cpu.time` instead.
  *
  * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
+ *
+ * @deprecated Replaced by `system.cpu.time`.
  */
 export const METRIC_CPU_TIME = 'cpu.time' as const;
 
 /**
- * For each logical CPU, the utilization is calculated as the change in cumulative CPU time (cpu.time) over a measurement interval, divided by the elapsed time.
+ * Deprecated. Use `system.cpu.utilization` instead.
  *
  * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
+ *
+ * @deprecated Replaced by `system.cpu.utilization`.
  */
 export const METRIC_CPU_UTILIZATION = 'cpu.utilization' as const;
 
@@ -719,15 +725,127 @@ export const METRIC_JVM_SYSTEM_CPU_LOAD_1M = 'jvm.system.cpu.load_1m' as const;
  */
 export const METRIC_JVM_SYSTEM_CPU_UTILIZATION = 'jvm.system.cpu.utilization' as const;
 
+/**
+ * Maximum CPU resource limit set for the container
+ *
+ * @note See https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.30/#resourcerequirements-v1-core for details.
+ *
+ * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
+ */
+export const METRIC_K8S_CONTAINER_CPU_LIMIT = 'k8s.container.cpu.limit' as const;
+
+/**
+ * CPU resource requested for the container
+ *
+ * @note See https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.30/#resourcerequirements-v1-core for details.
+ *
+ * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
+ */
+export const METRIC_K8S_CONTAINER_CPU_REQUEST = 'k8s.container.cpu.request' as const;
+
+/**
+ * Maximum ephemeral storage resource limit set for the container
+ *
+ * @note See https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.30/#resourcerequirements-v1-core for details.
+ *
+ * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
+ */
+export const METRIC_K8S_CONTAINER_EPHEMERAL_STORAGE_LIMIT = 'k8s.container.ephemeral_storage.limit' as const;
+
+/**
+ * Ephemeral storage resource requested for the container
+ *
+ * @note See https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.30/#resourcerequirements-v1-core for details.
+ *
+ * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
+ */
+export const METRIC_K8S_CONTAINER_EPHEMERAL_STORAGE_REQUEST = 'k8s.container.ephemeral_storage.request' as const;
+
+/**
+ * Maximum memory resource limit set for the container
+ *
+ * @note See https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.30/#resourcerequirements-v1-core for details.
+ *
+ * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
+ */
+export const METRIC_K8S_CONTAINER_MEMORY_LIMIT = 'k8s.container.memory.limit' as const;
+
+/**
+ * Memory resource requested for the container
+ *
+ * @note See https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.30/#resourcerequirements-v1-core for details.
+ *
+ * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
+ */
+export const METRIC_K8S_CONTAINER_MEMORY_REQUEST = 'k8s.container.memory.request' as const;
+
+/**
+ * Indicates whether the container is currently marked as ready to accept traffic, based on its readiness probe (1 = ready, 0 = not ready)
+ *
+ * @note This metric **SHOULD** reflect the value of the `ready` field in the
+ * [K8s ContainerStatus](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.30/#containerstatus-v1-core).
+ *
+ * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
+ */
+export const METRIC_K8S_CONTAINER_READY = 'k8s.container.ready' as const;
+
+/**
+ * Describes how many times the container has restarted (since the last counter reset)
+ *
+ * @note This value is pulled directly from the K8s API and the value can go indefinitely high and be reset to 0
+ * at any time depending on how your kubelet is configured to prune dead containers.
+ * It is best to not depend too much on the exact value but rather look at it as
+ * either == 0, in which case you can conclude there were no restarts in the recent past, or > 0, in which case
+ * you can conclude there were restarts in the recent past, and not try and analyze the value beyond that.
+ *
+ * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
+ */
+export const METRIC_K8S_CONTAINER_RESTART_COUNT = 'k8s.container.restart.count' as const;
+
+/**
+ * Describes the number of K8s containers that are currently in a state for a given reason
+ *
+ * @note All possible container state reasons will be reported at each time interval to avoid missing metrics.
+ * Only the value corresponding to the current state reason will be non-zero.
+ *
+ * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
+ */
+export const METRIC_K8S_CONTAINER_STATUS_REASON = 'k8s.container.status.reason' as const;
+
+/**
+ * Describes the number of K8s containers that are currently in a given state
+ *
+ * @note All possible container states will be reported at each time interval to avoid missing metrics.
+ * Only the value corresponding to the current state will be non-zero.
+ *
+ * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
+ */
+export const METRIC_K8S_CONTAINER_STATUS_STATE = 'k8s.container.status.state' as const;
+
+/**
+ * Maximum storage resource limit set for the container
+ *
+ * @note See https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.30/#resourcerequirements-v1-core for details.
+ *
+ * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
+ */
+export const METRIC_K8S_CONTAINER_STORAGE_LIMIT = 'k8s.container.storage.limit' as const;
+
+/**
+ * Storage resource requested for the container
+ *
+ * @note See https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.30/#resourcerequirements-v1-core for details.
+ *
+ * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
+ */
+export const METRIC_K8S_CONTAINER_STORAGE_REQUEST = 'k8s.container.storage.request' as const;
+
 /**
  * The number of actively running jobs for a cronjob
  *
  * @note This metric aligns with the `active` field of the
  * [K8s CronJobStatus](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.30/#cronjobstatus-v1-batch).
  *
- * This metric **SHOULD**, at a minimum, be reported against a
- * [`k8s.cronjob`](../resource/k8s.md#cronjob) resource.
- *
  * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
  */
 export const METRIC_K8S_CRONJOB_ACTIVE_JOBS = 'k8s.cronjob.active_jobs' as const;
@@ -738,9 +856,6 @@ export const METRIC_K8S_CRONJOB_ACTIVE_JOBS = 'k8s.cronjob.active_jobs' as const
  * @note This metric aligns with the `currentNumberScheduled` field of the
  * [K8s DaemonSetStatus](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.30/#daemonsetstatus-v1-apps).
  *
- * This metric **SHOULD**, at a minimum, be reported against a
- * [`k8s.daemonset`](../resource/k8s.md#daemonset) resource.
- *
  * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
  */
 export const METRIC_K8S_DAEMONSET_CURRENT_SCHEDULED_NODES = 'k8s.daemonset.current_scheduled_nodes' as const;
@@ -751,9 +866,6 @@ export const METRIC_K8S_DAEMONSET_CURRENT_SCHEDULED_NODES = 'k8s.daemonset.curre
  * @note This metric aligns with the `desiredNumberScheduled` field of the
  * [K8s DaemonSetStatus](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.30/#daemonsetstatus-v1-apps).
  *
- * This metric **SHOULD**, at a minimum, be reported against a
- * [`k8s.daemonset`](../resource/k8s.md#daemonset) resource.
- *
  * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
  */
 export const METRIC_K8S_DAEMONSET_DESIRED_SCHEDULED_NODES = 'k8s.daemonset.desired_scheduled_nodes' as const;
@@ -764,9 +876,6 @@ export const METRIC_K8S_DAEMONSET_DESIRED_SCHEDULED_NODES = 'k8s.daemonset.desir
  * @note This metric aligns with the `numberMisscheduled` field of the
  * [K8s DaemonSetStatus](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.30/#daemonsetstatus-v1-apps).
  *
- * This metric **SHOULD**, at a minimum, be reported against a
- * [`k8s.daemonset`](../resource/k8s.md#daemonset) resource.
- *
  * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
  */
 export const METRIC_K8S_DAEMONSET_MISSCHEDULED_NODES = 'k8s.daemonset.misscheduled_nodes' as const;
@@ -777,9 +886,6 @@ export const METRIC_K8S_DAEMONSET_MISSCHEDULED_NODES = 'k8s.daemonset.misschedul
  * @note This metric aligns with the `numberReady` field of the
  * [K8s DaemonSetStatus](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.30/#daemonsetstatus-v1-apps).
  *
- * This metric **SHOULD**, at a minimum, be reported against a
- * [`k8s.daemonset`](../resource/k8s.md#daemonset) resource.
- *
  * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
  */
 export const METRIC_K8S_DAEMONSET_READY_NODES = 'k8s.daemonset.ready_nodes' as const;
@@ -790,9 +896,6 @@ export const METRIC_K8S_DAEMONSET_READY_NODES = 'k8s.daemonset.ready_nodes' as c
  * @note This metric aligns with the `availableReplicas` field of the
  * [K8s DeploymentStatus](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.30/#deploymentstatus-v1-apps).
  *
- * This metric **SHOULD**, at a minimum, be reported against a
- * [`k8s.deployment`](../resource/k8s.md#deployment) resource.
- *
  * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
  */
 export const METRIC_K8S_DEPLOYMENT_AVAILABLE_PODS = 'k8s.deployment.available_pods' as const;
@@ -803,9 +906,6 @@ export const METRIC_K8S_DEPLOYMENT_AVAILABLE_PODS = 'k8s.deployment.available_po
  * @note This metric aligns with the `replicas` field of the
  * [K8s DeploymentSpec](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.30/#deploymentspec-v1-apps).
  *
- * This metric **SHOULD**, at a minimum, be reported against a
- * [`k8s.deployment`](../resource/k8s.md#deployment) resource.
- *
  * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
  */
 export const METRIC_K8S_DEPLOYMENT_DESIRED_PODS = 'k8s.deployment.desired_pods' as const;
@@ -816,9 +916,6 @@ export const METRIC_K8S_DEPLOYMENT_DESIRED_PODS = 'k8s.deployment.desired_pods'
  * @note This metric aligns with the `currentReplicas` field of the
  * [K8s HorizontalPodAutoscalerStatus](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.30/#horizontalpodautoscalerstatus-v2-autoscaling)
  *
- * This metric **SHOULD**, at a minimum, be reported against a
- * [`k8s.hpa`](../resource/k8s.md#horizontalpodautoscaler) resource.
- *
  * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
  */
 export const METRIC_K8S_HPA_CURRENT_PODS = 'k8s.hpa.current_pods' as const;
@@ -829,9 +926,6 @@ export const METRIC_K8S_HPA_CURRENT_PODS = 'k8s.hpa.current_pods' as const;
  * @note This metric aligns with the `desiredReplicas` field of the
  * [K8s HorizontalPodAutoscalerStatus](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.30/#horizontalpodautoscalerstatus-v2-autoscaling)
  *
- * This metric **SHOULD**, at a minimum, be reported against a
- * [`k8s.hpa`](../resource/k8s.md#horizontalpodautoscaler) resource.
- *
  * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
  */
 export const METRIC_K8S_HPA_DESIRED_PODS = 'k8s.hpa.desired_pods' as const;
@@ -842,22 +936,52 @@ export const METRIC_K8S_HPA_DESIRED_PODS = 'k8s.hpa.desired_pods' as const;
  * @note This metric aligns with the `maxReplicas` field of the
  * [K8s HorizontalPodAutoscalerSpec](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.30/#horizontalpodautoscalerspec-v2-autoscaling)
  *
- * This metric **SHOULD**, at a minimum, be reported against a
- * [`k8s.hpa`](../resource/k8s.md#horizontalpodautoscaler) resource.
- *
  * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
  */
 export const METRIC_K8S_HPA_MAX_PODS = 'k8s.hpa.max_pods' as const;
 
+/**
+ * Target average utilization, in percentage, for CPU resource in HPA config.
+ *
+ * @note This metric aligns with the `averageUtilization` field of the
+ * [K8s HPA MetricTarget](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.30/#metrictarget-v2-autoscaling).
+ * If the type of the metric is [`ContainerResource`](https://kubernetes.io/docs/tasks/run-application/horizontal-pod-autoscale/#support-for-metrics-apis),
+ * the `k8s.container.name` attribute **MUST** be set to identify the specific container within the pod to which the metric applies.
+ *
+ * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
+ */
+export const METRIC_K8S_HPA_METRIC_TARGET_CPU_AVERAGE_UTILIZATION = 'k8s.hpa.metric.target.cpu.average_utilization' as const;
+
+/**
+ * Target average value for CPU resource in HPA config.
+ *
+ * @note This metric aligns with the `averageValue` field of the
+ * [K8s HPA MetricTarget](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.30/#metrictarget-v2-autoscaling).
+ * If the type of the metric is [`ContainerResource`](https://kubernetes.io/docs/tasks/run-application/horizontal-pod-autoscale/#support-for-metrics-apis),
+ * the `k8s.container.name` attribute **MUST** be set to identify the specific container within the pod to which the metric applies.
+ *
+ * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
+ */
+export const METRIC_K8S_HPA_METRIC_TARGET_CPU_AVERAGE_VALUE = 'k8s.hpa.metric.target.cpu.average_value' as const;
+
+/**
+ * Target value for CPU resource in HPA config.
+ *
+ * @note This metric aligns with the `value` field of the
+ * [K8s HPA MetricTarget](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.30/#metrictarget-v2-autoscaling).
+ * If the type of the metric is [`ContainerResource`](https://kubernetes.io/docs/tasks/run-application/horizontal-pod-autoscale/#support-for-metrics-apis),
+ * the `k8s.container.name` attribute **MUST** be set to identify the specific container within the pod to which the metric applies.
+ *
+ * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
+ */
+export const METRIC_K8S_HPA_METRIC_TARGET_CPU_VALUE = 'k8s.hpa.metric.target.cpu.value' as const;
+
 /**
  * The lower limit for the number of replica pods to which the autoscaler can scale down
  *
  * @note This metric aligns with the `minReplicas` field of the
  * [K8s HorizontalPodAutoscalerSpec](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.30/#horizontalpodautoscalerspec-v2-autoscaling)
  *
- * This metric **SHOULD**, at a minimum, be reported against a
- * [`k8s.hpa`](../resource/k8s.md#horizontalpodautoscaler) resource.
- *
  * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
  */
 export const METRIC_K8S_HPA_MIN_PODS = 'k8s.hpa.min_pods' as const;
@@ -868,9 +992,6 @@ export const METRIC_K8S_HPA_MIN_PODS = 'k8s.hpa.min_pods' as const;
  * @note This metric aligns with the `active` field of the
  * [K8s JobStatus](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.30/#jobstatus-v1-batch).
  *
- * This metric **SHOULD**, at a minimum, be reported against a
- * [`k8s.job`](../resource/k8s.md#job) resource.
- *
  * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
  */
 export const METRIC_K8S_JOB_ACTIVE_PODS = 'k8s.job.active_pods' as const;
@@ -879,10 +1000,7 @@ export const METRIC_K8S_JOB_ACTIVE_PODS = 'k8s.job.active_pods' as const;
  * The desired number of successfully finished pods the job should be run with
  *
  * @note This metric aligns with the `completions` field of the
- * [K8s JobSpec](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.30/#jobspec-v1-batch).
- *
- * This metric **SHOULD**, at a minimum, be reported against a
- * [`k8s.job`](../resource/k8s.md#job) resource.
+ * [K8s JobSpec](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.30/#jobspec-v1-batch)..
  *
  * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
  */
@@ -894,9 +1012,6 @@ export const METRIC_K8S_JOB_DESIRED_SUCCESSFUL_PODS = 'k8s.job.desired_successfu
  * @note This metric aligns with the `failed` field of the
  * [K8s JobStatus](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.30/#jobstatus-v1-batch).
  *
- * This metric **SHOULD**, at a minimum, be reported against a
- * [`k8s.job`](../resource/k8s.md#job) resource.
- *
  * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
  */
 export const METRIC_K8S_JOB_FAILED_PODS = 'k8s.job.failed_pods' as const;
@@ -907,9 +1022,6 @@ export const METRIC_K8S_JOB_FAILED_PODS = 'k8s.job.failed_pods' as const;
  * @note This metric aligns with the `parallelism` field of the
  * [K8s JobSpec](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.30/#jobspec-v1-batch).
  *
- * This metric **SHOULD**, at a minimum, be reported against a
- * [`k8s.job`](../resource/k8s.md#job) resource.
- *
  * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
  */
 export const METRIC_K8S_JOB_MAX_PARALLEL_PODS = 'k8s.job.max_parallel_pods' as const;
@@ -920,9 +1032,6 @@ export const METRIC_K8S_JOB_MAX_PARALLEL_PODS = 'k8s.job.max_parallel_pods' as c
  * @note This metric aligns with the `succeeded` field of the
  * [K8s JobStatus](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.30/#jobstatus-v1-batch).
  *
- * This metric **SHOULD**, at a minimum, be reported against a
- * [`k8s.job`](../resource/k8s.md#job) resource.
- *
  * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
  */
 export const METRIC_K8S_JOB_SUCCESSFUL_PODS = 'k8s.job.successful_pods' as const;
@@ -930,13 +1039,47 @@ export const METRIC_K8S_JOB_SUCCESSFUL_PODS = 'k8s.job.successful_pods' as const
 /**
  * Describes number of K8s namespaces that are currently in a given phase.
  *
- * @note This metric **SHOULD**, at a minimum, be reported against a
- * [`k8s.namespace`](../resource/k8s.md#namespace) resource.
- *
  * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
  */
 export const METRIC_K8S_NAMESPACE_PHASE = 'k8s.namespace.phase' as const;
 
+/**
+ * Amount of cpu allocatable on the node
+ *
+ * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
+ */
+export const METRIC_K8S_NODE_ALLOCATABLE_CPU = 'k8s.node.allocatable.cpu' as const;
+
+/**
+ * Amount of ephemeral-storage allocatable on the node
+ *
+ * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
+ */
+export const METRIC_K8S_NODE_ALLOCATABLE_EPHEMERAL_STORAGE = 'k8s.node.allocatable.ephemeral_storage' as const;
+
+/**
+ * Amount of memory allocatable on the node
+ *
+ * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
+ */
+export const METRIC_K8S_NODE_ALLOCATABLE_MEMORY = 'k8s.node.allocatable.memory' as const;
+
+/**
+ * Amount of pods allocatable on the node
+ *
+ * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
+ */
+export const METRIC_K8S_NODE_ALLOCATABLE_PODS = 'k8s.node.allocatable.pods' as const;
+
+/**
+ * Describes the condition of a particular Node.
+ *
+ * @note All possible node condition pairs (type and status) will be reported at each time interval to avoid missing metrics. Condition pairs corresponding to the current conditions' statuses will be non-zero.
+ *
+ * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
+ */
+export const METRIC_K8S_NODE_CONDITION_STATUS = 'k8s.node.condition.status' as const;
+
 /**
  * Total CPU time consumed
  *
@@ -1045,9 +1188,6 @@ export const METRIC_K8S_POD_UPTIME = 'k8s.pod.uptime' as const;
  * @note This metric aligns with the `availableReplicas` field of the
  * [K8s ReplicaSetStatus](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.30/#replicasetstatus-v1-apps).
  *
- * This metric **SHOULD**, at a minimum, be reported against a
- * [`k8s.replicaset`](../resource/k8s.md#replicaset) resource.
- *
  * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
  */
 export const METRIC_K8S_REPLICASET_AVAILABLE_PODS = 'k8s.replicaset.available_pods' as const;
@@ -1058,9 +1198,6 @@ export const METRIC_K8S_REPLICASET_AVAILABLE_PODS = 'k8s.replicaset.available_po
  * @note This metric aligns with the `replicas` field of the
  * [K8s ReplicaSetSpec](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.30/#replicasetspec-v1-apps).
  *
- * This metric **SHOULD**, at a minimum, be reported against a
- * [`k8s.replicaset`](../resource/k8s.md#replicaset) resource.
- *
  * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
  */
 export const METRIC_K8S_REPLICASET_DESIRED_PODS = 'k8s.replicaset.desired_pods' as const;
@@ -1089,9 +1226,6 @@ export const METRIC_K8S_REPLICATION_CONTROLLER_DESIRED_PODS = 'k8s.replication_c
  * @note This metric aligns with the `availableReplicas` field of the
  * [K8s ReplicationControllerStatus](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.30/#replicationcontrollerstatus-v1-core)
  *
- * This metric **SHOULD**, at a minimum, be reported against a
- * [`k8s.replicationcontroller`](../resource/k8s.md#replicationcontroller) resource.
- *
  * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
  */
 export const METRIC_K8S_REPLICATIONCONTROLLER_AVAILABLE_PODS = 'k8s.replicationcontroller.available_pods' as const;
@@ -1102,22 +1236,248 @@ export const METRIC_K8S_REPLICATIONCONTROLLER_AVAILABLE_PODS = 'k8s.replicationc
  * @note This metric aligns with the `replicas` field of the
  * [K8s ReplicationControllerSpec](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.30/#replicationcontrollerspec-v1-core)
  *
- * This metric **SHOULD**, at a minimum, be reported against a
- * [`k8s.replicationcontroller`](../resource/k8s.md#replicationcontroller) resource.
- *
  * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
  */
 export const METRIC_K8S_REPLICATIONCONTROLLER_DESIRED_PODS = 'k8s.replicationcontroller.desired_pods' as const;
 
+/**
+ * The CPU limits in a specific namespace.
+ * The value represents the configured quota limit of the resource in the namespace.
+ *
+ * @note This metric is retrieved from the `hard` field of the
+ * [K8s ResourceQuotaStatus](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.32/#resourcequotastatus-v1-core).
+ *
+ * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
+ */
+export const METRIC_K8S_RESOURCEQUOTA_CPU_LIMIT_HARD = 'k8s.resourcequota.cpu.limit.hard' as const;
+
+/**
+ * The CPU limits in a specific namespace.
+ * The value represents the current observed total usage of the resource in the namespace.
+ *
+ * @note This metric is retrieved from the `used` field of the
+ * [K8s ResourceQuotaStatus](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.32/#resourcequotastatus-v1-core).
+ *
+ * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
+ */
+export const METRIC_K8S_RESOURCEQUOTA_CPU_LIMIT_USED = 'k8s.resourcequota.cpu.limit.used' as const;
+
+/**
+ * The CPU requests in a specific namespace.
+ * The value represents the configured quota limit of the resource in the namespace.
+ *
+ * @note This metric is retrieved from the `hard` field of the
+ * [K8s ResourceQuotaStatus](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.32/#resourcequotastatus-v1-core).
+ *
+ * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
+ */
+export const METRIC_K8S_RESOURCEQUOTA_CPU_REQUEST_HARD = 'k8s.resourcequota.cpu.request.hard' as const;
+
+/**
+ * The CPU requests in a specific namespace.
+ * The value represents the current observed total usage of the resource in the namespace.
+ *
+ * @note This metric is retrieved from the `used` field of the
+ * [K8s ResourceQuotaStatus](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.32/#resourcequotastatus-v1-core).
+ *
+ * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
+ */
+export const METRIC_K8S_RESOURCEQUOTA_CPU_REQUEST_USED = 'k8s.resourcequota.cpu.request.used' as const;
+
+/**
+ * The sum of local ephemeral storage limits in the namespace.
+ * The value represents the configured quota limit of the resource in the namespace.
+ *
+ * @note This metric is retrieved from the `hard` field of the
+ * [K8s ResourceQuotaStatus](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.32/#resourcequotastatus-v1-core).
+ *
+ * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
+ */
+export const METRIC_K8S_RESOURCEQUOTA_EPHEMERAL_STORAGE_LIMIT_HARD = 'k8s.resourcequota.ephemeral_storage.limit.hard' as const;
+
+/**
+ * The sum of local ephemeral storage limits in the namespace.
+ * The value represents the current observed total usage of the resource in the namespace.
+ *
+ * @note This metric is retrieved from the `used` field of the
+ * [K8s ResourceQuotaStatus](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.32/#resourcequotastatus-v1-core).
+ *
+ * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
+ */
+export const METRIC_K8S_RESOURCEQUOTA_EPHEMERAL_STORAGE_LIMIT_USED = 'k8s.resourcequota.ephemeral_storage.limit.used' as const;
+
+/**
+ * The sum of local ephemeral storage requests in the namespace.
+ * The value represents the configured quota limit of the resource in the namespace.
+ *
+ * @note This metric is retrieved from the `hard` field of the
+ * [K8s ResourceQuotaStatus](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.32/#resourcequotastatus-v1-core).
+ *
+ * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
+ */
+export const METRIC_K8S_RESOURCEQUOTA_EPHEMERAL_STORAGE_REQUEST_HARD = 'k8s.resourcequota.ephemeral_storage.request.hard' as const;
+
+/**
+ * The sum of local ephemeral storage requests in the namespace.
+ * The value represents the current observed total usage of the resource in the namespace.
+ *
+ * @note This metric is retrieved from the `used` field of the
+ * [K8s ResourceQuotaStatus](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.32/#resourcequotastatus-v1-core).
+ *
+ * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
+ */
+export const METRIC_K8S_RESOURCEQUOTA_EPHEMERAL_STORAGE_REQUEST_USED = 'k8s.resourcequota.ephemeral_storage.request.used' as const;
+
+/**
+ * The huge page requests in a specific namespace.
+ * The value represents the configured quota limit of the resource in the namespace.
+ *
+ * @note This metric is retrieved from the `hard` field of the
+ * [K8s ResourceQuotaStatus](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.32/#resourcequotastatus-v1-core).
+ *
+ * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
+ */
+export const METRIC_K8S_RESOURCEQUOTA_HUGEPAGE_COUNT_REQUEST_HARD = 'k8s.resourcequota.hugepage_count.request.hard' as const;
+
+/**
+ * The huge page requests in a specific namespace.
+ * The value represents the current observed total usage of the resource in the namespace.
+ *
+ * @note This metric is retrieved from the `used` field of the
+ * [K8s ResourceQuotaStatus](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.32/#resourcequotastatus-v1-core).
+ *
+ * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
+ */
+export const METRIC_K8S_RESOURCEQUOTA_HUGEPAGE_COUNT_REQUEST_USED = 'k8s.resourcequota.hugepage_count.request.used' as const;
+
+/**
+ * The memory limits in a specific namespace.
+ * The value represents the configured quota limit of the resource in the namespace.
+ *
+ * @note This metric is retrieved from the `hard` field of the
+ * [K8s ResourceQuotaStatus](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.32/#resourcequotastatus-v1-core).
+ *
+ * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
+ */
+export const METRIC_K8S_RESOURCEQUOTA_MEMORY_LIMIT_HARD = 'k8s.resourcequota.memory.limit.hard' as const;
+
+/**
+ * The memory limits in a specific namespace.
+ * The value represents the current observed total usage of the resource in the namespace.
+ *
+ * @note This metric is retrieved from the `used` field of the
+ * [K8s ResourceQuotaStatus](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.32/#resourcequotastatus-v1-core).
+ *
+ * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
+ */
+export const METRIC_K8S_RESOURCEQUOTA_MEMORY_LIMIT_USED = 'k8s.resourcequota.memory.limit.used' as const;
+
+/**
+ * The memory requests in a specific namespace.
+ * The value represents the configured quota limit of the resource in the namespace.
+ *
+ * @note This metric is retrieved from the `hard` field of the
+ * [K8s ResourceQuotaStatus](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.32/#resourcequotastatus-v1-core).
+ *
+ * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
+ */
+export const METRIC_K8S_RESOURCEQUOTA_MEMORY_REQUEST_HARD = 'k8s.resourcequota.memory.request.hard' as const;
+
+/**
+ * The memory requests in a specific namespace.
+ * The value represents the current observed total usage of the resource in the namespace.
+ *
+ * @note This metric is retrieved from the `used` field of the
+ * [K8s ResourceQuotaStatus](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.32/#resourcequotastatus-v1-core).
+ *
+ * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
+ */
+export const METRIC_K8S_RESOURCEQUOTA_MEMORY_REQUEST_USED = 'k8s.resourcequota.memory.request.used' as const;
+
+/**
+ * The object count limits in a specific namespace.
+ * The value represents the configured quota limit of the resource in the namespace.
+ *
+ * @note This metric is retrieved from the `hard` field of the
+ * [K8s ResourceQuotaStatus](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.32/#resourcequotastatus-v1-core).
+ *
+ * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
+ */
+export const METRIC_K8S_RESOURCEQUOTA_OBJECT_COUNT_HARD = 'k8s.resourcequota.object_count.hard' as const;
+
+/**
+ * The object count limits in a specific namespace.
+ * The value represents the current observed total usage of the resource in the namespace.
+ *
+ * @note This metric is retrieved from the `used` field of the
+ * [K8s ResourceQuotaStatus](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.32/#resourcequotastatus-v1-core).
+ *
+ * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
+ */
+export const METRIC_K8S_RESOURCEQUOTA_OBJECT_COUNT_USED = 'k8s.resourcequota.object_count.used' as const;
+
+/**
+ * The total number of PersistentVolumeClaims that can exist in the namespace.
+ * The value represents the configured quota limit of the resource in the namespace.
+ *
+ * @note This metric is retrieved from the `hard` field of the
+ * [K8s ResourceQuotaStatus](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.32/#resourcequotastatus-v1-core).
+ *
+ * The `k8s.storageclass.name` should be required when a resource quota is defined for a specific
+ * storage class.
+ *
+ * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
+ */
+export const METRIC_K8S_RESOURCEQUOTA_PERSISTENTVOLUMECLAIM_COUNT_HARD = 'k8s.resourcequota.persistentvolumeclaim_count.hard' as const;
+
+/**
+ * The total number of PersistentVolumeClaims that can exist in the namespace.
+ * The value represents the current observed total usage of the resource in the namespace.
+ *
+ * @note This metric is retrieved from the `used` field of the
+ * [K8s ResourceQuotaStatus](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.32/#resourcequotastatus-v1-core).
+ *
+ * The `k8s.storageclass.name` should be required when a resource quota is defined for a specific
+ * storage class.
+ *
+ * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
+ */
+export const METRIC_K8S_RESOURCEQUOTA_PERSISTENTVOLUMECLAIM_COUNT_USED = 'k8s.resourcequota.persistentvolumeclaim_count.used' as const;
+
+/**
+ * The storage requests in a specific namespace.
+ * The value represents the configured quota limit of the resource in the namespace.
+ *
+ * @note This metric is retrieved from the `hard` field of the
+ * [K8s ResourceQuotaStatus](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.32/#resourcequotastatus-v1-core).
+ *
+ * The `k8s.storageclass.name` should be required when a resource quota is defined for a specific
+ * storage class.
+ *
+ * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
+ */
+export const METRIC_K8S_RESOURCEQUOTA_STORAGE_REQUEST_HARD = 'k8s.resourcequota.storage.request.hard' as const;
+
+/**
+ * The storage requests in a specific namespace.
+ * The value represents the current observed total usage of the resource in the namespace.
+ *
+ * @note This metric is retrieved from the `used` field of the
+ * [K8s ResourceQuotaStatus](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.32/#resourcequotastatus-v1-core).
+ *
+ * The `k8s.storageclass.name` should be required when a resource quota is defined for a specific
+ * storage class.
+ *
+ * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
+ */
+export const METRIC_K8S_RESOURCEQUOTA_STORAGE_REQUEST_USED = 'k8s.resourcequota.storage.request.used' as const;
+
 /**
  * The number of replica pods created by the statefulset controller from the statefulset version indicated by currentRevision
  *
  * @note This metric aligns with the `currentReplicas` field of the
  * [K8s StatefulSetStatus](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.30/#statefulsetstatus-v1-apps).
  *
- * This metric **SHOULD**, at a minimum, be reported against a
- * [`k8s.statefulset`](../resource/k8s.md#statefulset) resource.
- *
  * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
  */
 export const METRIC_K8S_STATEFULSET_CURRENT_PODS = 'k8s.statefulset.current_pods' as const;
@@ -1128,9 +1488,6 @@ export const METRIC_K8S_STATEFULSET_CURRENT_PODS = 'k8s.statefulset.current_pods
  * @note This metric aligns with the `replicas` field of the
  * [K8s StatefulSetSpec](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.30/#statefulsetspec-v1-apps).
  *
- * This metric **SHOULD**, at a minimum, be reported against a
- * [`k8s.statefulset`](../resource/k8s.md#statefulset) resource.
- *
  * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
  */
 export const METRIC_K8S_STATEFULSET_DESIRED_PODS = 'k8s.statefulset.desired_pods' as const;
@@ -1141,9 +1498,6 @@ export const METRIC_K8S_STATEFULSET_DESIRED_PODS = 'k8s.statefulset.desired_pods
  * @note This metric aligns with the `readyReplicas` field of the
  * [K8s StatefulSetStatus](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.30/#statefulsetstatus-v1-apps).
  *
- * This metric **SHOULD**, at a minimum, be reported against a
- * [`k8s.statefulset`](../resource/k8s.md#statefulset) resource.
- *
  * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
  */
 export const METRIC_K8S_STATEFULSET_READY_PODS = 'k8s.statefulset.ready_pods' as const;
@@ -1154,9 +1508,6 @@ export const METRIC_K8S_STATEFULSET_READY_PODS = 'k8s.statefulset.ready_pods' as
  * @note This metric aligns with the `updatedReplicas` field of the
  * [K8s StatefulSetStatus](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.30/#statefulsetstatus-v1-apps).
  *
- * This metric **SHOULD**, at a minimum, be reported against a
- * [`k8s.statefulset`](../resource/k8s.md#statefulset) resource.
- *
  * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
  */
 export const METRIC_K8S_STATEFULSET_UPDATED_PODS = 'k8s.statefulset.updated_pods' as const;
@@ -1506,29 +1857,25 @@ export const METRIC_OTEL_SDK_PROCESSOR_SPAN_QUEUE_CAPACITY = 'otel.sdk.processor
 export const METRIC_OTEL_SDK_PROCESSOR_SPAN_QUEUE_SIZE = 'otel.sdk.processor.span.queue.size' as const;
 
 /**
- * The number of created spans for which the end operation was called
- *
- * @note For spans with `recording=true`: Implementations **MUST** record both `otel.sdk.span.live` and `otel.sdk.span.ended`.
- * For spans with `recording=false`: If implementations decide to record this metric, they **MUST** also record `otel.sdk.span.live`.
+ * Use `otel.sdk.span.started` minus `otel.sdk.span.live` to derive this value.
  *
  * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
+ *
+ * @deprecated Obsoleted.
  */
 export const METRIC_OTEL_SDK_SPAN_ENDED = 'otel.sdk.span.ended' as const;
 
 /**
- * Deprecated, use `otel.sdk.span.ended` instead.
+ * Use `otel.sdk.span.started` minus `otel.sdk.span.live` to derive this value.
  *
  * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
  *
- * @deprecated Replaced by `otel.sdk.span.ended`.
+ * @deprecated Obsoleted.
  */
 export const METRIC_OTEL_SDK_SPAN_ENDED_COUNT = 'otel.sdk.span.ended.count' as const;
 
 /**
- * The number of created spans for which the end operation has not been called yet
- *
- * @note For spans with `recording=true`: Implementations **MUST** record both `otel.sdk.span.live` and `otel.sdk.span.ended`.
- * For spans with `recording=false`: If implementations decide to record this metric, they **MUST** also record `otel.sdk.span.ended`.
+ * The number of created spans with `recording=true` for which the end operation has not been called yet
  *
  * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
  */
@@ -1543,6 +1890,15 @@ export const METRIC_OTEL_SDK_SPAN_LIVE = 'otel.sdk.span.live' as const;
  */
 export const METRIC_OTEL_SDK_SPAN_LIVE_COUNT = 'otel.sdk.span.live.count' as const;
 
+/**
+ * The number of created spans
+ *
+ * @note Implementations **MUST** record this metric for all spans, even for non-recording ones.
+ *
+ * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
+ */
+export const METRIC_OTEL_SDK_SPAN_STARTED = 'otel.sdk.span.started' as const;
+
 /**
  * Number of times the process has been context switched.
  *
@@ -1728,11 +2084,9 @@ export const METRIC_RPC_SERVER_RESPONSE_SIZE = 'rpc.server.response.size' as con
 export const METRIC_RPC_SERVER_RESPONSES_PER_RPC = 'rpc.server.responses_per_rpc' as const;
 
 /**
- * Deprecated. Use `cpu.frequency` instead.
+ * Operating frequency of the logical CPU in Hertz.
  *
  * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
- *
- * @deprecated Replaced by `cpu.frequency`.
  */
 export const METRIC_SYSTEM_CPU_FREQUENCY = 'system.cpu.frequency' as const;
 
@@ -1753,20 +2107,16 @@ export const METRIC_SYSTEM_CPU_LOGICAL_COUNT = 'system.cpu.logical.count' as con
 export const METRIC_SYSTEM_CPU_PHYSICAL_COUNT = 'system.cpu.physical.count' as const;
 
 /**
- * Deprecated. Use `cpu.time` instead.
+ * Seconds each logical CPU spent on each mode
  *
  * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
- *
- * @deprecated Replaced by `cpu.time`.
  */
 export const METRIC_SYSTEM_CPU_TIME = 'system.cpu.time' as const;
 
 /**
- * Deprecated. Use `cpu.utilization` instead.
+ * For each logical CPU, the utilization is calculated as the change in cumulative CPU time (cpu.time) over a measurement interval, divided by the elapsed time.
  *
  * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
- *
- * @deprecated Replaced by `cpu.utilization`.
  */
 export const METRIC_SYSTEM_CPU_UTILIZATION = 'system.cpu.utilization' as const;
 
@@ -1901,6 +2251,15 @@ export const METRIC_SYSTEM_MEMORY_UTILIZATION = 'system.memory.utilization' as c
 /**
  * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
  */
+export const METRIC_SYSTEM_NETWORK_CONNECTION_COUNT = 'system.network.connection.count' as const;
+
+/**
+ * Deprecated, use `system.network.connection.count` instead
+ *
+ * @experimental This metric is experimental and is subject to breaking changes in minor releases of `@opentelemetry/semantic-conventions`.
+ *
+ * @deprecated Replaced by `system.network.connection.count`.
+ */
 export const METRIC_SYSTEM_NETWORK_CONNECTIONS = 'system.network.connections' as const;
 
 /**

semantic-conventions/src/stable_attributes.ts

@@ -28,21 +28,29 @@ export const ATTR_ASPNETCORE_DIAGNOSTICS_EXCEPTION_RESULT = 'aspnetcore.diagnost
 
 /**
  * Enum value "aborted" for attribute {@link ATTR_ASPNETCORE_DIAGNOSTICS_EXCEPTION_RESULT}.
+ *
+ * Exception handling didn't run because the request was aborted.
  */
 export const ASPNETCORE_DIAGNOSTICS_EXCEPTION_RESULT_VALUE_ABORTED = "aborted" as const;
 
 /**
  * Enum value "handled" for attribute {@link ATTR_ASPNETCORE_DIAGNOSTICS_EXCEPTION_RESULT}.
+ *
+ * Exception was handled by the exception handling middleware.
  */
 export const ASPNETCORE_DIAGNOSTICS_EXCEPTION_RESULT_VALUE_HANDLED = "handled" as const;
 
 /**
  * Enum value "skipped" for attribute {@link ATTR_ASPNETCORE_DIAGNOSTICS_EXCEPTION_RESULT}.
+ *
+ * Exception handling was skipped because the response had started.
  */
 export const ASPNETCORE_DIAGNOSTICS_EXCEPTION_RESULT_VALUE_SKIPPED = "skipped" as const;
 
 /**
  * Enum value "unhandled" for attribute {@link ATTR_ASPNETCORE_DIAGNOSTICS_EXCEPTION_RESULT}.
+ *
+ * Exception was not handled by the exception handling middleware.
  */
 export const ASPNETCORE_DIAGNOSTICS_EXCEPTION_RESULT_VALUE_UNHANDLED = "unhandled" as const;
 
@@ -72,21 +80,29 @@ export const ATTR_ASPNETCORE_RATE_LIMITING_RESULT = 'aspnetcore.rate_limiting.re
 
 /**
  * Enum value "acquired" for attribute {@link ATTR_ASPNETCORE_RATE_LIMITING_RESULT}.
+ *
+ * Lease was acquired
  */
 export const ASPNETCORE_RATE_LIMITING_RESULT_VALUE_ACQUIRED = "acquired" as const;
 
 /**
  * Enum value "endpoint_limiter" for attribute {@link ATTR_ASPNETCORE_RATE_LIMITING_RESULT}.
+ *
+ * Lease request was rejected by the endpoint limiter
  */
 export const ASPNETCORE_RATE_LIMITING_RESULT_VALUE_ENDPOINT_LIMITER = "endpoint_limiter" as const;
 
 /**
  * Enum value "global_limiter" for attribute {@link ATTR_ASPNETCORE_RATE_LIMITING_RESULT}.
+ *
+ * Lease request was rejected by the global limiter
  */
 export const ASPNETCORE_RATE_LIMITING_RESULT_VALUE_GLOBAL_LIMITER = "global_limiter" as const;
 
 /**
  * Enum value "request_canceled" for attribute {@link ATTR_ASPNETCORE_RATE_LIMITING_RESULT}.
+ *
+ * Lease request was canceled
  */
 export const ASPNETCORE_RATE_LIMITING_RESULT_VALUE_REQUEST_CANCELED = "request_canceled" as const;
 
@@ -114,11 +130,15 @@ export const ATTR_ASPNETCORE_ROUTING_MATCH_STATUS = 'aspnetcore.routing.match_st
 
 /**
  * Enum value "failure" for attribute {@link ATTR_ASPNETCORE_ROUTING_MATCH_STATUS}.
+ *
+ * Match failed
  */
 export const ASPNETCORE_ROUTING_MATCH_STATUS_VALUE_FAILURE = "failure" as const;
 
 /**
  * Enum value "success" for attribute {@link ATTR_ASPNETCORE_ROUTING_MATCH_STATUS}.
+ *
+ * Match succeeded
  */
 export const ASPNETCORE_ROUTING_MATCH_STATUS_VALUE_SUCCESS = "success" as const;
 
@@ -326,21 +346,29 @@ export const ATTR_DB_SYSTEM_NAME = 'db.system.name' as const;
 
 /**
  * Enum value "mariadb" for attribute {@link ATTR_DB_SYSTEM_NAME}.
+ *
+ * [MariaDB](https://mariadb.org/)
  */
 export const DB_SYSTEM_NAME_VALUE_MARIADB = "mariadb" as const;
 
 /**
  * Enum value "microsoft.sql_server" for attribute {@link ATTR_DB_SYSTEM_NAME}.
+ *
+ * [Microsoft SQL Server](https://www.microsoft.com/sql-server)
  */
 export const DB_SYSTEM_NAME_VALUE_MICROSOFT_SQL_SERVER = "microsoft.sql_server" as const;
 
 /**
  * Enum value "mysql" for attribute {@link ATTR_DB_SYSTEM_NAME}.
+ *
+ * [MySQL](https://www.mysql.com/)
  */
 export const DB_SYSTEM_NAME_VALUE_MYSQL = "mysql" as const;
 
 /**
  * Enum value "postgresql" for attribute {@link ATTR_DB_SYSTEM_NAME}.
+ *
+ * [PostgreSQL](https://www.postgresql.org/)
  */
 export const DB_SYSTEM_NAME_VALUE_POSTGRESQL = "postgresql" as const;
 
@@ -355,26 +383,36 @@ export const ATTR_DOTNET_GC_HEAP_GENERATION = 'dotnet.gc.heap.generation' as con
 
 /**
  * Enum value "gen0" for attribute {@link ATTR_DOTNET_GC_HEAP_GENERATION}.
+ *
+ * Generation 0
  */
 export const DOTNET_GC_HEAP_GENERATION_VALUE_GEN0 = "gen0" as const;
 
 /**
  * Enum value "gen1" for attribute {@link ATTR_DOTNET_GC_HEAP_GENERATION}.
+ *
+ * Generation 1
  */
 export const DOTNET_GC_HEAP_GENERATION_VALUE_GEN1 = "gen1" as const;
 
 /**
  * Enum value "gen2" for attribute {@link ATTR_DOTNET_GC_HEAP_GENERATION}.
+ *
+ * Generation 2
  */
 export const DOTNET_GC_HEAP_GENERATION_VALUE_GEN2 = "gen2" as const;
 
 /**
  * Enum value "loh" for attribute {@link ATTR_DOTNET_GC_HEAP_GENERATION}.
+ *
+ * Large Object Heap
  */
 export const DOTNET_GC_HEAP_GENERATION_VALUE_LOH = "loh" as const;
 
 /**
  * Enum value "poh" for attribute {@link ATTR_DOTNET_GC_HEAP_GENERATION}.
+ *
+ * Pinned Object Heap
  */
 export const DOTNET_GC_HEAP_GENERATION_VALUE_POH = "poh" as const;
 
@@ -410,6 +448,8 @@ export const ATTR_ERROR_TYPE = 'error.type' as const;
 
 /**
  * Enum value "_OTHER" for attribute {@link ATTR_ERROR_TYPE}.
+ *
+ * A fallback error value to be used when the instrumentation doesn't define a custom value.
  */
 export const ERROR_TYPE_VALUE_OTHER = "_OTHER" as const;
 
@@ -494,51 +534,71 @@ export const ATTR_HTTP_REQUEST_METHOD = 'http.request.method' as const;
 
 /**
  * Enum value "_OTHER" for attribute {@link ATTR_HTTP_REQUEST_METHOD}.
+ *
+ * Any HTTP method that the instrumentation has no prior knowledge of.
  */
 export const HTTP_REQUEST_METHOD_VALUE_OTHER = "_OTHER" as const;
 
 /**
  * Enum value "CONNECT" for attribute {@link ATTR_HTTP_REQUEST_METHOD}.
+ *
+ * CONNECT method.
  */
 export const HTTP_REQUEST_METHOD_VALUE_CONNECT = "CONNECT" as const;
 
 /**
  * Enum value "DELETE" for attribute {@link ATTR_HTTP_REQUEST_METHOD}.
+ *
+ * DELETE method.
  */
 export const HTTP_REQUEST_METHOD_VALUE_DELETE = "DELETE" as const;
 
 /**
  * Enum value "GET" for attribute {@link ATTR_HTTP_REQUEST_METHOD}.
+ *
+ * GET method.
  */
 export const HTTP_REQUEST_METHOD_VALUE_GET = "GET" as const;
 
 /**
  * Enum value "HEAD" for attribute {@link ATTR_HTTP_REQUEST_METHOD}.
+ *
+ * HEAD method.
  */
 export const HTTP_REQUEST_METHOD_VALUE_HEAD = "HEAD" as const;
 
 /**
  * Enum value "OPTIONS" for attribute {@link ATTR_HTTP_REQUEST_METHOD}.
+ *
+ * OPTIONS method.
  */
 export const HTTP_REQUEST_METHOD_VALUE_OPTIONS = "OPTIONS" as const;
 
 /**
  * Enum value "PATCH" for attribute {@link ATTR_HTTP_REQUEST_METHOD}.
+ *
+ * PATCH method.
  */
 export const HTTP_REQUEST_METHOD_VALUE_PATCH = "PATCH" as const;
 
 /**
  * Enum value "POST" for attribute {@link ATTR_HTTP_REQUEST_METHOD}.
+ *
+ * POST method.
  */
 export const HTTP_REQUEST_METHOD_VALUE_POST = "POST" as const;
 
 /**
  * Enum value "PUT" for attribute {@link ATTR_HTTP_REQUEST_METHOD}.
+ *
+ * PUT method.
  */
 export const HTTP_REQUEST_METHOD_VALUE_PUT = "PUT" as const;
 
 /**
  * Enum value "TRACE" for attribute {@link ATTR_HTTP_REQUEST_METHOD}.
+ *
+ * TRACE method.
  */
 export const HTTP_REQUEST_METHOD_VALUE_TRACE = "TRACE" as const;
 
@@ -643,11 +703,15 @@ export const ATTR_JVM_MEMORY_TYPE = 'jvm.memory.type' as const;
 
 /**
  * Enum value "heap" for attribute {@link ATTR_JVM_MEMORY_TYPE}.
+ *
+ * Heap memory.
  */
 export const JVM_MEMORY_TYPE_VALUE_HEAP = "heap" as const;
 
 /**
  * Enum value "non_heap" for attribute {@link ATTR_JVM_MEMORY_TYPE}.
+ *
+ * Non-heap memory
  */
 export const JVM_MEMORY_TYPE_VALUE_NON_HEAP = "non_heap" as const;
 
@@ -666,31 +730,43 @@ export const ATTR_JVM_THREAD_STATE = 'jvm.thread.state' as const;
 
 /**
  * Enum value "blocked" for attribute {@link ATTR_JVM_THREAD_STATE}.
+ *
+ * A thread that is blocked waiting for a monitor lock is in this state.
  */
 export const JVM_THREAD_STATE_VALUE_BLOCKED = "blocked" as const;
 
 /**
  * Enum value "new" for attribute {@link ATTR_JVM_THREAD_STATE}.
+ *
+ * A thread that has not yet started is in this state.
  */
 export const JVM_THREAD_STATE_VALUE_NEW = "new" as const;
 
 /**
  * Enum value "runnable" for attribute {@link ATTR_JVM_THREAD_STATE}.
+ *
+ * A thread executing in the Java virtual machine is in this state.
  */
 export const JVM_THREAD_STATE_VALUE_RUNNABLE = "runnable" as const;
 
 /**
  * Enum value "terminated" for attribute {@link ATTR_JVM_THREAD_STATE}.
+ *
+ * A thread that has exited is in this state.
  */
 export const JVM_THREAD_STATE_VALUE_TERMINATED = "terminated" as const;
 
 /**
  * Enum value "timed_waiting" for attribute {@link ATTR_JVM_THREAD_STATE}.
+ *
+ * A thread that is waiting for another thread to perform an action for up to a specified waiting time is in this state.
  */
 export const JVM_THREAD_STATE_VALUE_TIMED_WAITING = "timed_waiting" as const;
 
 /**
  * Enum value "waiting" for attribute {@link ATTR_JVM_THREAD_STATE}.
+ *
+ * A thread that is waiting indefinitely for another thread to perform a particular action is in this state.
  */
 export const JVM_THREAD_STATE_VALUE_WAITING = "waiting" as const;
 
@@ -761,26 +837,36 @@ export const ATTR_NETWORK_TRANSPORT = 'network.transport' as const;
 
 /**
  * Enum value "pipe" for attribute {@link ATTR_NETWORK_TRANSPORT}.
+ *
+ * Named or anonymous pipe.
  */
 export const NETWORK_TRANSPORT_VALUE_PIPE = "pipe" as const;
 
 /**
  * Enum value "quic" for attribute {@link ATTR_NETWORK_TRANSPORT}.
+ *
+ * QUIC
  */
 export const NETWORK_TRANSPORT_VALUE_QUIC = "quic" as const;
 
 /**
  * Enum value "tcp" for attribute {@link ATTR_NETWORK_TRANSPORT}.
+ *
+ * TCP
  */
 export const NETWORK_TRANSPORT_VALUE_TCP = "tcp" as const;
 
 /**
  * Enum value "udp" for attribute {@link ATTR_NETWORK_TRANSPORT}.
+ *
+ * UDP
  */
 export const NETWORK_TRANSPORT_VALUE_UDP = "udp" as const;
 
 /**
  * Enum value "unix" for attribute {@link ATTR_NETWORK_TRANSPORT}.
+ *
+ * Unix domain socket
  */
 export const NETWORK_TRANSPORT_VALUE_UNIX = "unix" as const;
 
@@ -796,11 +882,15 @@ export const ATTR_NETWORK_TYPE = 'network.type' as const;
 
 /**
  * Enum value "ipv4" for attribute {@link ATTR_NETWORK_TYPE}.
+ *
+ * IPv4
  */
 export const NETWORK_TYPE_VALUE_IPV4 = "ipv4" as const;
 
 /**
  * Enum value "ipv6" for attribute {@link ATTR_NETWORK_TYPE}.
+ *
+ * IPv6
  */
 export const NETWORK_TYPE_VALUE_IPV6 = "ipv6" as const;
 
@@ -825,11 +915,15 @@ export const ATTR_OTEL_STATUS_CODE = 'otel.status_code' as const;
 
 /**
  * Enum value "ERROR" for attribute {@link ATTR_OTEL_STATUS_CODE}.
+ *
+ * The operation contains an error.
  */
 export const OTEL_STATUS_CODE_VALUE_ERROR = "ERROR" as const;
 
 /**
  * Enum value "OK" for attribute {@link ATTR_OTEL_STATUS_CODE}.
+ *
+ * The operation has been validated by an Application developer or Operator to have completed successfully.
  */
 export const OTEL_STATUS_CODE_VALUE_OK = "OK" as const;
 
@@ -889,16 +983,22 @@ export const ATTR_SIGNALR_CONNECTION_STATUS = 'signalr.connection.status' as con
 
 /**
  * Enum value "app_shutdown" for attribute {@link ATTR_SIGNALR_CONNECTION_STATUS}.
+ *
+ * The connection was closed because the app is shutting down.
  */
 export const SIGNALR_CONNECTION_STATUS_VALUE_APP_SHUTDOWN = "app_shutdown" as const;
 
 /**
  * Enum value "normal_closure" for attribute {@link ATTR_SIGNALR_CONNECTION_STATUS}.
+ *
+ * The connection was closed normally.
  */
 export const SIGNALR_CONNECTION_STATUS_VALUE_NORMAL_CLOSURE = "normal_closure" as const;
 
 /**
  * Enum value "timeout" for attribute {@link ATTR_SIGNALR_CONNECTION_STATUS}.
+ *
+ * The connection was closed due to a timeout.
  */
 export const SIGNALR_CONNECTION_STATUS_VALUE_TIMEOUT = "timeout" as const;
 
@@ -912,16 +1012,22 @@ export const ATTR_SIGNALR_TRANSPORT = 'signalr.transport' as const;
 
 /**
  * Enum value "long_polling" for attribute {@link ATTR_SIGNALR_TRANSPORT}.
+ *
+ * LongPolling protocol
  */
 export const SIGNALR_TRANSPORT_VALUE_LONG_POLLING = "long_polling" as const;
 
 /**
  * Enum value "server_sent_events" for attribute {@link ATTR_SIGNALR_TRANSPORT}.
+ *
+ * ServerSentEvents protocol
  */
 export const SIGNALR_TRANSPORT_VALUE_SERVER_SENT_EVENTS = "server_sent_events" as const;
 
 /**
  * Enum value "web_sockets" for attribute {@link ATTR_SIGNALR_TRANSPORT}.
+ *
+ * WebSockets protocol
  */
 export const SIGNALR_TRANSPORT_VALUE_WEB_SOCKETS = "web_sockets" as const;