# Hardware
## Hardware Attributes
Attributes for hardware.
| Attribute | Type | Description | Examples | Stability |
|---|---|---|---|---|
| `hw.battery.capacity` | string | Design capacity in Watts-hours or Amper-hours | `9.3Ah`; `50Wh` |  |
| `hw.battery.chemistry` | string | Battery [chemistry](https://schemas.dmtf.org/wbem/cim-html/2.31.0/CIM_Battery.html), e.g. Lithium-Ion, Nickel-Cadmium, etc. | `Li-ion`; `NiMH` |  |
| `hw.battery.state` | string | The current state of the battery | `charging`; `discharging` |  |
| `hw.bios_version` | string | BIOS version of the hardware component | `1.2.3` |  |
| `hw.driver_version` | string | Driver version for the hardware component | `10.2.1-3` |  |
| `hw.enclosure.type` | string | Type of the enclosure (useful for modular systems) | `Computer`; `Storage`; `Switch` |  |
| `hw.firmware_version` | string | Firmware version of the hardware component | `2.0.1` |  |
| `hw.gpu.task` | string | Type of task the GPU is performing | `decoder`; `encoder`; `general` |  |
| `hw.id` | string | An identifier for the hardware component, unique within the monitored host | `win32battery_battery_testsysa33_1` |  |
| `hw.limit_type` | string | Type of limit for hardware components | `critical`; `degraded`; `high.critical` |  |
| `hw.logical_disk.raid_level` | string | RAID Level of the logical disk | `RAID0+1`; `RAID5`; `RAID10` |  |
| `hw.logical_disk.state` | string | State of the logical disk space usage | `used`; `free` |  |
| `hw.memory.type` | string | Type of the memory module | `DDR4`; `DDR5`; `LPDDR5` |  |
| `hw.model` | string | Descriptive model name of the hardware component | `PERC H740P`; `Intel(R) Core(TM) i7-10700K`; `Dell XPS 15 Battery` |  |
| `hw.name` | string | An easily-recognizable name for the hardware component | `eth0` |  |
| `hw.network.logical_addresses` | string[] | Logical addresses of the adapter (e.g. IP address, or WWPN) | `["172.16.8.21", "57.11.193.42"]` |  |
| `hw.network.physical_address` | string | Physical address of the adapter (e.g. MAC address, or WWNN) | `00-90-F5-E9-7B-36` |  |
| `hw.parent` | string | Unique identifier of the parent component (typically the `hw.id` attribute of the enclosure, or disk controller) | `dellStorage_perc_0` |  |
| `hw.physical_disk.smart_attribute` | string | [S.M.A.R.T.](https://wikipedia.org/wiki/S.M.A.R.T.) (Self-Monitoring, Analysis, and Reporting Technology) attribute of the physical disk | `Spin Retry Count`; `Seek Error Rate`; `Raw Read Error Rate` |  |
| `hw.physical_disk.state` | string | State of the physical disk endurance utilization | `remaining` |  |
| `hw.physical_disk.type` | string | Type of the physical disk | `HDD`; `SSD`; `10K` |  |
| `hw.sensor_location` | string | Location of the sensor | `cpu0`; `ps1`; `INLET`; `CPU0_DIE`; `AMBIENT`; `MOTHERBOARD`; `PS0 V3_3`; `MAIN_12V`; `CPU_VCORE` |  |
| `hw.serial_number` | string | Serial number of the hardware component | `CNFCP0123456789` |  |
| `hw.state` | string | The current state of the component | `degraded`; `failed`; `needs_cleaning` |  |
| `hw.tape_drive.operation_type` | string | Type of tape drive operation | `mount`; `unmount`; `clean` |  |
| `hw.type` | string | Type of the component [1] | `battery`; `cpu`; `disk_controller` |  |
| `hw.vendor` | string | Vendor name of the hardware component | `Dell`; `HP`; `Intel`; `AMD`; `LSI`; `Lenovo` |  |
**[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`.
---
`hw.battery.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 |
|---|---|---|
| `charging` | Charging |  |
| `discharging` | Discharging |  |
---
`hw.gpu.task` 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 |
|---|---|---|
| `decoder` | Decoder |  |
| `encoder` | Encoder |  |
| `general` | General |  |
---
`hw.limit_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 |
|---|---|---|
| `critical` | Critical |  |
| `degraded` | Degraded |  |
| `high.critical` | High Critical |  |
| `high.degraded` | High Degraded |  |
| `low.critical` | Low Critical |  |
| `low.degraded` | Low Degraded |  |
| `max` | Maximum |  |
| `throttled` | Throttled |  |
| `turbo` | Turbo |  |
---
`hw.logical_disk.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 |  |
| `used` | Used |  |
---
`hw.physical_disk.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 |
|---|---|---|
| `remaining` | Remaining |  |
---
`hw.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 |
|---|---|---|
| `degraded` | Degraded |  |
| `failed` | Failed |  |
| `needs_cleaning` | Needs Cleaning |  |
| `ok` | OK |  |
| `predicted_failure` | Predicted Failure |  |
---
`hw.tape_drive.operation_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 |
|---|---|---|
| `clean` | Clean |  |
| `mount` | Mount |  |
| `unmount` | Unmount |  |
---
`hw.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 |
|---|---|---|
| `battery` | Battery |  |
| `cpu` | CPU |  |
| `disk_controller` | Disk controller |  |
| `enclosure` | Enclosure |  |
| `fan` | Fan |  |
| `gpu` | GPU |  |
| `logical_disk` | Logical disk |  |
| `memory` | Memory |  |
| `network` | Network |  |
| `physical_disk` | Physical disk |  |
| `power_supply` | Power supply |  |
| `tape_drive` | Tape drive |  |
| `temperature` | Temperature |  |
| `voltage` | Voltage |  |