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

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

物理ホストメトリクスに関するセマンティック規約

ステータス: Development

物理ホストメトリクス hw.host.*

仮想システムやコンテナとは異なる物理システム。 例：物理サーバー、スイッチ、ディスクアレイ。

メトリクス: hw.host.ambient_temperature

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

Name	Instrument Type	Unit (UCUM)	Description	Stability	Entity Associations
hw.host.ambient_temperature	Gauge	Cel	物理ホストの周囲（外部）温度。

Attributes:

Key	Stability	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.host.energy

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

Name	Instrument Type	Unit (UCUM)	Description	Stability	Entity Associations
hw.host.energy	Counter	J	物理ホスト全体が消費した合計エネルギー（ジュール単位）。 [1]

[1]: ホストの全体的なエネルギー使用量は、重複する値を合算してしまうことを防ぐため、前節で説明した汎用のhw.energyおよびhw.powerではなく、専用のhw.host.energyおよびhw.host.powerメトリクスのみを使って報告しなければなりません（MUST）。

Attributes:

Key	Stability	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.host.heating_margin

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

Name	Instrument Type	Unit (UCUM)	Description	Stability	Entity Associations
hw.host.heating_margin	Gauge	Cel	内部センサーのいずれかが警告閾値に達するまでに、物理ホストの温度をあと何度（摂氏）上げられるか。

Attributes:

Key	Stability	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.host.power

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

Name	Instrument Type	Unit (UCUM)	Description	Stability	Entity Associations
hw.host.power	Gauge	W	物理ホスト全体が消費している瞬時電力（ワット単位、hw.host.energyの方が推奨される）。 [1]

[1]: ホストの全体的なエネルギー使用量は、重複する値を合算してしまうことを防ぐため、前節で説明した汎用のhw.energyおよびhw.powerではなく、専用のhw.host.energyおよびhw.host.powerメトリクスのみを使って報告しなければなりません（MUST）。

Attributes:

Key	Stability	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