> Source: https://www.ymotongpoo.com/works/otel-specs-ja/semconv/hardware/host/


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

**ステータス**: [Development][DocumentStatus]

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

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

### メトリクス: `hw.host.ambient_temperature`

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

<!-- semconv metric.hw.host.ambient_temperature -->
<!-- NOTE: THIS TEXT IS AUTOGENERATED. DO NOT EDIT BY HAND. -->
<!-- see templates/registry/markdown/snippet.md.j2 -->
<!-- prettier-ignore-start -->

| Name | Instrument Type | Unit (UCUM) | Description | Stability | Entity Associations |
| -------- | --------------- | ----------- | -------------- | --------- | ------ |
| `hw.host.ambient_temperature` | Gauge | `Cel` | 物理ホストの周囲（外部）温度。 | ![Development](https://img.shields.io/badge/-development-blue) | |

**Attributes:**

| Key | Stability | [Requirement Level](/works/otel-specs-ja/semconv/general/attribute-requirement-level/) | Value Type | Description | Example Values |
| --- | --- | --- | --- | --- | --- |
| [`hw.id`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/hardware/) | ![Development](https://img.shields.io/badge/-development-blue) | `Required` | string | 監視対象のホスト内で一意な、ハードウェアコンポーネントの識別子 | `win32battery_battery_testsysa33_1` |
| [`hw.name`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/hardware/) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | ハードウェアコンポーネントの、見てすぐわかる名前 | `eth0` |
| [`hw.parent`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/hardware/) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | 親コンポーネントの一意識別子（通常はエンクロージャーまたはディスクコントローラーの`hw.id`属性） | `dellStorage_perc_0` |

<!-- prettier-ignore-end -->
<!-- END AUTOGENERATED TEXT -->
<!-- endsemconv -->

### メトリクス: `hw.host.energy`

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

<!-- semconv metric.hw.host.energy -->
<!-- NOTE: THIS TEXT IS AUTOGENERATED. DO NOT EDIT BY HAND. -->
<!-- see templates/registry/markdown/snippet.md.j2 -->
<!-- prettier-ignore-start -->

| Name | Instrument Type | Unit (UCUM) | Description | Stability | Entity Associations |
| -------- | --------------- | ----------- | -------------- | --------- | ------ |
| `hw.host.energy` | Counter | `J` | 物理ホスト全体が消費した合計エネルギー（ジュール単位）。 [1] | ![Development](https://img.shields.io/badge/-development-blue) | |

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

**Attributes:**

| Key | Stability | [Requirement Level](/works/otel-specs-ja/semconv/general/attribute-requirement-level/) | Value Type | Description | Example Values |
| --- | --- | --- | --- | --- | --- |
| [`hw.id`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/hardware/) | ![Development](https://img.shields.io/badge/-development-blue) | `Required` | string | 監視対象のホスト内で一意な、ハードウェアコンポーネントの識別子 | `win32battery_battery_testsysa33_1` |
| [`hw.name`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/hardware/) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | ハードウェアコンポーネントの、見てすぐわかる名前 | `eth0` |
| [`hw.parent`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/hardware/) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | 親コンポーネントの一意識別子（通常はエンクロージャーまたはディスクコントローラーの`hw.id`属性） | `dellStorage_perc_0` |

<!-- prettier-ignore-end -->
<!-- END AUTOGENERATED TEXT -->
<!-- endsemconv -->

### メトリクス: `hw.host.heating_margin`

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

<!-- semconv metric.hw.host.heating_margin -->
<!-- NOTE: THIS TEXT IS AUTOGENERATED. DO NOT EDIT BY HAND. -->
<!-- see templates/registry/markdown/snippet.md.j2 -->
<!-- prettier-ignore-start -->

| Name | Instrument Type | Unit (UCUM) | Description | Stability | Entity Associations |
| -------- | --------------- | ----------- | -------------- | --------- | ------ |
| `hw.host.heating_margin` | Gauge | `Cel` | 内部センサーのいずれかが警告閾値に達するまでに、物理ホストの温度をあと何度（摂氏）上げられるか。 | ![Development](https://img.shields.io/badge/-development-blue) | |

**Attributes:**

| Key | Stability | [Requirement Level](/works/otel-specs-ja/semconv/general/attribute-requirement-level/) | Value Type | Description | Example Values |
| --- | --- | --- | --- | --- | --- |
| [`hw.id`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/hardware/) | ![Development](https://img.shields.io/badge/-development-blue) | `Required` | string | 監視対象のホスト内で一意な、ハードウェアコンポーネントの識別子 | `win32battery_battery_testsysa33_1` |
| [`hw.name`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/hardware/) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | ハードウェアコンポーネントの、見てすぐわかる名前 | `eth0` |
| [`hw.parent`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/hardware/) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | 親コンポーネントの一意識別子（通常はエンクロージャーまたはディスクコントローラーの`hw.id`属性） | `dellStorage_perc_0` |

<!-- prettier-ignore-end -->
<!-- END AUTOGENERATED TEXT -->
<!-- endsemconv -->

### メトリクス: `hw.host.power`

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

<!-- semconv metric.hw.host.power -->
<!-- NOTE: THIS TEXT IS AUTOGENERATED. DO NOT EDIT BY HAND. -->
<!-- see templates/registry/markdown/snippet.md.j2 -->
<!-- prettier-ignore-start -->

| Name | Instrument Type | Unit (UCUM) | Description | Stability | Entity Associations |
| -------- | --------------- | ----------- | -------------- | --------- | ------ |
| `hw.host.power` | Gauge | `W` | 物理ホスト全体が消費している瞬時電力（ワット単位、`hw.host.energy`の方が推奨される）。 [1] | ![Development](https://img.shields.io/badge/-development-blue) | |

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

**Attributes:**

| Key | Stability | [Requirement Level](/works/otel-specs-ja/semconv/general/attribute-requirement-level/) | Value Type | Description | Example Values |
| --- | --- | --- | --- | --- | --- |
| [`hw.id`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/hardware/) | ![Development](https://img.shields.io/badge/-development-blue) | `Required` | string | 監視対象のホスト内で一意な、ハードウェアコンポーネントの識別子 | `win32battery_battery_testsysa33_1` |
| [`hw.name`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/hardware/) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | ハードウェアコンポーネントの、見てすぐわかる名前 | `eth0` |
| [`hw.parent`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/hardware/) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | 親コンポーネントの一意識別子（通常はエンクロージャーまたはディスクコントローラーの`hw.id`属性） | `dellStorage_perc_0` |

<!-- prettier-ignore-end -->
<!-- END AUTOGENERATED TEXT -->
<!-- endsemconv -->

[DocumentStatus]: https://opentelemetry.io/docs/specs/otel/document-status
[MetricRecommended]: /works/otel-specs-ja/semconv/general/metric-requirement-level/#recommended