电压指标的语义约定

状态: 开发中

电压指标 hw.voltage.*

一个电压传感器，可以是数字的或离散的。

当使用通用的 hw.status 指标时，hw.type 必须设置为 "voltage"。

所有电压指标都可以包含以下属性

Attributes

键	Stability	需求级别	Value Type	描述	Example Values
hw.id		必需	字符串	硬件组件的标识符，在监控主机内是唯一的	win32battery_battery_testsysa33_1
hw.name		推荐	字符串	硬件组件的一个易于识别的名称	eth0
hw.parent		推荐	字符串	父组件的唯一标识符（通常是机箱或磁盘控制器的 hw.id 属性）	dellStorage_perc_0
hw.sensor_location		推荐	字符串	传感器位置	cpu0; ps1; INLET; CPU0_DIE; AMBIENT; MOTHERBOARD; PS0 V3_3; MAIN_12V; CPU_VCORE

指标: hw.voltage

此指标是推荐的。

传感器测得的电压。

名称	Instrument Type	Unit (UCUM)	描述	Stability	实体关联
hw.voltage	Gauge	V	传感器测得的电压。

Attributes

键	Stability	需求级别	Value Type	描述	Example Values
hw.id		必需	字符串	硬件组件的标识符，在监控主机内是唯一的	win32battery_battery_testsysa33_1
hw.name		推荐	字符串	硬件组件的一个易于识别的名称	eth0
hw.parent		推荐	字符串	父组件的唯一标识符（通常是机箱或磁盘控制器的 hw.id 属性）	dellStorage_perc_0
hw.sensor_location		推荐	字符串	传感器位置	cpu0; ps1; INLET; CPU0_DIE; AMBIENT; MOTHERBOARD; PS0 V3_3; MAIN_12V; CPU_VCORE

指标: hw.voltage.limit

此指标是推荐的。

电压限值，单位为伏特（Volts）。

应设置以下属性

• hw.voltage.limit_type 应设置为指示限值类型，例如 "low.critical"、"low.degraded"、"high.degraded" 或 "high.critical"。

名称	Instrument Type	Unit (UCUM)	描述	Stability	实体关联
hw.voltage.limit	Gauge	V	电压限值，单位为伏特（Volts）。

Attributes

键	Stability	需求级别	Value Type	描述	Example Values
hw.id		必需	字符串	硬件组件的标识符，在监控主机内是唯一的	win32battery_battery_testsysa33_1
hw.limit_type		推荐	字符串	硬件组件的限制类型	low.critical; low.degraded; high.degraded; high.critical
hw.name		推荐	字符串	硬件组件的一个易于识别的名称	eth0
hw.parent		推荐	字符串	父组件的唯一标识符（通常是机箱或磁盘控制器的 hw.id 属性）	dellStorage_perc_0
hw.sensor_location		推荐	字符串	传感器位置	cpu0; ps1; INLET; CPU0_DIE; AMBIENT; MOTHERBOARD; PS0 V3_3; MAIN_12V; CPU_VCORE

hw.limit_type 具有以下已知值列表。如果其中一个适用，则必须使用相应的；否则，可以使用自定义值。

值	描述	Stability
critical	严重
degraded	降级
high.critical	高严重
high.degraded	高降级
low.critical	低严重
low.degraded	低降级
max	最大
throttled	节流
turbo	涡轮增压

指标: hw.voltage.nominal

此指标是推荐的。

标称（预期）电压。

名称	Instrument Type	Unit (UCUM)	描述	Stability	实体关联
hw.voltage.nominal	Gauge	V	标称（预期）电压。

Attributes

键	Stability	需求级别	Value Type	描述	Example Values
hw.id		必需	字符串	硬件组件的标识符，在监控主机内是唯一的	win32battery_battery_testsysa33_1
hw.name		推荐	字符串	硬件组件的一个易于识别的名称	eth0
hw.parent		推荐	字符串	父组件的唯一标识符（通常是机箱或磁盘控制器的 hw.id 属性）	dellStorage_perc_0
hw.sensor_location		推荐	字符串	传感器位置	cpu0; ps1; INLET; CPU0_DIE; AMBIENT; MOTHERBOARD; PS0 V3_3; MAIN_12V; CPU_VCORE

指标: hw.status (电压)

此指标是推荐的。

电压是否在正常范围内：对于每种可能的状态，1（真）或 0（假）。

当使用此指标表示电压状态时，必须设置以下属性

• hw.type 必须设置为 "voltage"，以指示状态是针对电压传感器。
• hw.state 必须设置为以下值之一，以指示电压状态
  • "ok"：电压在正常范围内。
  • "degraded"：电压超出正常范围，但并非危急。
  • "failed"：电压处于危急水平。

名称	Instrument Type	Unit (UCUM)	描述	Stability	实体关联
hw.status	UpDownCounter	1	运行状态：对于每种可能的状态，为 1（true）或 0（false）。[1]

[1]: hw.status 目前被指定为 UpDownCounter，但理想情况下应使用 StateSet（如 OpenMetrics 中定义的） 来表示。一旦 StateSet 在 OpenTelemetry 中被指定，此语义约定将进行更新。此计划的更改预计不会对用户查询其时间序列后端以检索 hw.status 值的方式产生任何影响。

Attributes

键	Stability	需求级别	Value Type	描述	Example Values
hw.id		必需	字符串	硬件组件的标识符，在监控主机内是唯一的	win32battery_battery_testsysa33_1
hw.state		必需	字符串	组件的当前状态	degraded; failed; needs_cleaning
hw.type		必需	字符串	组件类型 [1]	battery; cpu; disk_controller
hw.name		推荐	字符串	硬件组件的一个易于识别的名称	eth0
hw.parent		推荐	字符串	父组件的唯一标识符（通常是机箱或磁盘控制器的 hw.id 属性）	dellStorage_perc_0

[1] hw.type: 描述了报告 hw.state 的硬件组件的类别。例如，hw.type=temperature 和 hw.state=degraded 将表示硬件组件的温度被报告为 degraded。

hw.state 具有以下已知值列表。如果其中一个适用，则必须使用相应的；否则，可以使用自定义值。

值	描述	Stability
degraded	降级
failed	失败
needs_cleaning	需要清洁
ok	OK
predicted_failure	预测失败

hw.type 具有以下已知值列表。如果其中一个适用，则必须使用相应的；否则，可以使用自定义值。

值	描述	Stability
battery	Battery
cpu	CPU
disk_controller	磁盘控制器
enclosure	Enclosure
fan	Fan
gpu	GPU
logical_disk	逻辑磁盘
memory	Memory
network	网络
physical_disk	物理磁盘
power_supply	电源
tape_drive	磁带机
temperature	Temperature
voltage	Voltage