電圧メトリクスに関するセマンティック規約

ステータス: Development

電圧メトリクス `hw.voltage.*`

数値または離散値のいずれかを返す電圧センサー。

メトリクス: `hw.voltage`

Name	Instrument Type	Unit (UCUM)	Description	Stability	Entity Associations
`hw.voltage`	Gauge	`V`	センサーが測定した電圧。

Attributes:

Key	Requirement Level	Value Type	Description	Example Values
`hw.id`	`Required`	string	監視対象のホスト内で一意な、ハードウェアコンポーネントの識別子	`win32battery_battery_testsysa33_1`
`hw.name`	`Recommended`	string	ハードウェアコンポーネントの、見てすぐわかる名前	`eth0`
`hw.parent`	`Recommended`	string	親コンポーネントの一意識別子（通常はエンクロージャーまたはディスクコントローラーの`hw.id`属性）	`dellStorage_perc_0`
`hw.sensor_location`	`Recommended`	string	センサーの位置	`cpu0`; `ps1`; `INLET`; `CPU0_DIE`; `AMBIENT`; `MOTHERBOARD`; `PS0 V3_3`; `MAIN_12V`; `CPU_VCORE`

メトリクス: `hw.voltage.limit`

このメトリクスは推奨（recommended）です。

Name	Instrument Type	Unit (UCUM)	Description	Stability	Entity Associations
`hw.voltage.limit`	Gauge	`V`	ボルトで表した電圧の上限。

Attributes:

Key	Requirement Level	Value Type	Description	Example Values
`hw.id`	`Required`	string	監視対象のホスト内で一意な、ハードウェアコンポーネントの識別子	`win32battery_battery_testsysa33_1`
`hw.limit_type`	`Recommended`	string	ハードウェアコンポーネントの限界値の種別	`low.critical`; `low.degraded`; `high.degraded`; `high.critical`
`hw.name`	`Recommended`	string	ハードウェアコンポーネントの、見てすぐわかる名前	`eth0`
`hw.parent`	`Recommended`	string	親コンポーネントの一意識別子（通常はエンクロージャーまたはディスクコントローラーの`hw.id`属性）	`dellStorage_perc_0`
`hw.sensor_location`	`Recommended`	string	センサーの位置	`cpu0`; `ps1`; `INLET`; `CPU0_DIE`; `AMBIENT`; `MOTHERBOARD`; `PS0 V3_3`; `MAIN_12V`; `CPU_VCORE`

hw.limit_typeには、以下のよく知られた値のリストがあります。これらのいずれかが該当する場合は、対応する値を使用しなければならず（MUST）、そうでない場合はカスタム値を使用してもよい（MAY）です。

Value	Description	Stability
`critical`	Critical（危険）
`degraded`	Degraded（劣化）
`high.critical`	High Critical（高側の危険）
`high.degraded`	High Degraded（高側の劣化）
`low.critical`	Low Critical（低側の危険）
`low.degraded`	Low Degraded（低側の劣化）
`max`	Maximum（最大）
`throttled`	Throttled（抑制）
`turbo`	Turbo（ターボ）

メトリクス: `hw.voltage.nominal`

このメトリクスは推奨（recommended）です。

Name	Instrument Type	Unit (UCUM)	Description	Stability	Entity Associations
`hw.voltage.nominal`	Gauge	`V`	公称（想定）電圧。

Attributes:

Key	Requirement Level	Value Type	Description	Example Values
`hw.id`	`Required`	string	監視対象のホスト内で一意な、ハードウェアコンポーネントの識別子	`win32battery_battery_testsysa33_1`
`hw.name`	`Recommended`	string	ハードウェアコンポーネントの、見てすぐわかる名前	`eth0`
`hw.parent`	`Recommended`	string	親コンポーネントの一意識別子（通常はエンクロージャーまたはディスクコントローラーの`hw.id`属性）	`dellStorage_perc_0`
`hw.sensor_location`	`Recommended`	string	センサーの位置	`cpu0`; `ps1`; `INLET`; `CPU0_DIE`; `AMBIENT`; `MOTHERBOARD`; `PS0 V3_3`; `MAIN_12V`; `CPU_VCORE`

