电池指标的语义约定

电池指标 `hw.battery.*`

计算机系统或 UPS 中的电池。

hw.type 必须设置为 "battery"。

所有电池指标都可以包含以下属性来描述被监控电池的特性

Attributes

键	需求级别	Value Type	描述	Example Values
`hw.id`	`必需`	字符串	硬件组件的标识符，在监控主机内是唯一的	`win32battery_battery_testsysa33_1`
`hw.battery.capacity`	`推荐`	字符串	设计容量，单位为瓦时或安时	`9.3Ah`; `50Wh`
`hw.battery.chemistry`	`推荐`	字符串	电池化学成分，例如锂离子、镍镉等。	`Li-ion`; `NiMH`
`hw.model`	`推荐`	字符串	硬件组件的描述性型号名称	`PERC H740P`; `Intel(R) Core(TM) i7-10700K`; `Dell XPS 15 Battery`
`hw.name`	`推荐`	字符串	硬件组件的一个易于识别的名称	`eth0`
`hw.parent`	`推荐`	字符串	父组件的唯一标识符（通常是机箱或磁盘控制器的 `hw.id` 属性）	`dellStorage_perc_0`
`hw.vendor`	`推荐`	字符串	硬件组件的供应商名称	`Dell`; `HP`; `Intel`; `AMD`; `LSI`; `Lenovo`

Metric: `hw.battery.charge`

此指标是推荐的。

名称	Instrument Type	Unit (UCUM)	描述	Stability	实体关联
`hw.battery.charge`	Gauge	`1`	电池剩余电量分数。

Attributes

键	需求级别	Value Type	描述	Example Values
`hw.id`	`必需`	字符串	硬件组件的标识符，在监控主机内是唯一的	`win32battery_battery_testsysa33_1`
`hw.battery.capacity`	`推荐`	字符串	设计容量，单位为瓦时或安时	`9.3Ah`; `50Wh`
`hw.battery.chemistry`	`推荐`	字符串	电池化学成分，例如锂离子、镍镉等。	`Li-ion`; `NiMH`
`hw.model`	`推荐`	字符串	硬件组件的描述性型号名称	`PERC H740P`; `Intel(R) Core(TM) i7-10700K`; `Dell XPS 15 Battery`
`hw.name`	`推荐`	字符串	硬件组件的一个易于识别的名称	`eth0`
`hw.parent`	`推荐`	字符串	父组件的唯一标识符（通常是机箱或磁盘控制器的 `hw.id` 属性）	`dellStorage_perc_0`
`hw.vendor`	`推荐`	字符串	硬件组件的供应商名称	`Dell`; `HP`; `Intel`; `AMD`; `LSI`; `Lenovo`

Metric: `hw.battery.charge.limit`

此指标是推荐的。

名称	Instrument Type	Unit (UCUM)	描述	Stability	实体关联
`hw.battery.charge.limit`	Gauge	`1`	为确保正常运行，电池电量分数下限。

Attributes

键	需求级别	Value Type	描述	Example Values
`hw.id`	`必需`	字符串	硬件组件的标识符，在监控主机内是唯一的	`win32battery_battery_testsysa33_1`
`hw.battery.capacity`	`推荐`	字符串	设计容量，单位为瓦时或安时	`9.3Ah`; `50Wh`
`hw.battery.chemistry`	`推荐`	字符串	电池化学成分，例如锂离子、镍镉等。	`Li-ion`; `NiMH`
`hw.limit_type`	`推荐`	字符串	表示与设备运行和健康相关的电池电量阈值。每个 `limit_type` 都表示特定的充电限制，例如最小或最大最佳充电量、关机阈值或节能阈值。这些值通常由硬件或固件提供，以指导电池的安全高效使用。	`critical`; `throttled`; `degraded`
`hw.model`	`推荐`	字符串	硬件组件的描述性型号名称	`PERC H740P`; `Intel(R) Core(TM) i7-10700K`; `Dell XPS 15 Battery`
`hw.name`	`推荐`	字符串	硬件组件的一个易于识别的名称	`eth0`
`hw.parent`	`推荐`	字符串	父组件的唯一标识符（通常是机箱或磁盘控制器的 `hw.id` 属性）	`dellStorage_perc_0`
`hw.vendor`	`推荐`	字符串	硬件组件的供应商名称	`Dell`; `HP`; `Intel`; `AMD`; `LSI`; `Lenovo`

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

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

Metric: `hw.battery.time_left`

此指标是推荐的。

名称	Instrument Type	Unit (UCUM)	描述	Stability	实体关联
`hw.battery.time_left`	Gauge	`s`	电池完全充电或放电前剩余的时间。

Attributes

键	需求级别	Value Type	描述	Example Values
`hw.id`	`必需`	字符串	硬件组件的标识符，在监控主机内是唯一的	`win32battery_battery_testsysa33_1`
`hw.state`	`必需`	字符串	组件的当前状态	`degraded`; `failed`; `needs_cleaning`
`hw.battery.state`	`有条件要求` 如果电池正在充电或放电	字符串	电池的当前状态 [1]	`charging`; `discharging`
`hw.battery.capacity`	`推荐`	字符串	设计容量，单位为瓦时或安时	`9.3Ah`; `50Wh`
`hw.battery.chemistry`	`推荐`	字符串	电池化学成分，例如锂离子、镍镉等。	`Li-ion`; `NiMH`
`hw.model`	`推荐`	字符串	硬件组件的描述性型号名称	`PERC H740P`; `Intel(R) Core(TM) i7-10700K`; `Dell XPS 15 Battery`
`hw.name`	`推荐`	字符串	硬件组件的一个易于识别的名称	`eth0`
`hw.parent`	`推荐`	字符串	父组件的唯一标识符（通常是机箱或磁盘控制器的 `hw.id` 属性）	`dellStorage_perc_0`
`hw.vendor`	`推荐`	字符串	硬件组件的供应商名称	`Dell`; `HP`; `Intel`; `AMD`; `LSI`; `Lenovo`

[1] hw.battery.state: hw.state 属性应指示电池的当前状态。它应该是预定义的 States 之一，例如“charging”或“discharging”。

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

值	描述	Stability
`charging`	充电中
`discharging`	放电中

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

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

Metric: `hw.status` (Battery)

此指标是推荐的。

运行状态：对于每种可能的状态，为 1（true）或 0（false）。

使用此指标报告电池状态时，必须设置以下属性

hw.type 必须设置为 "battery"，以指示状态是针对电池的。
hw.state 必须设置为以下值之一，以指示电池状态
- "ok": 电池运行正常。
- "degraded": 电池运行功能或性能下降。
- "failed": 电池已损坏，无法运行。
- "charging": 电池正在充电。
- "discharging": 电池正在放电。

hw.type 属性应指明硬件组件的类型，在本例中是电池。应将其设置为“battery”，以清楚地识别正在监控的组件。

名称	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

键	需求级别	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

Feedback

这个页面有用吗？

谢谢。您的反馈受到赞赏！

请让我们知道我们如何改进此页面。您的反馈受到赞赏！

电池指标的语义约定

电池指标 hw.battery.*

Metric: hw.battery.charge

Metric: hw.battery.charge.limit

Metric: hw.battery.time_left

Metric: hw.status (Battery)

Feedback

电池指标 `hw.battery.*`

Metric: `hw.battery.charge`

Metric: `hw.battery.charge.limit`

Metric: `hw.battery.time_left`

Metric: `hw.status` (Battery)