外壳指标的语义约定
状态: 开发中
外壳指标 hw.enclosure.*
计算机机箱（可以是扩展外壳）。
hw.type 必须设置为 "enclosure"。
所有外壳指标都可以包含以下属性
Attributes
| 键 | Stability | 需求级别 | Value Type | 描述 | Example Values |
|---|---|---|---|---|---|
hw.id |  | 必需 | 字符串 | 硬件组件的标识符，在监控主机内是唯一的 | win32battery_battery_testsysa33_1 |
hw.bios_version | | 推荐 | 字符串 | 硬件组件的 BIOS 版本 | 1.2.3 |
hw.enclosure.type | | 推荐 | 字符串 | 外壳的类型（对于模块化系统很有用） | Computer; Storage; Switch |
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.serial_number | | 推荐 | 字符串 | 硬件组件的序列号 | CNFCP0123456789 |
hw.vendor | | 推荐 | 字符串 | 硬件组件的供应商名称 | Dell; HP; Intel; AMD; LSI; Lenovo |
指标：hw.status (外壳)
此指标是推荐的。
运行状态：对于每种可能的状态，为 1（true）或 0（false）。
当使用此指标来指示外壳状态时，必须设置以下属性
hw.type必须设置为"enclosure"以表示状态是针对外壳的。hw.state必须设置为以下值之一，以指示外壳状态"ok"：外壳正常运行。"degraded"：外壳运行功能或性能有所下降。"failed"：外壳已失效且无法运行。"open"：外壳已打开。
| 名称 | 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 | |