メトリクス: `hw.status`（電圧）

このメトリクスは推奨（recommended）です。

Name	Instrument Type	Unit (UCUM)	Description	Stability	Entity Associations
`hw.status`	UpDownCounter	`1`	動作ステータス：可能な各状態に対して`1`（true）または`0`（false）。 [1]

[1]: hw.statusは現在UpDownCounterとして規定されていますが、理想的にはOpenMetricsで定義されているStateSetを使って表現されるべきです。StateSetがOpenTelemetryで規定された時点で、このセマンティック規約は更新されます。この予定されている変更は、ユーザーが時系列バックエンドに対してhw.statusの値を時系列で取得する方法に影響を与えることは想定されていません。

Attributes:

Key	Requirement Level	Value Type	Description	Example Values
`hw.id`	`Required`	string	監視対象のホスト内で一意な、ハードウェアコンポーネントの識別子	`win32battery_battery_testsysa33_1`
`hw.state`	`Required`	string	コンポーネントの現在の状態 [1]	`ok`; `degraded`; `failed`
`hw.type`	`Required`	string	コンポーネントの種別 [2]	`voltage`
`hw.name`	`Recommended`	string	ハードウェアコンポーネントの、見てすぐわかる名前	`eth0`
`hw.parent`	`Recommended`	string	親コンポーネントの一意識別子（通常はエンクロージャーまたはディスクコントローラーの`hw.id`属性）	`dellStorage_perc_0`
`hw.sensor_location`	`Recommended`	string	センサーの位置	`cpu0`; `ps1`; `INLET`; `CPU0_DIE`; `AMBIENT`; `MOTHERBOARD`; `PS0 V3_3`; `MAIN_12V`; `CPU_VCORE`

[1] hw.state: 以下のいずれかの値に設定しなければなりません（MUST）。

ok：電圧は正常な範囲内です。
degraded：電圧は正常な範囲外ですが、危険な状態ではありません。
failed：電圧は危険なレベルにあります。

[2] hw.type: voltageに設定しなければなりません（MUST）。

hw.stateには、以下のよく知られた値のリストがあります。これらのいずれかが該当する場合は、対応する値を使用しなければならず（MUST）、そうでない場合はカスタム値を使用してもよい（MAY）です。

Value	Description	Stability
`degraded`	Degraded（劣化）
`failed`	Failed（故障）
`needs_cleaning`	Needs Cleaning（清掃が必要）
`ok`	OK（正常）
`predicted_failure`	Predicted Failure（故障予測）

hw.typeには、以下のよく知られた値のリストがあります。これらのいずれかが該当する場合は、対応する値を使用しなければならず（MUST）、そうでない場合はカスタム値を使用してもよい（MAY）です。

Value	Description	Stability
`battery`	バッテリー
`cpu`	CPU
`disk_controller`	ディスクコントローラー
`enclosure`	エンクロージャー
`fan`	ファン
`gpu`	GPU
`logical_disk`	論理ディスク
`memory`	メモリ
`network`	ネットワーク
`physical_disk`	物理ディスク
`power_supply`	電源ユニット
`tape_drive`	テープドライブ
`temperature`	温度
`voltage`	電圧

電圧メトリクスに関するセマンティック規約

電圧メトリクス hw.voltage.*

メトリクス: hw.voltage

メトリクス: hw.voltage.limit

メトリクス: hw.voltage.nominal

メトリクス: hw.status（電圧）

電圧メトリクス `hw.voltage.*`

メトリクス: `hw.voltage`

メトリクス: `hw.voltage.limit`

メトリクス: `hw.voltage.nominal`

メトリクス: `hw.status`（電圧）