この記事は英語の原文を日本語に翻訳したものです。原文: https://opentelemetry.io/docs/specs/semconv/hardware/power-supply/

翻訳元: open-telemetry/semantic-conventions v1.44.0（コミット e10a930）

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

ステータス: Development

電源ユニットメトリクス hw.power_supply.*

マザーボードとGPUが使用する交流電流を直流に変換する電源ユニット。

メトリクス: hw.power_supply.limit

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

Name	Instrument Type	Unit (UCUM)	Description	Stability	Entity Associations
hw.power_supply.limit	UpDownCounter	W	電源ユニットの最大出力。

Attributes:

Key	Stability	Requirement Level	Value Type	Description	Example Values
hw.id		Required	string	監視対象のホスト内で一意な、ハードウェアコンポーネントの識別子	win32battery_battery_testsysa33_1
hw.limit_type		Recommended	string	ハードウェアコンポーネントの限界値の種別	max; critical; throttled
hw.model		Recommended	string	ハードウェアコンポーネントを説明するモデル名	PERC H740P; Intel(R) Core(TM) i7-10700K; Dell XPS 15 Battery
hw.name		Recommended	string	ハードウェアコンポーネントの、見てすぐわかる名前	eth0
hw.parent		Recommended	string	親コンポーネントの一意識別子（通常はエンクロージャーまたはディスクコントローラーのhw.id属性）	dellStorage_perc_0
hw.serial_number		Recommended	string	ハードウェアコンポーネントのシリアル番号	CNFCP0123456789
hw.vendor		Recommended	string	ハードウェアコンポーネントのベンダー名	Dell; HP; Intel; AMD; LSI; Lenovo

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.power_supply.utilization

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

Name	Instrument Type	Unit (UCUM)	Description	Stability	Entity Associations
hw.power_supply.utilization	Gauge	1	電源ユニットの最大出力に対する利用率。

Attributes:

Key	Stability	Requirement Level	Value Type	Description	Example Values
hw.id		Required	string	監視対象のホスト内で一意な、ハードウェアコンポーネントの識別子	win32battery_battery_testsysa33_1
hw.model		Recommended	string	ハードウェアコンポーネントを説明するモデル名	PERC H740P; Intel(R) Core(TM) i7-10700K; Dell XPS 15 Battery
hw.name		Recommended	string	ハードウェアコンポーネントの、見てすぐわかる名前	eth0
hw.parent		Recommended	string	親コンポーネントの一意識別子（通常はエンクロージャーまたはディスクコントローラーのhw.id属性）	dellStorage_perc_0
hw.serial_number		Recommended	string	ハードウェアコンポーネントのシリアル番号	CNFCP0123456789
hw.vendor		Recommended	string	ハードウェアコンポーネントのベンダー名	Dell; HP; Intel; AMD; LSI; Lenovo

メトリクス: hw.power_supply.usage

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

Name	Instrument Type	Unit (UCUM)	Description	Stability	Entity Associations
hw.power_supply.usage	UpDownCounter	W	電源ユニットの現在の出力。

Attributes:

Key	Stability	Requirement Level	Value Type	Description	Example Values
hw.id		Required	string	監視対象のホスト内で一意な、ハードウェアコンポーネントの識別子	win32battery_battery_testsysa33_1
hw.model		Recommended	string	ハードウェアコンポーネントを説明するモデル名	PERC H740P; Intel(R) Core(TM) i7-10700K; Dell XPS 15 Battery
hw.name		Recommended	string	ハードウェアコンポーネントの、見てすぐわかる名前	eth0
hw.parent		Recommended	string	親コンポーネントの一意識別子（通常はエンクロージャーまたはディスクコントローラーのhw.id属性）	dellStorage_perc_0
hw.serial_number		Recommended	string	ハードウェアコンポーネントのシリアル番号	CNFCP0123456789
hw.vendor		Recommended	string	ハードウェアコンポーネントのベンダー名	Dell; HP; Intel; AMD; LSI; Lenovo

メトリクス: 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	Stability	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]	power_supply
hw.model		Recommended	string	ハードウェアコンポーネントを説明するモデル名	PERC H740P; Intel(R) Core(TM) i7-10700K; Dell XPS 15 Battery
hw.name		Recommended	string	ハードウェアコンポーネントの、見てすぐわかる名前	eth0
hw.parent		Recommended	string	親コンポーネントの一意識別子（通常はエンクロージャーまたはディスクコントローラーのhw.id属性）	dellStorage_perc_0
hw.serial_number		Recommended	string	ハードウェアコンポーネントのシリアル番号	CNFCP0123456789
hw.vendor		Recommended	string	ハードウェアコンポーネントのベンダー名	Dell; HP; Intel; AMD; LSI; Lenovo

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

• ok：電源ユニットは正常に動作しています。
• degraded：電源ユニットは機能または性能が低下した状態で動作しています。
• failed：電源ユニットは故障し、動作していません。

[2] hw.type: power_supplyに設定しなければなりません（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	電圧