semantic-conventions/docs/registry/attributes/hardware.md

12 KiB

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 Development
hw.battery.chemistry string Battery chemistry, e.g. Lithium-Ion, Nickel-Cadmium, etc. Li-ion; NiMH Development
hw.battery.state string The current state of the battery charging; discharging Development
hw.bios_version string BIOS version of the hardware component 1.2.3 Development
hw.driver_version string Driver version for the hardware component 10.2.1-3 Development
hw.enclosure.type string Type of the enclosure (useful for modular systems) Computer; Storage; Switch Development
hw.firmware_version string Firmware version of the hardware component 2.0.1 Development
hw.gpu.task string Type of task the GPU is performing decoder; encoder; general Development
hw.id string An identifier for the hardware component, unique within the monitored host win32battery_battery_testsysa33_1 Development
hw.limit_type string Type of limit for hardware components critical; degraded; high.critical Development
hw.logical_disk.raid_level string RAID Level of the logical disk RAID0+1; RAID5; RAID10 Development
hw.logical_disk.state string State of the logical disk space usage used; free Development
hw.memory.type string Type of the memory module DDR4; DDR5; LPDDR5 Development
hw.model string Descriptive model name of the hardware component PERC H740P; Intel(R) Core(TM) i7-10700K; Dell XPS 15 Battery Development
hw.name string An easily-recognizable name for the hardware component eth0 Development
hw.network.logical_addresses string[] Logical addresses of the adapter (e.g. IP address, or WWPN) ["172.16.8.21", "57.11.193.42"] Development
hw.network.physical_address string Physical address of the adapter (e.g. MAC address, or WWNN) 00-90-F5-E9-7B-36 Development
hw.parent string Unique identifier of the parent component (typically the hw.id attribute of the enclosure, or disk controller) dellStorage_perc_0 Development
hw.physical_disk.smart_attribute string 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 Development
hw.physical_disk.state string State of the physical disk endurance utilization remaining Development
hw.physical_disk.type string Type of the physical disk HDD; SSD; 10K Development
hw.sensor_location string Location of the sensor cpu0; ps1; INLET; CPU0_DIE; AMBIENT; MOTHERBOARD; PS0 V3_3; MAIN_12V; CPU_VCORE Development
hw.serial_number string Serial number of the hardware component CNFCP0123456789 Development
hw.state string The current state of the component degraded; failed; needs_cleaning Development
hw.tape_drive.operation_type string Type of tape drive operation mount; unmount; clean Development
hw.type string Type of the component [1] battery; cpu; disk_controller Development
hw.vendor string Vendor name of the hardware component Dell; HP; Intel; AMD; LSI; Lenovo Development

[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 Development
discharging Discharging Development

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 Development
encoder Encoder Development
general General Development

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 Development
degraded Degraded Development
high.critical High Critical Development
high.degraded High Degraded Development
low.critical Low Critical Development
low.degraded Low Degraded Development
max Maximum Development
throttled Throttled Development
turbo Turbo Development

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 Development
used Used Development

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 Development

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 Development
failed Failed Development
needs_cleaning Needs Cleaning Development
ok OK Development
predicted_failure Predicted Failure Development

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 Development
mount Mount Development
unmount Unmount Development

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 Development
cpu CPU Development
disk_controller Disk controller Development
enclosure Enclosure Development
fan Fan Development
gpu GPU Development
logical_disk Logical disk Development
memory Memory Development
network Network Development
physical_disk Physical disk Development
power_supply Power supply Development
tape_drive Tape drive Development
temperature Temperature Development
voltage Voltage Development