diff --git a/.chloggen/promote-disk-io-process-network-io-system-paging-fault-attr-to-RC.yaml b/.chloggen/promote-disk-io-process-network-io-system-paging-fault-attr-to-RC.yaml
new file mode 100644
index 0000000000..2a80957d1c
--- /dev/null
+++ b/.chloggen/promote-disk-io-process-network-io-system-paging-fault-attr-to-RC.yaml
@@ -0,0 +1,25 @@
+# Use this changelog template to create an entry for release notes.
+#
+# If your change doesn't affect end users you should instead start
+# your pull request title with [chore] or use the "Skip Changelog" label.
+
+# One of 'breaking', 'deprecation', 'new_component', 'enhancement', 'bug_fix'
+change_type: enhancement
+
+# The name of the area of concern in the attributes-registry, (e.g. http, cloud, db)
+component: disk, network, system
+
+# A brief description of the change. Surround your text with quotes ("") if it needs to start with a backtick (`).
+note: Promote disk.io.direction, network.io.direction, and system.paging.fault.type attributes to RC
+
+# Mandatory: One or more tracking issues related to the change. You can use the PR number here if no issue exists.
+# The values here must be integers.
+issues: [3796]
+
+# (Optional) One or more lines of additional information to render under the primary note.
+# These lines will be padded with 2 spaces and then inserted directly into the document.
+# Use pipe (|) for multiline entries.
+subtext: |
+ The `network.io.direction` brief was updated based on review feedback to clarify that
+ it describes traffic at the observing interface boundary and is not intended to represent
+ logical connection or network flow direction.
diff --git a/docs/hardware/common.md b/docs/hardware/common.md
index 543c91e708..1d577439e6 100644
--- a/docs/hardware/common.md
+++ b/docs/hardware/common.md
@@ -138,7 +138,7 @@ This metric is [recommended][MetricRecommended].
| [`error.type`](/docs/registry/attributes/error.md) |  | `Conditionally Required` if and only if an error has occurred | string | The type of error encountered by the component. [2] | `uncorrected`; `zero_buffer_credit`; `crc`; `bad_sector` |
| [`hw.name`](/docs/registry/attributes/hardware.md) |  | `Recommended` | string | An easily-recognizable name for the hardware component | `eth0` |
| [`hw.parent`](/docs/registry/attributes/hardware.md) |  | `Recommended` | string | Unique identifier of the parent component (typically the `hw.id` attribute of the enclosure, or disk controller) | `dellStorage_perc_0` |
-| [`network.io.direction`](/docs/registry/attributes/network.md) |  | `Recommended` | string | Direction of network traffic for network errors. [3] | `receive`; `transmit` |
+| [`network.io.direction`](/docs/registry/attributes/network.md) |  | `Recommended` | string | Direction of network traffic for network errors. [3] | `receive`; `transmit` |
**[1] `hw.type`:** Describes the category of the hardware component for which `hw.state` is being reported. For example, `hw.type=temperature` along with `hw.state=degraded` would indicate that the temperature of the hardware component has been reported as `degraded`.
@@ -181,8 +181,8 @@ This metric is [recommended][MetricRecommended].
| Value | Description | Stability |
| --- | --- | --- |
-| `receive` | receive |  |
-| `transmit` | transmit |  |
+| `receive` | receive |  |
+| `transmit` | transmit |  |
diff --git a/docs/hardware/cpu.md b/docs/hardware/cpu.md
index ed4c6e9ed7..5ff603c6cd 100644
--- a/docs/hardware/cpu.md
+++ b/docs/hardware/cpu.md
@@ -71,7 +71,7 @@ When using this metric, the following attributes MUST be set:
| [`error.type`](/docs/registry/attributes/error.md) |  | `Conditionally Required` if and only if an error has occurred | string | The type of error encountered by the component. [2] | `uncorrected`; `zero_buffer_credit`; `crc`; `bad_sector` |
| [`hw.name`](/docs/registry/attributes/hardware.md) |  | `Recommended` | string | An easily-recognizable name for the hardware component | `eth0` |
| [`hw.parent`](/docs/registry/attributes/hardware.md) |  | `Recommended` | string | Unique identifier of the parent component (typically the `hw.id` attribute of the enclosure, or disk controller) | `dellStorage_perc_0` |
-| [`network.io.direction`](/docs/registry/attributes/network.md) |  | `Recommended` | string | Direction of network traffic for network errors. [3] | `receive`; `transmit` |
+| [`network.io.direction`](/docs/registry/attributes/network.md) |  | `Recommended` | string | Direction of network traffic for network errors. [3] | `receive`; `transmit` |
**[1] `hw.type`:** Describes the category of the hardware component for which `hw.state` is being reported. For example, `hw.type=temperature` along with `hw.state=degraded` would indicate that the temperature of the hardware component has been reported as `degraded`.
@@ -114,8 +114,8 @@ When using this metric, the following attributes MUST be set:
| Value | Description | Stability |
| --- | --- | --- |
-| `receive` | receive |  |
-| `transmit` | transmit |  |
+| `receive` | receive |  |
+| `transmit` | transmit |  |
diff --git a/docs/hardware/gpu.md b/docs/hardware/gpu.md
index 95be5e71bc..decd7bd79e 100644
--- a/docs/hardware/gpu.md
+++ b/docs/hardware/gpu.md
@@ -80,7 +80,7 @@ When using this metric, the following attributes MUST be set:
| [`error.type`](/docs/registry/attributes/error.md) |  | `Conditionally Required` if and only if an error has occurred | string | The type of error encountered by the component. [2] | `uncorrected`; `zero_buffer_credit`; `crc`; `bad_sector` |
| [`hw.name`](/docs/registry/attributes/hardware.md) |  | `Recommended` | string | An easily-recognizable name for the hardware component | `eth0` |
| [`hw.parent`](/docs/registry/attributes/hardware.md) |  | `Recommended` | string | Unique identifier of the parent component (typically the `hw.id` attribute of the enclosure, or disk controller) | `dellStorage_perc_0` |
-| [`network.io.direction`](/docs/registry/attributes/network.md) |  | `Recommended` | string | Direction of network traffic for network errors. [3] | `receive`; `transmit` |
+| [`network.io.direction`](/docs/registry/attributes/network.md) |  | `Recommended` | string | Direction of network traffic for network errors. [3] | `receive`; `transmit` |
**[1] `hw.type`:** Describes the category of the hardware component for which `hw.state` is being reported. For example, `hw.type=temperature` along with `hw.state=degraded` would indicate that the temperature of the hardware component has been reported as `degraded`.
@@ -123,8 +123,8 @@ When using this metric, the following attributes MUST be set:
| Value | Description | Stability |
| --- | --- | --- |
-| `receive` | receive |  |
-| `transmit` | transmit |  |
+| `receive` | receive |  |
+| `transmit` | transmit |  |
@@ -148,7 +148,7 @@ This metric is [recommended][MetricRecommended].
| Key | Stability | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Value Type | Description | Example Values |
| --- | --- | --- | --- | --- | --- |
| [`hw.id`](/docs/registry/attributes/hardware.md) |  | `Required` | string | An identifier for the hardware component, unique within the monitored host | `win32battery_battery_testsysa33_1` |
-| [`network.io.direction`](/docs/registry/attributes/network.md) |  | `Required` | string | The network IO operation direction. | `receive`; `transmit` |
+| [`network.io.direction`](/docs/registry/attributes/network.md) |  | `Required` | string | The direction of traffic from the perspective of the observing host's physical or virtual network interface. It should not be used to represent the logical direction of a stateful connection or network flow. | `receive`; `transmit` |
| [`hw.driver_version`](/docs/registry/attributes/hardware.md) |  | `Recommended` | string | Driver version for the hardware component | `10.2.1-3` |
| [`hw.firmware_version`](/docs/registry/attributes/hardware.md) |  | `Recommended` | string | Firmware version of the hardware component | `2.0.1` |
| [`hw.model`](/docs/registry/attributes/hardware.md) |  | `Recommended` | string | Descriptive model name of the hardware component | `PERC H740P`; `Intel(R) Core(TM) i7-10700K`; `Dell XPS 15 Battery` |
@@ -163,8 +163,8 @@ This metric is [recommended][MetricRecommended].
| Value | Description | Stability |
| --- | --- | --- |
-| `receive` | receive |  |
-| `transmit` | transmit |  |
+| `receive` | receive |  |
+| `transmit` | transmit |  |
diff --git a/docs/hardware/logical-disk.md b/docs/hardware/logical-disk.md
index 0007accba0..94276a1cab 100644
--- a/docs/hardware/logical-disk.md
+++ b/docs/hardware/logical-disk.md
@@ -71,7 +71,7 @@ When using this metric, the following attributes MUST be set:
| [`error.type`](/docs/registry/attributes/error.md) |  | `Conditionally Required` if and only if an error has occurred | string | The type of error encountered by the component. [2] | `uncorrected`; `zero_buffer_credit`; `crc`; `bad_sector` |
| [`hw.name`](/docs/registry/attributes/hardware.md) |  | `Recommended` | string | An easily-recognizable name for the hardware component | `eth0` |
| [`hw.parent`](/docs/registry/attributes/hardware.md) |  | `Recommended` | string | Unique identifier of the parent component (typically the `hw.id` attribute of the enclosure, or disk controller) | `dellStorage_perc_0` |
-| [`network.io.direction`](/docs/registry/attributes/network.md) |  | `Recommended` | string | Direction of network traffic for network errors. [3] | `receive`; `transmit` |
+| [`network.io.direction`](/docs/registry/attributes/network.md) |  | `Recommended` | string | Direction of network traffic for network errors. [3] | `receive`; `transmit` |
**[1] `hw.type`:** Describes the category of the hardware component for which `hw.state` is being reported. For example, `hw.type=temperature` along with `hw.state=degraded` would indicate that the temperature of the hardware component has been reported as `degraded`.
@@ -114,8 +114,8 @@ When using this metric, the following attributes MUST be set:
| Value | Description | Stability |
| --- | --- | --- |
-| `receive` | receive |  |
-| `transmit` | transmit |  |
+| `receive` | receive |  |
+| `transmit` | transmit |  |
diff --git a/docs/hardware/memory.md b/docs/hardware/memory.md
index 68f0591714..698eb6f646 100644
--- a/docs/hardware/memory.md
+++ b/docs/hardware/memory.md
@@ -72,7 +72,7 @@ When using this metric, the following attributes MUST be set:
| [`error.type`](/docs/registry/attributes/error.md) |  | `Conditionally Required` if and only if an error has occurred | string | The type of error encountered by the component. [2] | `uncorrected`; `zero_buffer_credit`; `crc`; `bad_sector` |
| [`hw.name`](/docs/registry/attributes/hardware.md) |  | `Recommended` | string | An easily-recognizable name for the hardware component | `eth0` |
| [`hw.parent`](/docs/registry/attributes/hardware.md) |  | `Recommended` | string | Unique identifier of the parent component (typically the `hw.id` attribute of the enclosure, or disk controller) | `dellStorage_perc_0` |
-| [`network.io.direction`](/docs/registry/attributes/network.md) |  | `Recommended` | string | Direction of network traffic for network errors. [3] | `receive`; `transmit` |
+| [`network.io.direction`](/docs/registry/attributes/network.md) |  | `Recommended` | string | Direction of network traffic for network errors. [3] | `receive`; `transmit` |
**[1] `hw.type`:** Describes the category of the hardware component for which `hw.state` is being reported. For example, `hw.type=temperature` along with `hw.state=degraded` would indicate that the temperature of the hardware component has been reported as `degraded`.
@@ -115,8 +115,8 @@ When using this metric, the following attributes MUST be set:
| Value | Description | Stability |
| --- | --- | --- |
-| `receive` | receive |  |
-| `transmit` | transmit |  |
+| `receive` | receive |  |
+| `transmit` | transmit |  |
diff --git a/docs/hardware/network.md b/docs/hardware/network.md
index 52a3a68ddc..672e17206c 100644
--- a/docs/hardware/network.md
+++ b/docs/hardware/network.md
@@ -82,7 +82,7 @@ The following attributes SHOULD be set:
| [`error.type`](/docs/registry/attributes/error.md) |  | `Conditionally Required` if and only if an error has occurred | string | The type of error encountered by the component. [2] | `uncorrected`; `zero_buffer_credit`; `crc`; `bad_sector` |
| [`hw.name`](/docs/registry/attributes/hardware.md) |  | `Recommended` | string | An easily-recognizable name for the hardware component | `eth0` |
| [`hw.parent`](/docs/registry/attributes/hardware.md) |  | `Recommended` | string | Unique identifier of the parent component (typically the `hw.id` attribute of the enclosure, or disk controller) | `dellStorage_perc_0` |
-| [`network.io.direction`](/docs/registry/attributes/network.md) |  | `Recommended` | string | Direction of network traffic for network errors. [3] | `receive`; `transmit` |
+| [`network.io.direction`](/docs/registry/attributes/network.md) |  | `Recommended` | string | Direction of network traffic for network errors. [3] | `receive`; `transmit` |
**[1] `hw.type`:** Describes the category of the hardware component for which `hw.state` is being reported. For example, `hw.type=temperature` along with `hw.state=degraded` would indicate that the temperature of the hardware component has been reported as `degraded`.
@@ -125,8 +125,8 @@ The following attributes SHOULD be set:
| Value | Description | Stability |
| --- | --- | --- |
-| `receive` | receive |  |
-| `transmit` | transmit |  |
+| `receive` | receive |  |
+| `transmit` | transmit |  |
@@ -222,7 +222,7 @@ When using this metric, the following attributes MUST be set:
| Key | Stability | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Value Type | Description | Example Values |
| --- | --- | --- | --- | --- | --- |
| [`hw.id`](/docs/registry/attributes/hardware.md) |  | `Required` | string | An identifier for the hardware component, unique within the monitored host | `win32battery_battery_testsysa33_1` |
-| [`network.io.direction`](/docs/registry/attributes/network.md) |  | `Required` | string | The network IO operation direction. | `receive`; `transmit` |
+| [`network.io.direction`](/docs/registry/attributes/network.md) |  | `Required` | string | The direction of traffic from the perspective of the observing host's physical or virtual network interface. It should not be used to represent the logical direction of a stateful connection or network flow. | `receive`; `transmit` |
| [`hw.model`](/docs/registry/attributes/hardware.md) |  | `Recommended` | string | Descriptive model name of the hardware component | `PERC H740P`; `Intel(R) Core(TM) i7-10700K`; `Dell XPS 15 Battery` |
| [`hw.name`](/docs/registry/attributes/hardware.md) |  | `Recommended` | string | An easily-recognizable name for the hardware component | `eth0` |
| [`hw.network.logical_addresses`](/docs/registry/attributes/hardware.md) |  | `Recommended` | string[] | Logical addresses of the adapter (e.g. IP address, or WWPN) | `["172.16.8.21", "57.11.193.42"]` |
@@ -237,8 +237,8 @@ When using this metric, the following attributes MUST be set:
| Value | Description | Stability |
| --- | --- | --- |
-| `receive` | receive |  |
-| `transmit` | transmit |  |
+| `receive` | receive |  |
+| `transmit` | transmit |  |
@@ -270,7 +270,7 @@ When using this metric, the following attributes MUST be set:
| Key | Stability | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Value Type | Description | Example Values |
| --- | --- | --- | --- | --- | --- |
| [`hw.id`](/docs/registry/attributes/hardware.md) |  | `Required` | string | An identifier for the hardware component, unique within the monitored host | `win32battery_battery_testsysa33_1` |
-| [`network.io.direction`](/docs/registry/attributes/network.md) |  | `Required` | string | The network IO operation direction. | `receive`; `transmit` |
+| [`network.io.direction`](/docs/registry/attributes/network.md) |  | `Required` | string | The direction of traffic from the perspective of the observing host's physical or virtual network interface. It should not be used to represent the logical direction of a stateful connection or network flow. | `receive`; `transmit` |
| [`hw.model`](/docs/registry/attributes/hardware.md) |  | `Recommended` | string | Descriptive model name of the hardware component | `PERC H740P`; `Intel(R) Core(TM) i7-10700K`; `Dell XPS 15 Battery` |
| [`hw.name`](/docs/registry/attributes/hardware.md) |  | `Recommended` | string | An easily-recognizable name for the hardware component | `eth0` |
| [`hw.network.logical_addresses`](/docs/registry/attributes/hardware.md) |  | `Recommended` | string[] | Logical addresses of the adapter (e.g. IP address, or WWPN) | `["172.16.8.21", "57.11.193.42"]` |
@@ -285,8 +285,8 @@ When using this metric, the following attributes MUST be set:
| Value | Description | Stability |
| --- | --- | --- |
-| `receive` | receive |  |
-| `transmit` | transmit |  |
+| `receive` | receive |  |
+| `transmit` | transmit |  |
diff --git a/docs/hardware/physical-disk.md b/docs/hardware/physical-disk.md
index 638763cd1c..201d60615a 100644
--- a/docs/hardware/physical-disk.md
+++ b/docs/hardware/physical-disk.md
@@ -79,7 +79,7 @@ The following attributes SHOULD be set:
| [`error.type`](/docs/registry/attributes/error.md) |  | `Conditionally Required` if and only if an error has occurred | string | The type of error encountered by the component. [2] | `uncorrected`; `zero_buffer_credit`; `crc`; `bad_sector` |
| [`hw.name`](/docs/registry/attributes/hardware.md) |  | `Recommended` | string | An easily-recognizable name for the hardware component | `eth0` |
| [`hw.parent`](/docs/registry/attributes/hardware.md) |  | `Recommended` | string | Unique identifier of the parent component (typically the `hw.id` attribute of the enclosure, or disk controller) | `dellStorage_perc_0` |
-| [`network.io.direction`](/docs/registry/attributes/network.md) |  | `Recommended` | string | Direction of network traffic for network errors. [3] | `receive`; `transmit` |
+| [`network.io.direction`](/docs/registry/attributes/network.md) |  | `Recommended` | string | Direction of network traffic for network errors. [3] | `receive`; `transmit` |
**[1] `hw.type`:** Describes the category of the hardware component for which `hw.state` is being reported. For example, `hw.type=temperature` along with `hw.state=degraded` would indicate that the temperature of the hardware component has been reported as `degraded`.
@@ -122,8 +122,8 @@ The following attributes SHOULD be set:
| Value | Description | Stability |
| --- | --- | --- |
-| `receive` | receive |  |
-| `transmit` | transmit |  |
+| `receive` | receive |  |
+| `transmit` | transmit |  |
diff --git a/docs/hardware/tape-drive.md b/docs/hardware/tape-drive.md
index 70c8811be0..a46e0b3764 100644
--- a/docs/hardware/tape-drive.md
+++ b/docs/hardware/tape-drive.md
@@ -75,7 +75,7 @@ The following attributes SHOULD be set:
| [`error.type`](/docs/registry/attributes/error.md) |  | `Conditionally Required` if and only if an error has occurred | string | The type of error encountered by the component. [2] | `uncorrected`; `zero_buffer_credit`; `crc`; `bad_sector` |
| [`hw.name`](/docs/registry/attributes/hardware.md) |  | `Recommended` | string | An easily-recognizable name for the hardware component | `eth0` |
| [`hw.parent`](/docs/registry/attributes/hardware.md) |  | `Recommended` | string | Unique identifier of the parent component (typically the `hw.id` attribute of the enclosure, or disk controller) | `dellStorage_perc_0` |
-| [`network.io.direction`](/docs/registry/attributes/network.md) |  | `Recommended` | string | Direction of network traffic for network errors. [3] | `receive`; `transmit` |
+| [`network.io.direction`](/docs/registry/attributes/network.md) |  | `Recommended` | string | Direction of network traffic for network errors. [3] | `receive`; `transmit` |
**[1] `hw.type`:** Describes the category of the hardware component for which `hw.state` is being reported. For example, `hw.type=temperature` along with `hw.state=degraded` would indicate that the temperature of the hardware component has been reported as `degraded`.
@@ -118,8 +118,8 @@ The following attributes SHOULD be set:
| Value | Description | Stability |
| --- | --- | --- |
-| `receive` | receive |  |
-| `transmit` | transmit |  |
+| `receive` | receive |  |
+| `transmit` | transmit |  |
diff --git a/docs/nfs/nfs-metrics.md b/docs/nfs/nfs-metrics.md
index c3dc075b62..0c657ed3f5 100644
--- a/docs/nfs/nfs-metrics.md
+++ b/docs/nfs/nfs-metrics.md
@@ -263,7 +263,7 @@ This metric is [recommended][MetricRecommended].
| Key | Stability | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Value Type | Description | Example Values |
| --- | --- | --- | --- | --- | --- |
-| [`network.io.direction`](/docs/registry/attributes/network.md) |  | `Recommended` | string | The network IO operation direction. | `transmit` |
+| [`network.io.direction`](/docs/registry/attributes/network.md) |  | `Recommended` | string | The direction of traffic from the perspective of the observing host's physical or virtual network interface. It should not be used to represent the logical direction of a stateful connection or network flow. | `transmit` |
---
@@ -271,8 +271,8 @@ This metric is [recommended][MetricRecommended].
| Value | Description | Stability |
| --- | --- | --- |
-| `receive` | receive |  |
-| `transmit` | transmit |  |
+| `receive` | receive |  |
+| `transmit` | transmit |  |
diff --git a/docs/registry/attributes/disk.md b/docs/registry/attributes/disk.md
index 06f17f4000..84b7db2bbf 100644
--- a/docs/registry/attributes/disk.md
+++ b/docs/registry/attributes/disk.md
@@ -11,7 +11,7 @@ These attributes may be used for any disk related operation.
| Key | Stability | Value Type | Description | Example Values |
| --- | --- | --- | --- | --- |
-| `disk.io.direction` |  | string | The disk IO operation direction. | `read` |
+| `disk.io.direction` |  | string | The disk IO operation direction. | `read` |
---
@@ -19,5 +19,5 @@ These attributes may be used for any disk related operation.
| Value | Description | Stability |
| --- | --- | --- |
-| `read` | read |  |
-| `write` | write |  |
+| `read` | read |  |
+| `write` | write |  |
diff --git a/docs/registry/attributes/network.md b/docs/registry/attributes/network.md
index 3454564bf9..a8282106cd 100644
--- a/docs/registry/attributes/network.md
+++ b/docs/registry/attributes/network.md
@@ -22,7 +22,7 @@ These attributes may be used for any network related operation.
| `network.connection.subtype` |  | string | This describes more details regarding the connection.type. It may be the type of cell technology connection, but it could be used for describing details about a wifi connection. | `LTE` |
| `network.connection.type` |  | string | The internet connection type. | `wifi` |
| `network.interface.name` |  | string | The network interface name. | `lo`; `eth0` |
-| `network.io.direction` |  | string | The network IO operation direction. | `transmit` |
+| `network.io.direction` |  | string | The direction of traffic from the perspective of the observing host's physical or virtual network interface. It should not be used to represent the logical direction of a stateful connection or network flow. | `transmit` |
| `network.local.address` |  | string | Local address of the network connection - IP address or Unix domain socket name. | `10.1.2.80`; `/tmp/my.sock` |
| `network.local.port` |  | int | Local port number of the network connection. | `65123` |
| `network.peer.address` |  | string | Peer address of the network connection - IP address or Unix domain socket name. | `10.1.2.80`; `/tmp/my.sock` |
@@ -110,8 +110,8 @@ different processes could be listening on TCP port 12345 and UDP port 12345.
| Value | Description | Stability |
| --- | --- | --- |
-| `receive` | receive |  |
-| `transmit` | transmit |  |
+| `receive` | receive |  |
+| `transmit` | transmit |  |
---
diff --git a/docs/registry/attributes/system.md b/docs/registry/attributes/system.md
index 073ef8fe59..8391350529 100644
--- a/docs/registry/attributes/system.md
+++ b/docs/registry/attributes/system.md
@@ -107,7 +107,7 @@ Describes System Memory Paging attributes
| Key | Stability | Value Type | Description | Example Values |
| --- | --- | --- | --- | --- |
| `system.paging.direction` |  | string | The paging access direction | `in` |
-| `system.paging.fault.type` |  | string | The paging fault type | `minor` |
+| `system.paging.fault.type` |  | string | The paging fault type | `minor` |
| `system.paging.state` |  | string | The memory paging state | `free` |
---
@@ -125,8 +125,8 @@ Describes System Memory Paging attributes
| Value | Description | Stability |
| --- | --- | --- |
-| `major` | major |  |
-| `minor` | minor |  |
+| `major` | major |  |
+| `minor` | minor |  |
---
diff --git a/docs/system/container-metrics.md b/docs/system/container-metrics.md
index fdae878d17..651418fc30 100644
--- a/docs/system/container-metrics.md
+++ b/docs/system/container-metrics.md
@@ -239,7 +239,7 @@ In K8s, this metric is derived from the [MemoryStats.PageFaults](https://pkg.go.
| Key | Stability | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Value Type | Description | Example Values |
| --- | --- | --- | --- | --- | --- |
-| [`system.paging.fault.type`](/docs/registry/attributes/system.md) |  | `Recommended` | string | The paging fault type | `minor` |
+| [`system.paging.fault.type`](/docs/registry/attributes/system.md) |  | `Recommended` | string | The paging fault type | `minor` |
---
@@ -247,8 +247,8 @@ In K8s, this metric is derived from the [MemoryStats.PageFaults](https://pkg.go.
| Value | Description | Stability |
| --- | --- | --- |
-| `major` | major |  |
-| `minor` | minor |  |
+| `major` | major |  |
+| `minor` | minor |  |
@@ -273,7 +273,7 @@ This metric is [opt-in][MetricOptIn].
| Key | Stability | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Value Type | Description | Example Values |
| --- | --- | --- | --- | --- | --- |
-| [`disk.io.direction`](/docs/registry/attributes/disk.md) |  | `Recommended` | string | The disk IO operation direction. | `read` |
+| [`disk.io.direction`](/docs/registry/attributes/disk.md) |  | `Recommended` | string | The disk IO operation direction. | `read` |
| [`system.device`](/docs/registry/attributes/system.md) |  | `Recommended` | string | The device identifier | `(identifier)` |
---
@@ -282,8 +282,8 @@ This metric is [opt-in][MetricOptIn].
| Value | Description | Stability |
| --- | --- | --- |
-| `read` | read |  |
-| `write` | write |  |
+| `read` | read |  |
+| `write` | write |  |
@@ -309,7 +309,7 @@ This metric is [opt-in][MetricOptIn].
| Key | Stability | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Value Type | Description | Example Values |
| --- | --- | --- | --- | --- | --- |
| [`network.interface.name`](/docs/registry/attributes/network.md) |  | `Recommended` | string | The network interface name. | `lo`; `eth0` |
-| [`network.io.direction`](/docs/registry/attributes/network.md) |  | `Recommended` | string | The network IO operation direction. | `transmit` |
+| [`network.io.direction`](/docs/registry/attributes/network.md) |  | `Recommended` | string | The direction of traffic from the perspective of the observing host's physical or virtual network interface. It should not be used to represent the logical direction of a stateful connection or network flow. | `transmit` |
---
@@ -317,8 +317,8 @@ This metric is [opt-in][MetricOptIn].
| Value | Description | Stability |
| --- | --- | --- |
-| `receive` | receive |  |
-| `transmit` | transmit |  |
+| `receive` | receive |  |
+| `transmit` | transmit |  |
diff --git a/docs/system/k8s-metrics.md b/docs/system/k8s-metrics.md
index e5ceabf29f..b732e21b01 100644
--- a/docs/system/k8s-metrics.md
+++ b/docs/system/k8s-metrics.md
@@ -391,7 +391,7 @@ This metric is derived from the [MemoryStats.PageFaults](https://pkg.go.dev/k8s.
| Key | Stability | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Value Type | Description | Example Values |
| --- | --- | --- | --- | --- | --- |
-| [`system.paging.fault.type`](/docs/registry/attributes/system.md) |  | `Recommended` | string | The paging fault type | `minor` |
+| [`system.paging.fault.type`](/docs/registry/attributes/system.md) |  | `Recommended` | string | The paging fault type | `minor` |
---
@@ -399,8 +399,8 @@ This metric is derived from the [MemoryStats.PageFaults](https://pkg.go.dev/k8s.
| Value | Description | Stability |
| --- | --- | --- |
-| `major` | major |  |
-| `minor` | minor |  |
+| `major` | major |  |
+| `minor` | minor |  |
@@ -424,7 +424,7 @@ This metric is [recommended][MetricRecommended].
| Key | Stability | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Value Type | Description | Example Values |
| --- | --- | --- | --- | --- | --- |
| [`network.interface.name`](/docs/registry/attributes/network.md) |  | `Recommended` | string | The network interface name. | `lo`; `eth0` |
-| [`network.io.direction`](/docs/registry/attributes/network.md) |  | `Recommended` | string | The network IO operation direction. | `transmit` |
+| [`network.io.direction`](/docs/registry/attributes/network.md) |  | `Recommended` | string | The direction of traffic from the perspective of the observing host's physical or virtual network interface. It should not be used to represent the logical direction of a stateful connection or network flow. | `transmit` |
---
@@ -432,8 +432,8 @@ This metric is [recommended][MetricRecommended].
| Value | Description | Stability |
| --- | --- | --- |
-| `receive` | receive |  |
-| `transmit` | transmit |  |
+| `receive` | receive |  |
+| `transmit` | transmit |  |
@@ -457,7 +457,7 @@ This metric is [recommended][MetricRecommended].
| Key | Stability | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Value Type | Description | Example Values |
| --- | --- | --- | --- | --- | --- |
| [`network.interface.name`](/docs/registry/attributes/network.md) |  | `Recommended` | string | The network interface name. | `lo`; `eth0` |
-| [`network.io.direction`](/docs/registry/attributes/network.md) |  | `Recommended` | string | The network IO operation direction. | `transmit` |
+| [`network.io.direction`](/docs/registry/attributes/network.md) |  | `Recommended` | string | The direction of traffic from the perspective of the observing host's physical or virtual network interface. It should not be used to represent the logical direction of a stateful connection or network flow. | `transmit` |
---
@@ -465,8 +465,8 @@ This metric is [recommended][MetricRecommended].
| Value | Description | Stability |
| --- | --- | --- |
-| `receive` | receive |  |
-| `transmit` | transmit |  |
+| `receive` | receive |  |
+| `transmit` | transmit |  |
@@ -1168,7 +1168,7 @@ This metric is derived from the [MemoryStats.PageFaults](https://pkg.go.dev/k8s.
| Key | Stability | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Value Type | Description | Example Values |
| --- | --- | --- | --- | --- | --- |
-| [`system.paging.fault.type`](/docs/registry/attributes/system.md) |  | `Recommended` | string | The paging fault type | `minor` |
+| [`system.paging.fault.type`](/docs/registry/attributes/system.md) |  | `Recommended` | string | The paging fault type | `minor` |
---
@@ -1176,8 +1176,8 @@ This metric is derived from the [MemoryStats.PageFaults](https://pkg.go.dev/k8s.
| Value | Description | Stability |
| --- | --- | --- |
-| `major` | major |  |
-| `minor` | minor |  |
+| `major` | major |  |
+| `minor` | minor |  |
@@ -1201,7 +1201,7 @@ This metric is [recommended][MetricRecommended].
| Key | Stability | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Value Type | Description | Example Values |
| --- | --- | --- | --- | --- | --- |
| [`network.interface.name`](/docs/registry/attributes/network.md) |  | `Recommended` | string | The network interface name. | `lo`; `eth0` |
-| [`network.io.direction`](/docs/registry/attributes/network.md) |  | `Recommended` | string | The network IO operation direction. | `transmit` |
+| [`network.io.direction`](/docs/registry/attributes/network.md) |  | `Recommended` | string | The direction of traffic from the perspective of the observing host's physical or virtual network interface. It should not be used to represent the logical direction of a stateful connection or network flow. | `transmit` |
---
@@ -1209,8 +1209,8 @@ This metric is [recommended][MetricRecommended].
| Value | Description | Stability |
| --- | --- | --- |
-| `receive` | receive |  |
-| `transmit` | transmit |  |
+| `receive` | receive |  |
+| `transmit` | transmit |  |
@@ -1234,7 +1234,7 @@ This metric is [recommended][MetricRecommended].
| Key | Stability | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Value Type | Description | Example Values |
| --- | --- | --- | --- | --- | --- |
| [`network.interface.name`](/docs/registry/attributes/network.md) |  | `Recommended` | string | The network interface name. | `lo`; `eth0` |
-| [`network.io.direction`](/docs/registry/attributes/network.md) |  | `Recommended` | string | The network IO operation direction. | `transmit` |
+| [`network.io.direction`](/docs/registry/attributes/network.md) |  | `Recommended` | string | The direction of traffic from the perspective of the observing host's physical or virtual network interface. It should not be used to represent the logical direction of a stateful connection or network flow. | `transmit` |
---
@@ -1242,8 +1242,8 @@ This metric is [recommended][MetricRecommended].
| Value | Description | Stability |
| --- | --- | --- |
-| `receive` | receive |  |
-| `transmit` | transmit |  |
+| `receive` | receive |  |
+| `transmit` | transmit |  |
diff --git a/docs/system/process-metrics.md b/docs/system/process-metrics.md
index 54cb5b477e..c3ae9be920 100644
--- a/docs/system/process-metrics.md
+++ b/docs/system/process-metrics.md
@@ -175,7 +175,7 @@ This metric is [recommended][MetricRecommended].
| Key | Stability | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Value Type | Description | Example Values |
| --- | --- | --- | --- | --- | --- |
-| [`disk.io.direction`](/docs/registry/attributes/disk.md) |  | `Required` | string | The disk IO operation direction. | `read` |
+| [`disk.io.direction`](/docs/registry/attributes/disk.md) |  | `Required` | string | The disk IO operation direction. | `read` |
---
@@ -183,8 +183,8 @@ This metric is [recommended][MetricRecommended].
| Value | Description | Stability |
| --- | --- | --- |
-| `read` | read |  |
-| `write` | write |  |
+| `read` | read |  |
+| `write` | write |  |
@@ -207,7 +207,7 @@ This metric is [recommended][MetricRecommended].
| Key | Stability | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Value Type | Description | Example Values |
| --- | --- | --- | --- | --- | --- |
-| [`network.io.direction`](/docs/registry/attributes/network.md) |  | `Required` | string | The network IO operation direction. | `transmit` |
+| [`network.io.direction`](/docs/registry/attributes/network.md) |  | `Required` | string | The direction of traffic from the perspective of the observing host's physical or virtual network interface. It should not be used to represent the logical direction of a stateful connection or network flow. | `transmit` |
---
@@ -215,8 +215,8 @@ This metric is [recommended][MetricRecommended].
| Value | Description | Stability |
| --- | --- | --- |
-| `receive` | receive |  |
-| `transmit` | transmit |  |
+| `receive` | receive |  |
+| `transmit` | transmit |  |
@@ -322,7 +322,7 @@ This metric is [recommended][MetricRecommended].
| Key | Stability | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Value Type | Description | Example Values |
| --- | --- | --- | --- | --- | --- |
-| [`system.paging.fault.type`](/docs/registry/attributes/system.md) |  | `Recommended` | string | The type of paging fault. Value MUST be either `major` or `minor`. If the metric is reported without this attribute, it should be the sum of major and minor page faults. | `minor` |
+| [`system.paging.fault.type`](/docs/registry/attributes/system.md) |  | `Recommended` | string | The type of paging fault. Value MUST be either `major` or `minor`. If the metric is reported without this attribute, it should be the sum of major and minor page faults. | `minor` |
---
@@ -330,8 +330,8 @@ This metric is [recommended][MetricRecommended].
| Value | Description | Stability |
| --- | --- | --- |
-| `major` | major |  |
-| `minor` | minor |  |
+| `major` | major |  |
+| `minor` | minor |  |
diff --git a/docs/system/system-metrics.md b/docs/system/system-metrics.md
index b991b788e8..08082841fa 100644
--- a/docs/system/system-metrics.md
+++ b/docs/system/system-metrics.md
@@ -429,7 +429,7 @@ This metric is [recommended][MetricRecommended].
| Key | Stability | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Value Type | Description | Example Values |
| --- | --- | --- | --- | --- | --- |
-| [`system.paging.fault.type`](/docs/registry/attributes/system.md) |  | `Recommended` | string | The paging fault type | `minor` |
+| [`system.paging.fault.type`](/docs/registry/attributes/system.md) |  | `Recommended` | string | The paging fault type | `minor` |
---
@@ -437,8 +437,8 @@ This metric is [recommended][MetricRecommended].
| Value | Description | Stability |
| --- | --- | --- |
-| `major` | major |  |
-| `minor` | minor |  |
+| `major` | major |  |
+| `minor` | minor |  |
@@ -462,7 +462,7 @@ This metric is [recommended][MetricRecommended].
| Key | Stability | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Value Type | Description | Example Values |
| --- | --- | --- | --- | --- | --- |
| [`system.paging.direction`](/docs/registry/attributes/system.md) |  | `Recommended` | string | The paging access direction | `in` |
-| [`system.paging.fault.type`](/docs/registry/attributes/system.md) |  | `Recommended` | string | The paging fault type | `minor` |
+| [`system.paging.fault.type`](/docs/registry/attributes/system.md) |  | `Recommended` | string | The paging fault type | `minor` |
---
@@ -479,8 +479,8 @@ This metric is [recommended][MetricRecommended].
| Value | Description | Stability |
| --- | --- | --- |
-| `major` | major |  |
-| `minor` | minor |  |
+| `major` | major |  |
+| `minor` | minor |  |
@@ -507,7 +507,7 @@ This metric is [recommended][MetricRecommended].
| Key | Stability | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Value Type | Description | Example Values |
| --- | --- | --- | --- | --- | --- |
-| [`disk.io.direction`](/docs/registry/attributes/disk.md) |  | `Recommended` | string | The disk IO operation direction. | `read` |
+| [`disk.io.direction`](/docs/registry/attributes/disk.md) |  | `Recommended` | string | The disk IO operation direction. | `read` |
| [`system.device`](/docs/registry/attributes/system.md) |  | `Recommended` | string | The device identifier | `(identifier)` |
---
@@ -516,8 +516,8 @@ This metric is [recommended][MetricRecommended].
| Value | Description | Stability |
| --- | --- | --- |
-| `read` | read |  |
-| `write` | write |  |
+| `read` | read |  |
+| `write` | write |  |
@@ -540,7 +540,7 @@ This metric is [recommended][MetricRecommended].
| Key | Stability | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Value Type | Description | Example Values |
| --- | --- | --- | --- | --- | --- |
-| [`disk.io.direction`](/docs/registry/attributes/disk.md) |  | `Recommended` | string | The disk IO operation direction. | `read` |
+| [`disk.io.direction`](/docs/registry/attributes/disk.md) |  | `Recommended` | string | The disk IO operation direction. | `read` |
| [`system.device`](/docs/registry/attributes/system.md) |  | `Recommended` | string | The device identifier | `(identifier)` |
---
@@ -549,8 +549,8 @@ This metric is [recommended][MetricRecommended].
| Value | Description | Stability |
| --- | --- | --- |
-| `read` | read |  |
-| `write` | write |  |
+| `read` | read |  |
+| `write` | write |  |
@@ -608,7 +608,7 @@ This metric is [recommended][MetricRecommended].
| Key | Stability | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Value Type | Description | Example Values |
| --- | --- | --- | --- | --- | --- |
-| [`disk.io.direction`](/docs/registry/attributes/disk.md) |  | `Recommended` | string | The disk IO operation direction. | `read` |
+| [`disk.io.direction`](/docs/registry/attributes/disk.md) |  | `Recommended` | string | The disk IO operation direction. | `read` |
| [`system.device`](/docs/registry/attributes/system.md) |  | `Recommended` | string | The device identifier | `(identifier)` |
---
@@ -617,8 +617,8 @@ This metric is [recommended][MetricRecommended].
| Value | Description | Stability |
| --- | --- | --- |
-| `read` | read |  |
-| `write` | write |  |
+| `read` | read |  |
+| `write` | write |  |
@@ -641,7 +641,7 @@ This metric is [recommended][MetricRecommended].
| Key | Stability | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Value Type | Description | Example Values |
| --- | --- | --- | --- | --- | --- |
-| [`disk.io.direction`](/docs/registry/attributes/disk.md) |  | `Recommended` | string | The disk IO operation direction. | `read` |
+| [`disk.io.direction`](/docs/registry/attributes/disk.md) |  | `Recommended` | string | The disk IO operation direction. | `read` |
| [`system.device`](/docs/registry/attributes/system.md) |  | `Recommended` | string | The device identifier | `(identifier)` |
---
@@ -650,8 +650,8 @@ This metric is [recommended][MetricRecommended].
| Value | Description | Stability |
| --- | --- | --- |
-| `read` | read |  |
-| `write` | write |  |
+| `read` | read |  |
+| `write` | write |  |
@@ -887,7 +887,7 @@ This metric is [recommended][MetricRecommended].
| Key | Stability | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Value Type | Description | Example Values |
| --- | --- | --- | --- | --- | --- |
| [`network.interface.name`](/docs/registry/attributes/network.md) |  | `Recommended` | string | The network interface name. | `lo`; `eth0` |
-| [`network.io.direction`](/docs/registry/attributes/network.md) |  | `Recommended` | string | The network IO operation direction. | `transmit` |
+| [`network.io.direction`](/docs/registry/attributes/network.md) |  | `Recommended` | string | The direction of traffic from the perspective of the observing host's physical or virtual network interface. It should not be used to represent the logical direction of a stateful connection or network flow. | `transmit` |
---
@@ -895,8 +895,8 @@ This metric is [recommended][MetricRecommended].
| Value | Description | Stability |
| --- | --- | --- |
-| `receive` | receive |  |
-| `transmit` | transmit |  |
+| `receive` | receive |  |
+| `transmit` | transmit |  |
@@ -919,7 +919,7 @@ This metric is [recommended][MetricRecommended].
| Key | Stability | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Value Type | Description | Example Values |
| --- | --- | --- | --- | --- | --- |
-| [`network.io.direction`](/docs/registry/attributes/network.md) |  | `Recommended` | string | The network IO operation direction. | `transmit` |
+| [`network.io.direction`](/docs/registry/attributes/network.md) |  | `Recommended` | string | The direction of traffic from the perspective of the observing host's physical or virtual network interface. It should not be used to represent the logical direction of a stateful connection or network flow. | `transmit` |
| [`system.device`](/docs/registry/attributes/system.md) |  | `Recommended` | string | The device identifier | `(identifier)` |
---
@@ -928,8 +928,8 @@ This metric is [recommended][MetricRecommended].
| Value | Description | Stability |
| --- | --- | --- |
-| `receive` | receive |  |
-| `transmit` | transmit |  |
+| `receive` | receive |  |
+| `transmit` | transmit |  |
@@ -959,7 +959,7 @@ This metric is [recommended][MetricRecommended].
| Key | Stability | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Value Type | Description | Example Values |
| --- | --- | --- | --- | --- | --- |
| [`network.interface.name`](/docs/registry/attributes/network.md) |  | `Recommended` | string | The network interface name. | `lo`; `eth0` |
-| [`network.io.direction`](/docs/registry/attributes/network.md) |  | `Recommended` | string | The network IO operation direction. | `transmit` |
+| [`network.io.direction`](/docs/registry/attributes/network.md) |  | `Recommended` | string | The direction of traffic from the perspective of the observing host's physical or virtual network interface. It should not be used to represent the logical direction of a stateful connection or network flow. | `transmit` |
---
@@ -967,8 +967,8 @@ This metric is [recommended][MetricRecommended].
| Value | Description | Stability |
| --- | --- | --- |
-| `receive` | receive |  |
-| `transmit` | transmit |  |
+| `receive` | receive |  |
+| `transmit` | transmit |  |
@@ -992,7 +992,7 @@ This metric is [recommended][MetricRecommended].
| Key | Stability | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Value Type | Description | Example Values |
| --- | --- | --- | --- | --- | --- |
| [`network.interface.name`](/docs/registry/attributes/network.md) |  | `Recommended` | string | The network interface name. | `lo`; `eth0` |
-| [`network.io.direction`](/docs/registry/attributes/network.md) |  | `Recommended` | string | The network IO operation direction. | `transmit` |
+| [`network.io.direction`](/docs/registry/attributes/network.md) |  | `Recommended` | string | The direction of traffic from the perspective of the observing host's physical or virtual network interface. It should not be used to represent the logical direction of a stateful connection or network flow. | `transmit` |
---
@@ -1000,8 +1000,8 @@ This metric is [recommended][MetricRecommended].
| Value | Description | Stability |
| --- | --- | --- |
-| `receive` | receive |  |
-| `transmit` | transmit |  |
+| `receive` | receive |  |
+| `transmit` | transmit |  |
diff --git a/model/disk/registry.yaml b/model/disk/registry.yaml
index b1030ac085..eb4c26b38c 100644
--- a/model/disk/registry.yaml
+++ b/model/disk/registry.yaml
@@ -10,10 +10,10 @@ groups:
members:
- id: read
value: 'read'
- stability: development
+ stability: release_candidate
- id: write
value: 'write'
- stability: development
- stability: development
+ stability: release_candidate
+ stability: release_candidate
brief: "The disk IO operation direction."
examples: ["read"]
diff --git a/model/network/registry.yaml b/model/network/registry.yaml
index b7bef2f560..7fb6e5898f 100644
--- a/model/network/registry.yaml
+++ b/model/network/registry.yaml
@@ -225,12 +225,14 @@ groups:
members:
- id: transmit
value: 'transmit'
- stability: development
+ stability: release_candidate
- id: receive
value: 'receive'
- stability: development
- stability: development
- brief: "The network IO operation direction."
+ stability: release_candidate
+ stability: release_candidate
+ brief: >
+ The direction of traffic from the perspective of the observing host's physical or virtual network interface.
+ It should not be used to represent the logical direction of a stateful connection or network flow.
examples: ["transmit"]
- id: network.interface.name
type: string
diff --git a/model/system/registry.yaml b/model/system/registry.yaml
index a2e4629b05..9037fa7d40 100644
--- a/model/system/registry.yaml
+++ b/model/system/registry.yaml
@@ -94,11 +94,11 @@ groups:
members:
- id: major
value: 'major'
- stability: development
+ stability: release_candidate
- id: minor
value: 'minor'
- stability: development
- stability: development
+ stability: release_candidate
+ stability: release_candidate
brief: "The paging fault type"
examples: ["minor"]
- id: system.paging.direction