逻辑磁盘指标的语义约定

逻辑磁盘指标 `hw.logical_disk.*`

由磁盘控制器呈现给操作系统的物理磁盘的存储范围（例如，由 2 个磁盘组成的 RAID 1 集合，由控制器公开为 /dev/hdd0）。

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

所有逻辑磁盘指标都可以包含以下属性

Attributes

键	需求级别	Value Type	描述	Example Values
`hw.id`	`必需`	字符串	硬件组件的标识符，在监控主机内是唯一的	`win32battery_battery_testsysa33_1`
`hw.logical_disk.raid_level`	`推荐`	字符串	逻辑磁盘的 RAID 级别	`RAID0+1`; `RAID5`; `RAID10`
`hw.name`	`推荐`	字符串	硬件组件的一个易于识别的名称	`eth0`
`hw.parent`	`推荐`	字符串	父组件的唯一标识符（通常是机箱或磁盘控制器的 `hw.id` 属性）	`dellStorage_perc_0`

指标: `hw.errors` (逻辑磁盘)

此指标是推荐的。

此逻辑磁盘上遇到的错误数量。

使用此指标时，必须设置以下属性

hw.type 必须设置为 "logical_disk"，以指示错误来自逻辑磁盘。

名称	Instrument Type	Unit (UCUM)	描述	Stability	实体关联
`hw.errors`	Counter	`{error}`	组件遇到的错误数量。

Attributes

键	需求级别	Value Type	描述	Example Values
`hw.id`	`必需`	字符串	硬件组件的标识符，在监控主机内是唯一的	`win32battery_battery_testsysa33_1`
`hw.type`	`必需`	字符串	组件类型 [1]	`battery`; `cpu`; `disk_controller`
`error.type`	`有条件必填`，仅当发生错误时	字符串	组件遇到的错误类型。[2]	`uncorrected`; `zero_buffer_credit`; `crc`; `bad_sector`
`hw.name`	`推荐`	字符串	硬件组件的一个易于识别的名称	`eth0`
`hw.parent`	`推荐`	字符串	父组件的唯一标识符（通常是机箱或磁盘控制器的 `hw.id` 属性）	`dellStorage_perc_0`
`network.io.direction`	`推荐`	字符串	网络错误的网络流量方向。[3]	`receive`; `transmit`

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

[2] error.type: error.type 应与组件报告的错误代码、错误的规范名称或其他低基数错误标识符相匹配。仪器化应记录其报告的错误列表。

[3] network.io.direction: 此属性仅在 hw.type 设置为 "network" 时使用，以指示错误的发生方向。

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

值	描述	Stability
`_OTHER`	当检测不到自定义值时使用的回退错误值。

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

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

值	描述	Stability
`receive`	receive
`transmit`	transmit

指标: `hw.logical_disk.limit`

此指标是推荐的。

逻辑磁盘的大小。

名称	Instrument Type	Unit (UCUM)	描述	Stability	实体关联
`hw.logical_disk.limit`	UpDownCounter	`每个调用的最大内存使用量的分布。`	逻辑磁盘的大小。

Attributes

键	需求级别	Value Type	描述	Example Values
`hw.id`	`必需`	字符串	硬件组件的标识符，在监控主机内是唯一的	`win32battery_battery_testsysa33_1`
`hw.logical_disk.raid_level`	`推荐`	字符串	逻辑磁盘的 RAID 级别	`RAID0+1`; `RAID5`; `RAID10`
`hw.name`	`推荐`	字符串	硬件组件的一个易于识别的名称	`eth0`
`hw.parent`	`推荐`	字符串	父组件的唯一标识符（通常是机箱或磁盘控制器的 `hw.id` 属性）	`dellStorage_perc_0`

指标: `hw.logical_disk.usage`

此指标是推荐的。

逻辑磁盘空间使用情况。

使用此指标时，必须设置以下属性

hw.logical_disk.state 必须设置为以下值之一
- "used": 已使用的磁盘空间量。
- "free": 空闲的磁盘空间量。

名称	Instrument Type	Unit (UCUM)	描述	Stability	实体关联
`hw.logical_disk.usage`	UpDownCounter	`每个调用的最大内存使用量的分布。`	逻辑磁盘空间使用情况。

Attributes

键	需求级别	Value Type	描述	Example Values
`hw.id`	`必需`	字符串	硬件组件的标识符，在监控主机内是唯一的	`win32battery_battery_testsysa33_1`
`hw.logical_disk.state`	`必需`	字符串	逻辑磁盘空间使用情况的状态	`used`; `free`
`hw.logical_disk.raid_level`	`推荐`	字符串	逻辑磁盘的 RAID 级别	`RAID0+1`; `RAID5`; `RAID10`
`hw.name`	`推荐`	字符串	硬件组件的一个易于识别的名称	`eth0`
`hw.parent`	`推荐`	字符串	父组件的唯一标识符（通常是机箱或磁盘控制器的 `hw.id` 属性）	`dellStorage_perc_0`

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

值	描述	Stability
`free`	空闲
`used`	使用中

指标: `hw.logical_disk.utilization`

此指标是推荐的。

逻辑磁盘空间利用率（分数）。

使用此指标时，必须设置以下属性

hw.logical_disk.state 必须设置为以下值之一
- "used": 已使用的磁盘空间比例。
- "free": 空闲的磁盘空间比例。

名称	Instrument Type	Unit (UCUM)	描述	Stability	实体关联
`hw.logical_disk.utilization`	Gauge	`1`	逻辑磁盘空间利用率（分数）。

Attributes

键	需求级别	Value Type	描述	Example Values
`hw.id`	`必需`	字符串	硬件组件的标识符，在监控主机内是唯一的	`win32battery_battery_testsysa33_1`
`hw.logical_disk.state`	`必需`	字符串	逻辑磁盘空间使用情况的状态	`used`; `free`
`hw.logical_disk.raid_level`	`推荐`	字符串	逻辑磁盘的 RAID 级别	`RAID0+1`; `RAID5`; `RAID10`
`hw.name`	`推荐`	字符串	硬件组件的一个易于识别的名称	`eth0`
`hw.parent`	`推荐`	字符串	父组件的唯一标识符（通常是机箱或磁盘控制器的 `hw.id` 属性）	`dellStorage_perc_0`

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

值	描述	Stability
`free`	空闲
`used`	使用中

指标: `hw.status` (逻辑磁盘)

此指标是推荐的。

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

当使用此指标获取逻辑磁盘状态时，必须设置以下属性

hw.type 必须设置为 "logical_disk"，以指示状态为逻辑磁盘。
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

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

指标: hw.errors (逻辑磁盘)

指标: hw.logical_disk.limit

指标: hw.logical_disk.usage

指标: hw.logical_disk.utilization

指标: hw.status (逻辑磁盘)

Feedback

逻辑磁盘指标 `hw.logical_disk.*`

指标: `hw.errors` (逻辑磁盘)

指标: `hw.logical_disk.limit`

指标: `hw.logical_disk.usage`

指标: `hw.logical_disk.utilization`

指标: `hw.status` (逻辑磁盘)