136 lines
12 KiB
Markdown
136 lines
12 KiB
Markdown
<!-- NOTE: THIS FILE IS AUTOGENERATED. DO NOT EDIT BY HAND. -->
|
|
<!-- see templates/registry/markdown/attribute_namespace.md.j2 -->
|
|
|
|
# Hardware
|
|
|
|
## Hardware Attributes
|
|
|
|
Attributes for hardware.
|
|
|
|
| Attribute | Type | Description | Examples | Stability |
|
|
|---|---|---|---|---|
|
|
| <a id="hw-battery-capacity" href="#hw-battery-capacity">`hw.battery.capacity`</a> | string | Design capacity in Watts-hours or Amper-hours | `9.3Ah`; `50Wh` |  |
|
|
| <a id="hw-battery-chemistry" href="#hw-battery-chemistry">`hw.battery.chemistry`</a> | 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` |  |
|
|
| <a id="hw-battery-state" href="#hw-battery-state">`hw.battery.state`</a> | string | The current state of the battery | `charging`; `discharging` |  |
|
|
| <a id="hw-bios-version" href="#hw-bios-version">`hw.bios_version`</a> | string | BIOS version of the hardware component | `1.2.3` |  |
|
|
| <a id="hw-driver-version" href="#hw-driver-version">`hw.driver_version`</a> | string | Driver version for the hardware component | `10.2.1-3` |  |
|
|
| <a id="hw-enclosure-type" href="#hw-enclosure-type">`hw.enclosure.type`</a> | string | Type of the enclosure (useful for modular systems) | `Computer`; `Storage`; `Switch` |  |
|
|
| <a id="hw-firmware-version" href="#hw-firmware-version">`hw.firmware_version`</a> | string | Firmware version of the hardware component | `2.0.1` |  |
|
|
| <a id="hw-gpu-task" href="#hw-gpu-task">`hw.gpu.task`</a> | string | Type of task the GPU is performing | `decoder`; `encoder`; `general` |  |
|
|
| <a id="hw-id" href="#hw-id">`hw.id`</a> | string | An identifier for the hardware component, unique within the monitored host | `win32battery_battery_testsysa33_1` |  |
|
|
| <a id="hw-limit-type" href="#hw-limit-type">`hw.limit_type`</a> | string | Type of limit for hardware components | `critical`; `degraded`; `high.critical` |  |
|
|
| <a id="hw-logical-disk-raid-level" href="#hw-logical-disk-raid-level">`hw.logical_disk.raid_level`</a> | string | RAID Level of the logical disk | `RAID0+1`; `RAID5`; `RAID10` |  |
|
|
| <a id="hw-logical-disk-state" href="#hw-logical-disk-state">`hw.logical_disk.state`</a> | string | State of the logical disk space usage | `used`; `free` |  |
|
|
| <a id="hw-memory-type" href="#hw-memory-type">`hw.memory.type`</a> | string | Type of the memory module | `DDR4`; `DDR5`; `LPDDR5` |  |
|
|
| <a id="hw-model" href="#hw-model">`hw.model`</a> | string | Descriptive model name of the hardware component | `PERC H740P`; `Intel(R) Core(TM) i7-10700K`; `Dell XPS 15 Battery` |  |
|
|
| <a id="hw-name" href="#hw-name">`hw.name`</a> | string | An easily-recognizable name for the hardware component | `eth0` |  |
|
|
| <a id="hw-network-logical-addresses" href="#hw-network-logical-addresses">`hw.network.logical_addresses`</a> | string[] | Logical addresses of the adapter (e.g. IP address, or WWPN) | `["172.16.8.21", "57.11.193.42"]` |  |
|
|
| <a id="hw-network-physical-address" href="#hw-network-physical-address">`hw.network.physical_address`</a> | string | Physical address of the adapter (e.g. MAC address, or WWNN) | `00-90-F5-E9-7B-36` |  |
|
|
| <a id="hw-parent" href="#hw-parent">`hw.parent`</a> | string | Unique identifier of the parent component (typically the `hw.id` attribute of the enclosure, or disk controller) | `dellStorage_perc_0` |  |
|
|
| <a id="hw-physical-disk-smart-attribute" href="#hw-physical-disk-smart-attribute">`hw.physical_disk.smart_attribute`</a> | 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` |  |
|
|
| <a id="hw-physical-disk-state" href="#hw-physical-disk-state">`hw.physical_disk.state`</a> | string | State of the physical disk endurance utilization | `remaining` |  |
|
|
| <a id="hw-physical-disk-type" href="#hw-physical-disk-type">`hw.physical_disk.type`</a> | string | Type of the physical disk | `HDD`; `SSD`; `10K` |  |
|
|
| <a id="hw-sensor-location" href="#hw-sensor-location">`hw.sensor_location`</a> | string | Location of the sensor | `cpu0`; `ps1`; `INLET`; `CPU0_DIE`; `AMBIENT`; `MOTHERBOARD`; `PS0 V3_3`; `MAIN_12V`; `CPU_VCORE` |  |
|
|
| <a id="hw-serial-number" href="#hw-serial-number">`hw.serial_number`</a> | string | Serial number of the hardware component | `CNFCP0123456789` |  |
|
|
| <a id="hw-state" href="#hw-state">`hw.state`</a> | string | The current state of the component | `degraded`; `failed`; `needs_cleaning` |  |
|
|
| <a id="hw-tape-drive-operation-type" href="#hw-tape-drive-operation-type">`hw.tape_drive.operation_type`</a> | string | Type of tape drive operation | `mount`; `unmount`; `clean` |  |
|
|
| <a id="hw-type" href="#hw-type">`hw.type`</a> | string | Type of the component [1] | `battery`; `cpu`; `disk_controller` |  |
|
|
| <a id="hw-vendor" href="#hw-vendor">`hw.vendor`</a> | 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 |  |
|