From a339bab8f91a292f63a33bf8564777249be6d0d8 Mon Sep 17 00:00:00 2001 From: Donal O'Sullivan Date: Mon, 15 Jun 2026 11:36:31 +0100 Subject: [PATCH 1/2] Promote disk.io.direction, network.io.direction and system.paging.fault.type to RC This work is to enable promoting Process to RC. Promoting Process to RC has been blocked by these attributes being in development while the process metrics that use them being promoted to RC. --- ...ork-io-system-paging-fault-attr-to-RC.yaml | 22 +++++++ docs/hardware/common.md | 6 +- docs/hardware/cpu.md | 6 +- docs/hardware/gpu.md | 12 ++-- docs/hardware/logical-disk.md | 6 +- docs/hardware/memory.md | 6 +- docs/hardware/network.md | 18 +++--- docs/hardware/physical-disk.md | 6 +- docs/hardware/tape-drive.md | 6 +- docs/nfs/nfs-metrics.md | 6 +- docs/registry/attributes/disk.md | 6 +- docs/registry/attributes/network.md | 6 +- docs/registry/attributes/system.md | 6 +- docs/system/container-metrics.md | 18 +++--- docs/system/k8s-metrics.md | 36 +++++------ docs/system/process-metrics.md | 18 +++--- docs/system/system-metrics.md | 60 +++++++++---------- model/disk/registry.yaml | 6 +- model/network/registry.yaml | 6 +- model/system/registry.yaml | 6 +- 20 files changed, 142 insertions(+), 120 deletions(-) create mode 100644 .chloggen/promote-disk-io-process-network-io-system-paging-fault-attr-to-RC.yaml 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..cb28c32106 --- /dev/null +++ b/.chloggen/promote-disk-io-process-network-io-system-paging-fault-attr-to-RC.yaml @@ -0,0 +1,22 @@ +# 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: 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) | ![Stable](https://img.shields.io/badge/-stable-lightgreen) | `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) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | An easily-recognizable name for the hardware component | `eth0` | | [`hw.parent`](/docs/registry/attributes/hardware.md) | ![Development](https://img.shields.io/badge/-development-blue) | `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) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | Direction of network traffic for network errors. [3] | `receive`; `transmit` | +| [`network.io.direction`](/docs/registry/attributes/network.md) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `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 | ![Development](https://img.shields.io/badge/-development-blue) | -| `transmit` | transmit | ![Development](https://img.shields.io/badge/-development-blue) | +| `receive` | receive | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | +| `transmit` | transmit | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | 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) | ![Stable](https://img.shields.io/badge/-stable-lightgreen) | `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) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | An easily-recognizable name for the hardware component | `eth0` | | [`hw.parent`](/docs/registry/attributes/hardware.md) | ![Development](https://img.shields.io/badge/-development-blue) | `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) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | Direction of network traffic for network errors. [3] | `receive`; `transmit` | +| [`network.io.direction`](/docs/registry/attributes/network.md) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `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 | ![Development](https://img.shields.io/badge/-development-blue) | -| `transmit` | transmit | ![Development](https://img.shields.io/badge/-development-blue) | +| `receive` | receive | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | +| `transmit` | transmit | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | diff --git a/docs/hardware/gpu.md b/docs/hardware/gpu.md index 95be5e71bc..09fb4f3689 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) | ![Stable](https://img.shields.io/badge/-stable-lightgreen) | `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) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | An easily-recognizable name for the hardware component | `eth0` | | [`hw.parent`](/docs/registry/attributes/hardware.md) | ![Development](https://img.shields.io/badge/-development-blue) | `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) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | Direction of network traffic for network errors. [3] | `receive`; `transmit` | +| [`network.io.direction`](/docs/registry/attributes/network.md) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `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 | ![Development](https://img.shields.io/badge/-development-blue) | -| `transmit` | transmit | ![Development](https://img.shields.io/badge/-development-blue) | +| `receive` | receive | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | +| `transmit` | transmit | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | @@ -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) | ![Development](https://img.shields.io/badge/-development-blue) | `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) | ![Development](https://img.shields.io/badge/-development-blue) | `Required` | string | The network IO operation direction. | `receive`; `transmit` | +| [`network.io.direction`](/docs/registry/attributes/network.md) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Required` | string | The network IO operation direction. | `receive`; `transmit` | | [`hw.driver_version`](/docs/registry/attributes/hardware.md) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | Driver version for the hardware component | `10.2.1-3` | | [`hw.firmware_version`](/docs/registry/attributes/hardware.md) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | Firmware version of the hardware component | `2.0.1` | | [`hw.model`](/docs/registry/attributes/hardware.md) | ![Development](https://img.shields.io/badge/-development-blue) | `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 | ![Development](https://img.shields.io/badge/-development-blue) | -| `transmit` | transmit | ![Development](https://img.shields.io/badge/-development-blue) | +| `receive` | receive | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | +| `transmit` | transmit | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | 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) | ![Stable](https://img.shields.io/badge/-stable-lightgreen) | `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) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | An easily-recognizable name for the hardware component | `eth0` | | [`hw.parent`](/docs/registry/attributes/hardware.md) | ![Development](https://img.shields.io/badge/-development-blue) | `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) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | Direction of network traffic for network errors. [3] | `receive`; `transmit` | +| [`network.io.direction`](/docs/registry/attributes/network.md) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `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 | ![Development](https://img.shields.io/badge/-development-blue) | -| `transmit` | transmit | ![Development](https://img.shields.io/badge/-development-blue) | +| `receive` | receive | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | +| `transmit` | transmit | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | 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) | ![Stable](https://img.shields.io/badge/-stable-lightgreen) | `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) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | An easily-recognizable name for the hardware component | `eth0` | | [`hw.parent`](/docs/registry/attributes/hardware.md) | ![Development](https://img.shields.io/badge/-development-blue) | `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) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | Direction of network traffic for network errors. [3] | `receive`; `transmit` | +| [`network.io.direction`](/docs/registry/attributes/network.md) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `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 | ![Development](https://img.shields.io/badge/-development-blue) | -| `transmit` | transmit | ![Development](https://img.shields.io/badge/-development-blue) | +| `receive` | receive | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | +| `transmit` | transmit | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | diff --git a/docs/hardware/network.md b/docs/hardware/network.md index 52a3a68ddc..b56a859743 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) | ![Stable](https://img.shields.io/badge/-stable-lightgreen) | `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) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | An easily-recognizable name for the hardware component | `eth0` | | [`hw.parent`](/docs/registry/attributes/hardware.md) | ![Development](https://img.shields.io/badge/-development-blue) | `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) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | Direction of network traffic for network errors. [3] | `receive`; `transmit` | +| [`network.io.direction`](/docs/registry/attributes/network.md) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `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 | ![Development](https://img.shields.io/badge/-development-blue) | -| `transmit` | transmit | ![Development](https://img.shields.io/badge/-development-blue) | +| `receive` | receive | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | +| `transmit` | transmit | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | @@ -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) | ![Development](https://img.shields.io/badge/-development-blue) | `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) | ![Development](https://img.shields.io/badge/-development-blue) | `Required` | string | The network IO operation direction. | `receive`; `transmit` | +| [`network.io.direction`](/docs/registry/attributes/network.md) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Required` | string | The network IO operation direction. | `receive`; `transmit` | | [`hw.model`](/docs/registry/attributes/hardware.md) | ![Development](https://img.shields.io/badge/-development-blue) | `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) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | An easily-recognizable name for the hardware component | `eth0` | | [`hw.network.logical_addresses`](/docs/registry/attributes/hardware.md) | ![Development](https://img.shields.io/badge/-development-blue) | `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 | ![Development](https://img.shields.io/badge/-development-blue) | -| `transmit` | transmit | ![Development](https://img.shields.io/badge/-development-blue) | +| `receive` | receive | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | +| `transmit` | transmit | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | @@ -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) | ![Development](https://img.shields.io/badge/-development-blue) | `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) | ![Development](https://img.shields.io/badge/-development-blue) | `Required` | string | The network IO operation direction. | `receive`; `transmit` | +| [`network.io.direction`](/docs/registry/attributes/network.md) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Required` | string | The network IO operation direction. | `receive`; `transmit` | | [`hw.model`](/docs/registry/attributes/hardware.md) | ![Development](https://img.shields.io/badge/-development-blue) | `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) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | An easily-recognizable name for the hardware component | `eth0` | | [`hw.network.logical_addresses`](/docs/registry/attributes/hardware.md) | ![Development](https://img.shields.io/badge/-development-blue) | `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 | ![Development](https://img.shields.io/badge/-development-blue) | -| `transmit` | transmit | ![Development](https://img.shields.io/badge/-development-blue) | +| `receive` | receive | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | +| `transmit` | transmit | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | 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) | ![Stable](https://img.shields.io/badge/-stable-lightgreen) | `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) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | An easily-recognizable name for the hardware component | `eth0` | | [`hw.parent`](/docs/registry/attributes/hardware.md) | ![Development](https://img.shields.io/badge/-development-blue) | `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) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | Direction of network traffic for network errors. [3] | `receive`; `transmit` | +| [`network.io.direction`](/docs/registry/attributes/network.md) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `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 | ![Development](https://img.shields.io/badge/-development-blue) | -| `transmit` | transmit | ![Development](https://img.shields.io/badge/-development-blue) | +| `receive` | receive | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | +| `transmit` | transmit | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | 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) | ![Stable](https://img.shields.io/badge/-stable-lightgreen) | `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) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | An easily-recognizable name for the hardware component | `eth0` | | [`hw.parent`](/docs/registry/attributes/hardware.md) | ![Development](https://img.shields.io/badge/-development-blue) | `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) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | Direction of network traffic for network errors. [3] | `receive`; `transmit` | +| [`network.io.direction`](/docs/registry/attributes/network.md) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `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 | ![Development](https://img.shields.io/badge/-development-blue) | -| `transmit` | transmit | ![Development](https://img.shields.io/badge/-development-blue) | +| `receive` | receive | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | +| `transmit` | transmit | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | diff --git a/docs/nfs/nfs-metrics.md b/docs/nfs/nfs-metrics.md index c3dc075b62..1018e582c5 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) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | The network IO operation direction. | `transmit` | +| [`network.io.direction`](/docs/registry/attributes/network.md) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Recommended` | string | The network IO operation direction. | `transmit` | --- @@ -271,8 +271,8 @@ This metric is [recommended][MetricRecommended]. | Value | Description | Stability | | --- | --- | --- | -| `receive` | receive | ![Development](https://img.shields.io/badge/-development-blue) | -| `transmit` | transmit | ![Development](https://img.shields.io/badge/-development-blue) | +| `receive` | receive | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | +| `transmit` | transmit | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | 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` | ![Development](https://img.shields.io/badge/-development-blue) | string | The disk IO operation direction. | `read` | +| `disk.io.direction` | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | 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 | ![Development](https://img.shields.io/badge/-development-blue) | -| `write` | write | ![Development](https://img.shields.io/badge/-development-blue) | +| `read` | read | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | +| `write` | write | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | diff --git a/docs/registry/attributes/network.md b/docs/registry/attributes/network.md index 3454564bf9..6c49d67fff 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` | ![Development](https://img.shields.io/badge/-development-blue) | 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` | ![Development](https://img.shields.io/badge/-development-blue) | string | The internet connection type. | `wifi` | | `network.interface.name` | ![Development](https://img.shields.io/badge/-development-blue) | string | The network interface name. | `lo`; `eth0` | -| `network.io.direction` | ![Development](https://img.shields.io/badge/-development-blue) | string | The network IO operation direction. | `transmit` | +| `network.io.direction` | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | string | The network IO operation direction. | `transmit` | | `network.local.address` | ![Stable](https://img.shields.io/badge/-stable-lightgreen) | string | Local address of the network connection - IP address or Unix domain socket name. | `10.1.2.80`; `/tmp/my.sock` | | `network.local.port` | ![Stable](https://img.shields.io/badge/-stable-lightgreen) | int | Local port number of the network connection. | `65123` | | `network.peer.address` | ![Stable](https://img.shields.io/badge/-stable-lightgreen) | 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 | ![Development](https://img.shields.io/badge/-development-blue) | -| `transmit` | transmit | ![Development](https://img.shields.io/badge/-development-blue) | +| `receive` | receive | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | +| `transmit` | transmit | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | --- 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` | ![Development](https://img.shields.io/badge/-development-blue) | string | The paging access direction | `in` | -| `system.paging.fault.type` | ![Development](https://img.shields.io/badge/-development-blue) | string | The paging fault type | `minor` | +| `system.paging.fault.type` | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | string | The paging fault type | `minor` | | `system.paging.state` | ![Development](https://img.shields.io/badge/-development-blue) | string | The memory paging state | `free` | --- @@ -125,8 +125,8 @@ Describes System Memory Paging attributes | Value | Description | Stability | | --- | --- | --- | -| `major` | major | ![Development](https://img.shields.io/badge/-development-blue) | -| `minor` | minor | ![Development](https://img.shields.io/badge/-development-blue) | +| `major` | major | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | +| `minor` | minor | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | --- diff --git a/docs/system/container-metrics.md b/docs/system/container-metrics.md index fdae878d17..2d4261a020 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) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | The paging fault type | `minor` | +| [`system.paging.fault.type`](/docs/registry/attributes/system.md) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `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 | ![Development](https://img.shields.io/badge/-development-blue) | -| `minor` | minor | ![Development](https://img.shields.io/badge/-development-blue) | +| `major` | major | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | +| `minor` | minor | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | @@ -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) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | The disk IO operation direction. | `read` | +| [`disk.io.direction`](/docs/registry/attributes/disk.md) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Recommended` | string | The disk IO operation direction. | `read` | | [`system.device`](/docs/registry/attributes/system.md) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | The device identifier | `(identifier)` | --- @@ -282,8 +282,8 @@ This metric is [opt-in][MetricOptIn]. | Value | Description | Stability | | --- | --- | --- | -| `read` | read | ![Development](https://img.shields.io/badge/-development-blue) | -| `write` | write | ![Development](https://img.shields.io/badge/-development-blue) | +| `read` | read | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | +| `write` | write | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | @@ -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) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | The network interface name. | `lo`; `eth0` | -| [`network.io.direction`](/docs/registry/attributes/network.md) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | The network IO operation direction. | `transmit` | +| [`network.io.direction`](/docs/registry/attributes/network.md) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Recommended` | string | The network IO operation direction. | `transmit` | --- @@ -317,8 +317,8 @@ This metric is [opt-in][MetricOptIn]. | Value | Description | Stability | | --- | --- | --- | -| `receive` | receive | ![Development](https://img.shields.io/badge/-development-blue) | -| `transmit` | transmit | ![Development](https://img.shields.io/badge/-development-blue) | +| `receive` | receive | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | +| `transmit` | transmit | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | diff --git a/docs/system/k8s-metrics.md b/docs/system/k8s-metrics.md index e5ceabf29f..75db232a18 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) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | The paging fault type | `minor` | +| [`system.paging.fault.type`](/docs/registry/attributes/system.md) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `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 | ![Development](https://img.shields.io/badge/-development-blue) | -| `minor` | minor | ![Development](https://img.shields.io/badge/-development-blue) | +| `major` | major | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | +| `minor` | minor | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | @@ -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) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | The network interface name. | `lo`; `eth0` | -| [`network.io.direction`](/docs/registry/attributes/network.md) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | The network IO operation direction. | `transmit` | +| [`network.io.direction`](/docs/registry/attributes/network.md) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Recommended` | string | The network IO operation direction. | `transmit` | --- @@ -432,8 +432,8 @@ This metric is [recommended][MetricRecommended]. | Value | Description | Stability | | --- | --- | --- | -| `receive` | receive | ![Development](https://img.shields.io/badge/-development-blue) | -| `transmit` | transmit | ![Development](https://img.shields.io/badge/-development-blue) | +| `receive` | receive | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | +| `transmit` | transmit | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | @@ -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) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | The network interface name. | `lo`; `eth0` | -| [`network.io.direction`](/docs/registry/attributes/network.md) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | The network IO operation direction. | `transmit` | +| [`network.io.direction`](/docs/registry/attributes/network.md) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Recommended` | string | The network IO operation direction. | `transmit` | --- @@ -465,8 +465,8 @@ This metric is [recommended][MetricRecommended]. | Value | Description | Stability | | --- | --- | --- | -| `receive` | receive | ![Development](https://img.shields.io/badge/-development-blue) | -| `transmit` | transmit | ![Development](https://img.shields.io/badge/-development-blue) | +| `receive` | receive | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | +| `transmit` | transmit | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | @@ -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) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | The paging fault type | `minor` | +| [`system.paging.fault.type`](/docs/registry/attributes/system.md) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `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 | ![Development](https://img.shields.io/badge/-development-blue) | -| `minor` | minor | ![Development](https://img.shields.io/badge/-development-blue) | +| `major` | major | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | +| `minor` | minor | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | @@ -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) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | The network interface name. | `lo`; `eth0` | -| [`network.io.direction`](/docs/registry/attributes/network.md) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | The network IO operation direction. | `transmit` | +| [`network.io.direction`](/docs/registry/attributes/network.md) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Recommended` | string | The network IO operation direction. | `transmit` | --- @@ -1209,8 +1209,8 @@ This metric is [recommended][MetricRecommended]. | Value | Description | Stability | | --- | --- | --- | -| `receive` | receive | ![Development](https://img.shields.io/badge/-development-blue) | -| `transmit` | transmit | ![Development](https://img.shields.io/badge/-development-blue) | +| `receive` | receive | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | +| `transmit` | transmit | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | @@ -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) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | The network interface name. | `lo`; `eth0` | -| [`network.io.direction`](/docs/registry/attributes/network.md) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | The network IO operation direction. | `transmit` | +| [`network.io.direction`](/docs/registry/attributes/network.md) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Recommended` | string | The network IO operation direction. | `transmit` | --- @@ -1242,8 +1242,8 @@ This metric is [recommended][MetricRecommended]. | Value | Description | Stability | | --- | --- | --- | -| `receive` | receive | ![Development](https://img.shields.io/badge/-development-blue) | -| `transmit` | transmit | ![Development](https://img.shields.io/badge/-development-blue) | +| `receive` | receive | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | +| `transmit` | transmit | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | diff --git a/docs/system/process-metrics.md b/docs/system/process-metrics.md index 54cb5b477e..166f804831 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) | ![Development](https://img.shields.io/badge/-development-blue) | `Required` | string | The disk IO operation direction. | `read` | +| [`disk.io.direction`](/docs/registry/attributes/disk.md) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Required` | string | The disk IO operation direction. | `read` | --- @@ -183,8 +183,8 @@ This metric is [recommended][MetricRecommended]. | Value | Description | Stability | | --- | --- | --- | -| `read` | read | ![Development](https://img.shields.io/badge/-development-blue) | -| `write` | write | ![Development](https://img.shields.io/badge/-development-blue) | +| `read` | read | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | +| `write` | write | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | @@ -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) | ![Development](https://img.shields.io/badge/-development-blue) | `Required` | string | The network IO operation direction. | `transmit` | +| [`network.io.direction`](/docs/registry/attributes/network.md) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Required` | string | The network IO operation direction. | `transmit` | --- @@ -215,8 +215,8 @@ This metric is [recommended][MetricRecommended]. | Value | Description | Stability | | --- | --- | --- | -| `receive` | receive | ![Development](https://img.shields.io/badge/-development-blue) | -| `transmit` | transmit | ![Development](https://img.shields.io/badge/-development-blue) | +| `receive` | receive | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | +| `transmit` | transmit | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | @@ -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) | ![Development](https://img.shields.io/badge/-development-blue) | `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) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `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 | ![Development](https://img.shields.io/badge/-development-blue) | -| `minor` | minor | ![Development](https://img.shields.io/badge/-development-blue) | +| `major` | major | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | +| `minor` | minor | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | diff --git a/docs/system/system-metrics.md b/docs/system/system-metrics.md index b991b788e8..c508a9f6e0 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) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | The paging fault type | `minor` | +| [`system.paging.fault.type`](/docs/registry/attributes/system.md) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Recommended` | string | The paging fault type | `minor` | --- @@ -437,8 +437,8 @@ This metric is [recommended][MetricRecommended]. | Value | Description | Stability | | --- | --- | --- | -| `major` | major | ![Development](https://img.shields.io/badge/-development-blue) | -| `minor` | minor | ![Development](https://img.shields.io/badge/-development-blue) | +| `major` | major | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | +| `minor` | minor | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | @@ -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) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | The paging access direction | `in` | -| [`system.paging.fault.type`](/docs/registry/attributes/system.md) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | The paging fault type | `minor` | +| [`system.paging.fault.type`](/docs/registry/attributes/system.md) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Recommended` | string | The paging fault type | `minor` | --- @@ -479,8 +479,8 @@ This metric is [recommended][MetricRecommended]. | Value | Description | Stability | | --- | --- | --- | -| `major` | major | ![Development](https://img.shields.io/badge/-development-blue) | -| `minor` | minor | ![Development](https://img.shields.io/badge/-development-blue) | +| `major` | major | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | +| `minor` | minor | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | @@ -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) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | The disk IO operation direction. | `read` | +| [`disk.io.direction`](/docs/registry/attributes/disk.md) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Recommended` | string | The disk IO operation direction. | `read` | | [`system.device`](/docs/registry/attributes/system.md) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | The device identifier | `(identifier)` | --- @@ -516,8 +516,8 @@ This metric is [recommended][MetricRecommended]. | Value | Description | Stability | | --- | --- | --- | -| `read` | read | ![Development](https://img.shields.io/badge/-development-blue) | -| `write` | write | ![Development](https://img.shields.io/badge/-development-blue) | +| `read` | read | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | +| `write` | write | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | @@ -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) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | The disk IO operation direction. | `read` | +| [`disk.io.direction`](/docs/registry/attributes/disk.md) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Recommended` | string | The disk IO operation direction. | `read` | | [`system.device`](/docs/registry/attributes/system.md) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | The device identifier | `(identifier)` | --- @@ -549,8 +549,8 @@ This metric is [recommended][MetricRecommended]. | Value | Description | Stability | | --- | --- | --- | -| `read` | read | ![Development](https://img.shields.io/badge/-development-blue) | -| `write` | write | ![Development](https://img.shields.io/badge/-development-blue) | +| `read` | read | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | +| `write` | write | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | @@ -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) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | The disk IO operation direction. | `read` | +| [`disk.io.direction`](/docs/registry/attributes/disk.md) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Recommended` | string | The disk IO operation direction. | `read` | | [`system.device`](/docs/registry/attributes/system.md) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | The device identifier | `(identifier)` | --- @@ -617,8 +617,8 @@ This metric is [recommended][MetricRecommended]. | Value | Description | Stability | | --- | --- | --- | -| `read` | read | ![Development](https://img.shields.io/badge/-development-blue) | -| `write` | write | ![Development](https://img.shields.io/badge/-development-blue) | +| `read` | read | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | +| `write` | write | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | @@ -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) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | The disk IO operation direction. | `read` | +| [`disk.io.direction`](/docs/registry/attributes/disk.md) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Recommended` | string | The disk IO operation direction. | `read` | | [`system.device`](/docs/registry/attributes/system.md) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | The device identifier | `(identifier)` | --- @@ -650,8 +650,8 @@ This metric is [recommended][MetricRecommended]. | Value | Description | Stability | | --- | --- | --- | -| `read` | read | ![Development](https://img.shields.io/badge/-development-blue) | -| `write` | write | ![Development](https://img.shields.io/badge/-development-blue) | +| `read` | read | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | +| `write` | write | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | @@ -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) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | The network interface name. | `lo`; `eth0` | -| [`network.io.direction`](/docs/registry/attributes/network.md) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | The network IO operation direction. | `transmit` | +| [`network.io.direction`](/docs/registry/attributes/network.md) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Recommended` | string | The network IO operation direction. | `transmit` | --- @@ -895,8 +895,8 @@ This metric is [recommended][MetricRecommended]. | Value | Description | Stability | | --- | --- | --- | -| `receive` | receive | ![Development](https://img.shields.io/badge/-development-blue) | -| `transmit` | transmit | ![Development](https://img.shields.io/badge/-development-blue) | +| `receive` | receive | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | +| `transmit` | transmit | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | @@ -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) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | The network IO operation direction. | `transmit` | +| [`network.io.direction`](/docs/registry/attributes/network.md) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Recommended` | string | The network IO operation direction. | `transmit` | | [`system.device`](/docs/registry/attributes/system.md) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | The device identifier | `(identifier)` | --- @@ -928,8 +928,8 @@ This metric is [recommended][MetricRecommended]. | Value | Description | Stability | | --- | --- | --- | -| `receive` | receive | ![Development](https://img.shields.io/badge/-development-blue) | -| `transmit` | transmit | ![Development](https://img.shields.io/badge/-development-blue) | +| `receive` | receive | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | +| `transmit` | transmit | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | @@ -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) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | The network interface name. | `lo`; `eth0` | -| [`network.io.direction`](/docs/registry/attributes/network.md) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | The network IO operation direction. | `transmit` | +| [`network.io.direction`](/docs/registry/attributes/network.md) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Recommended` | string | The network IO operation direction. | `transmit` | --- @@ -967,8 +967,8 @@ This metric is [recommended][MetricRecommended]. | Value | Description | Stability | | --- | --- | --- | -| `receive` | receive | ![Development](https://img.shields.io/badge/-development-blue) | -| `transmit` | transmit | ![Development](https://img.shields.io/badge/-development-blue) | +| `receive` | receive | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | +| `transmit` | transmit | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | @@ -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) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | The network interface name. | `lo`; `eth0` | -| [`network.io.direction`](/docs/registry/attributes/network.md) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | The network IO operation direction. | `transmit` | +| [`network.io.direction`](/docs/registry/attributes/network.md) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Recommended` | string | The network IO operation direction. | `transmit` | --- @@ -1000,8 +1000,8 @@ This metric is [recommended][MetricRecommended]. | Value | Description | Stability | | --- | --- | --- | -| `receive` | receive | ![Development](https://img.shields.io/badge/-development-blue) | -| `transmit` | transmit | ![Development](https://img.shields.io/badge/-development-blue) | +| `receive` | receive | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | +| `transmit` | transmit | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | 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..d797190b5b 100644 --- a/model/network/registry.yaml +++ b/model/network/registry.yaml @@ -225,11 +225,11 @@ groups: members: - id: transmit value: 'transmit' - stability: development + stability: release_candidate - id: receive value: 'receive' - stability: development - stability: development + stability: release_candidate + stability: release_candidate brief: "The network IO operation direction." examples: ["transmit"] - id: network.interface.name 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 From 0ca7c4393d36b19da5040ee9f8b45d83fe78029c Mon Sep 17 00:00:00 2001 From: Donal O'Sullivan Date: Tue, 23 Jun 2026 09:52:01 +0100 Subject: [PATCH 2/2] Update network.io.direction to be more specific This change is needed to allow this attribute to go to RC. --- ...process-network-io-system-paging-fault-attr-to-RC.yaml | 5 ++++- docs/hardware/gpu.md | 2 +- docs/hardware/network.md | 4 ++-- docs/nfs/nfs-metrics.md | 2 +- docs/registry/attributes/network.md | 2 +- docs/system/container-metrics.md | 2 +- docs/system/k8s-metrics.md | 8 ++++---- docs/system/process-metrics.md | 2 +- docs/system/system-metrics.md | 8 ++++---- model/network/registry.yaml | 4 +++- 10 files changed, 22 insertions(+), 17 deletions(-) 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 index cb28c32106..2a80957d1c 100644 --- 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 @@ -19,4 +19,7 @@ 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: +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/gpu.md b/docs/hardware/gpu.md index 09fb4f3689..decd7bd79e 100644 --- a/docs/hardware/gpu.md +++ b/docs/hardware/gpu.md @@ -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) | ![Development](https://img.shields.io/badge/-development-blue) | `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) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Required` | string | The network IO operation direction. | `receive`; `transmit` | +| [`network.io.direction`](/docs/registry/attributes/network.md) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `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) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | Driver version for the hardware component | `10.2.1-3` | | [`hw.firmware_version`](/docs/registry/attributes/hardware.md) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | Firmware version of the hardware component | `2.0.1` | | [`hw.model`](/docs/registry/attributes/hardware.md) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | Descriptive model name of the hardware component | `PERC H740P`; `Intel(R) Core(TM) i7-10700K`; `Dell XPS 15 Battery` | diff --git a/docs/hardware/network.md b/docs/hardware/network.md index b56a859743..672e17206c 100644 --- a/docs/hardware/network.md +++ b/docs/hardware/network.md @@ -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) | ![Development](https://img.shields.io/badge/-development-blue) | `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) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Required` | string | The network IO operation direction. | `receive`; `transmit` | +| [`network.io.direction`](/docs/registry/attributes/network.md) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `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) | ![Development](https://img.shields.io/badge/-development-blue) | `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) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | An easily-recognizable name for the hardware component | `eth0` | | [`hw.network.logical_addresses`](/docs/registry/attributes/hardware.md) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string[] | Logical addresses of the adapter (e.g. IP address, or WWPN) | `["172.16.8.21", "57.11.193.42"]` | @@ -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) | ![Development](https://img.shields.io/badge/-development-blue) | `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) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Required` | string | The network IO operation direction. | `receive`; `transmit` | +| [`network.io.direction`](/docs/registry/attributes/network.md) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `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) | ![Development](https://img.shields.io/badge/-development-blue) | `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) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | An easily-recognizable name for the hardware component | `eth0` | | [`hw.network.logical_addresses`](/docs/registry/attributes/hardware.md) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string[] | Logical addresses of the adapter (e.g. IP address, or WWPN) | `["172.16.8.21", "57.11.193.42"]` | diff --git a/docs/nfs/nfs-metrics.md b/docs/nfs/nfs-metrics.md index 1018e582c5..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) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Recommended` | string | The network IO operation direction. | `transmit` | +| [`network.io.direction`](/docs/registry/attributes/network.md) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `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` | --- diff --git a/docs/registry/attributes/network.md b/docs/registry/attributes/network.md index 6c49d67fff..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` | ![Development](https://img.shields.io/badge/-development-blue) | 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` | ![Development](https://img.shields.io/badge/-development-blue) | string | The internet connection type. | `wifi` | | `network.interface.name` | ![Development](https://img.shields.io/badge/-development-blue) | string | The network interface name. | `lo`; `eth0` | -| `network.io.direction` | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | string | The network IO operation direction. | `transmit` | +| `network.io.direction` | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | 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` | ![Stable](https://img.shields.io/badge/-stable-lightgreen) | string | Local address of the network connection - IP address or Unix domain socket name. | `10.1.2.80`; `/tmp/my.sock` | | `network.local.port` | ![Stable](https://img.shields.io/badge/-stable-lightgreen) | int | Local port number of the network connection. | `65123` | | `network.peer.address` | ![Stable](https://img.shields.io/badge/-stable-lightgreen) | string | Peer address of the network connection - IP address or Unix domain socket name. | `10.1.2.80`; `/tmp/my.sock` | diff --git a/docs/system/container-metrics.md b/docs/system/container-metrics.md index 2d4261a020..651418fc30 100644 --- a/docs/system/container-metrics.md +++ b/docs/system/container-metrics.md @@ -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) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | The network interface name. | `lo`; `eth0` | -| [`network.io.direction`](/docs/registry/attributes/network.md) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Recommended` | string | The network IO operation direction. | `transmit` | +| [`network.io.direction`](/docs/registry/attributes/network.md) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `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` | --- diff --git a/docs/system/k8s-metrics.md b/docs/system/k8s-metrics.md index 75db232a18..b732e21b01 100644 --- a/docs/system/k8s-metrics.md +++ b/docs/system/k8s-metrics.md @@ -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) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | The network interface name. | `lo`; `eth0` | -| [`network.io.direction`](/docs/registry/attributes/network.md) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Recommended` | string | The network IO operation direction. | `transmit` | +| [`network.io.direction`](/docs/registry/attributes/network.md) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `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` | --- @@ -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) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | The network interface name. | `lo`; `eth0` | -| [`network.io.direction`](/docs/registry/attributes/network.md) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Recommended` | string | The network IO operation direction. | `transmit` | +| [`network.io.direction`](/docs/registry/attributes/network.md) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `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` | --- @@ -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) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | The network interface name. | `lo`; `eth0` | -| [`network.io.direction`](/docs/registry/attributes/network.md) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Recommended` | string | The network IO operation direction. | `transmit` | +| [`network.io.direction`](/docs/registry/attributes/network.md) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `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` | --- @@ -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) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | The network interface name. | `lo`; `eth0` | -| [`network.io.direction`](/docs/registry/attributes/network.md) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Recommended` | string | The network IO operation direction. | `transmit` | +| [`network.io.direction`](/docs/registry/attributes/network.md) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `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` | --- diff --git a/docs/system/process-metrics.md b/docs/system/process-metrics.md index 166f804831..c3ae9be920 100644 --- a/docs/system/process-metrics.md +++ b/docs/system/process-metrics.md @@ -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) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Required` | string | The network IO operation direction. | `transmit` | +| [`network.io.direction`](/docs/registry/attributes/network.md) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `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` | --- diff --git a/docs/system/system-metrics.md b/docs/system/system-metrics.md index c508a9f6e0..08082841fa 100644 --- a/docs/system/system-metrics.md +++ b/docs/system/system-metrics.md @@ -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) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | The network interface name. | `lo`; `eth0` | -| [`network.io.direction`](/docs/registry/attributes/network.md) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Recommended` | string | The network IO operation direction. | `transmit` | +| [`network.io.direction`](/docs/registry/attributes/network.md) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `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` | --- @@ -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) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Recommended` | string | The network IO operation direction. | `transmit` | +| [`network.io.direction`](/docs/registry/attributes/network.md) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `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) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | The device identifier | `(identifier)` | --- @@ -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) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | The network interface name. | `lo`; `eth0` | -| [`network.io.direction`](/docs/registry/attributes/network.md) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Recommended` | string | The network IO operation direction. | `transmit` | +| [`network.io.direction`](/docs/registry/attributes/network.md) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `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` | --- @@ -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) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | The network interface name. | `lo`; `eth0` | -| [`network.io.direction`](/docs/registry/attributes/network.md) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Recommended` | string | The network IO operation direction. | `transmit` | +| [`network.io.direction`](/docs/registry/attributes/network.md) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `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` | --- diff --git a/model/network/registry.yaml b/model/network/registry.yaml index d797190b5b..7fb6e5898f 100644 --- a/model/network/registry.yaml +++ b/model/network/registry.yaml @@ -230,7 +230,9 @@ groups: value: 'receive' stability: release_candidate stability: release_candidate - brief: "The network IO operation direction." + 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