<!--- Hugo front matter used to generate the website version of this page:
--->

<!-- NOTE: THIS FILE IS AUTOGENERATED. DO NOT EDIT BY HAND. -->
<!-- see templates/registry/markdown/attribute_namespace.md.j2 -->

# System

- [System](#system-attributes)
- [System Cpu](#system-cpu-attributes)
- [System Deprecated](#system-deprecated-attributes)
- [System Filesystem](#system-filesystem-attributes)
- [System Memory](#system-memory-attributes)
- [System Network](#system-network-attributes)
- [System Paging](#system-paging-attributes)
- [System Process](#system-process-attributes)

## System Attributes

Describes System attributes

| Attribute       | Type   | Description           | Examples       | Stability                                                        |
| --------------- | ------ | --------------------- | -------------- | ---------------------------------------------------------------- |
| `system.device` | string | The device identifier | `(identifier)` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |

## System CPU Attributes

Describes System CPU attributes

| Attribute                   | Type | Description                     | Examples | Stability                                                        |
| --------------------------- | ---- | ------------------------------- | -------- | ---------------------------------------------------------------- |
| `system.cpu.logical_number` | int  | The logical CPU number [0..n-1] | `1`      | ![Experimental](https://img.shields.io/badge/-experimental-blue) |

## System Deprecated Attributes

Deprecated system attributes.

| Attribute                 | Type   | Description                                      | Examples            | Stability                                                                                           |
| ------------------------- | ------ | ------------------------------------------------ | ------------------- | --------------------------------------------------------------------------------------------------- |
| `system.cpu.state`        | string | Deprecated, use `cpu.mode` instead.              | `idle`; `interrupt` | ![Deprecated](https://img.shields.io/badge/-deprecated-red)<br>Replaced by `cpu.mode`               |
| `system.processes.status` | string | Deprecated, use `system.process.status` instead. | `running`           | ![Deprecated](https://img.shields.io/badge/-deprecated-red)<br>Replaced by `system.process.status`. |

`system.cpu.state` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.

| Value       | Description | Stability                                                        |
| ----------- | ----------- | ---------------------------------------------------------------- |
| `idle`      | idle        | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
| `interrupt` | interrupt   | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
| `iowait`    | iowait      | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
| `nice`      | nice        | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
| `steal`     | steal       | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
| `system`    | system      | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
| `user`      | user        | ![Experimental](https://img.shields.io/badge/-experimental-blue) |

`system.processes.status` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.

| Value      | Description | Stability                                                        |
| ---------- | ----------- | ---------------------------------------------------------------- |
| `defunct`  | defunct     | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
| `running`  | running     | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
| `sleeping` | sleeping    | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
| `stopped`  | stopped     | ![Experimental](https://img.shields.io/badge/-experimental-blue) |

## System Filesystem Attributes

Describes Filesystem attributes

| Attribute                      | Type   | Description               | Examples    | Stability                                                        |
| ------------------------------ | ------ | ------------------------- | ----------- | ---------------------------------------------------------------- |
| `system.filesystem.mode`       | string | The filesystem mode       | `rw, ro`    | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
| `system.filesystem.mountpoint` | string | The filesystem mount path | `/mnt/data` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
| `system.filesystem.state`      | string | The filesystem state      | `used`      | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
| `system.filesystem.type`       | string | The filesystem type       | `ext4`      | ![Experimental](https://img.shields.io/badge/-experimental-blue) |

`system.filesystem.state` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.

| Value      | Description | Stability                                                        |
| ---------- | ----------- | ---------------------------------------------------------------- |
| `free`     | free        | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
| `reserved` | reserved    | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
| `used`     | used        | ![Experimental](https://img.shields.io/badge/-experimental-blue) |

`system.filesystem.type` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.

| Value     | Description | Stability                                                        |
| --------- | ----------- | ---------------------------------------------------------------- |
| `exfat`   | exfat       | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
| `ext4`    | ext4        | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
| `fat32`   | fat32       | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
| `hfsplus` | hfsplus     | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
| `ntfs`    | ntfs        | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
| `refs`    | refs        | ![Experimental](https://img.shields.io/badge/-experimental-blue) |

## System Memory Attributes

Describes System Memory attributes

| Attribute             | Type   | Description      | Examples         | Stability                                                        |
| --------------------- | ------ | ---------------- | ---------------- | ---------------------------------------------------------------- |
| `system.memory.state` | string | The memory state | `free`; `cached` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |

`system.memory.state` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.

| Value     | Description | Stability                                                                                                                                    |
| --------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| `buffers` | buffers     | ![Experimental](https://img.shields.io/badge/-experimental-blue)                                                                             |
| `cached`  | cached      | ![Experimental](https://img.shields.io/badge/-experimental-blue)                                                                             |
| `free`    | free        | ![Experimental](https://img.shields.io/badge/-experimental-blue)                                                                             |
| `shared`  | shared      | ![Deprecated](https://img.shields.io/badge/-deprecated-red)<br>Removed, report shared memory usage with `metric.system.memory.shared` metric |
| `used`    | used        | ![Experimental](https://img.shields.io/badge/-experimental-blue)                                                                             |

## System Network Attributes

Describes Network attributes

| Attribute              | Type   | Description                                      | Examples     | Stability                                                        |
| ---------------------- | ------ | ------------------------------------------------ | ------------ | ---------------------------------------------------------------- |
| `system.network.state` | string | A stateless protocol MUST NOT set this attribute | `close_wait` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |

`system.network.state` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.

| Value         | Description | Stability                                                        |
| ------------- | ----------- | ---------------------------------------------------------------- |
| `close`       | close       | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
| `close_wait`  | close_wait  | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
| `closing`     | closing     | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
| `delete`      | delete      | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
| `established` | established | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
| `fin_wait_1`  | fin_wait_1  | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
| `fin_wait_2`  | fin_wait_2  | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
| `last_ack`    | last_ack    | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
| `listen`      | listen      | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
| `syn_recv`    | syn_recv    | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
| `syn_sent`    | syn_sent    | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
| `time_wait`   | time_wait   | ![Experimental](https://img.shields.io/badge/-experimental-blue) |

## System Paging Attributes

Describes System Memory Paging attributes

| Attribute                 | Type   | Description                 | Examples | Stability                                                        |
| ------------------------- | ------ | --------------------------- | -------- | ---------------------------------------------------------------- |
| `system.paging.direction` | string | The paging access direction | `in`     | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
| `system.paging.state`     | string | The memory paging state     | `free`   | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
| `system.paging.type`      | string | The memory paging type      | `minor`  | ![Experimental](https://img.shields.io/badge/-experimental-blue) |

`system.paging.direction` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.

| Value | Description | Stability                                                        |
| ----- | ----------- | ---------------------------------------------------------------- |
| `in`  | in          | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
| `out` | out         | ![Experimental](https://img.shields.io/badge/-experimental-blue) |

`system.paging.state` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.

| Value  | Description | Stability                                                        |
| ------ | ----------- | ---------------------------------------------------------------- |
| `free` | free        | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
| `used` | used        | ![Experimental](https://img.shields.io/badge/-experimental-blue) |

`system.paging.type` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.

| Value   | Description | Stability                                                        |
| ------- | ----------- | ---------------------------------------------------------------- |
| `major` | major       | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
| `minor` | minor       | ![Experimental](https://img.shields.io/badge/-experimental-blue) |

## System Process Attributes

Describes System Process attributes

| Attribute               | Type   | Description                                                                                                               | Examples  | Stability                                                        |
| ----------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------- | --------- | ---------------------------------------------------------------- |
| `system.process.status` | string | The process state, e.g., [Linux Process State Codes](https://man7.org/linux/man-pages/man1/ps.1.html#PROCESS_STATE_CODES) | `running` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |

`system.process.status` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.

| Value      | Description | Stability                                                        |
| ---------- | ----------- | ---------------------------------------------------------------- |
| `defunct`  | defunct     | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
| `running`  | running     | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
| `sleeping` | sleeping    | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
| `stopped`  | stopped     | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
