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


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

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

## GPUメトリクス `hw.gpu.*`

Graphics Processing Unit（GPU、ディスクリート）。

### メトリクス: `hw.errors`（GPU）

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

<!-- semconv metric.hw.gpu.errors -->
<!-- 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.errors` | Counter | `{error}` | GPUで発生したエラーの数。 | ![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.type`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/hardware/) | ![Development](https://img.shields.io/badge/-development-blue) | `Required` | string | コンポーネントの種別 [1] | `gpu` |
| [`error.type`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/error/) | ![Stable](https://img.shields.io/badge/-stable-lightgreen) | `Conditionally Required` if and only if an error has occurred | string | コンポーネントで発生したエラーの種別。 [2] | `corrected`; `uncorrected` |
| [`hw.driver_version`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/hardware/) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | ハードウェアコンポーネントのドライバーバージョン | `10.2.1-3` |
| [`hw.firmware_version`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/hardware/) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | ハードウェアコンポーネントのファームウェアバージョン | `2.0.1` |
| [`hw.model`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/hardware/) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | ハードウェアコンポーネントを説明するモデル名 | `PERC H740P`; `Intel(R) Core(TM) i7-10700K`; `Dell XPS 15 Battery` |
| [`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` |
| [`hw.serial_number`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/hardware/) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | ハードウェアコンポーネントのシリアル番号 | `CNFCP0123456789` |
| [`hw.vendor`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/hardware/) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | ハードウェアコンポーネントのベンダー名 | `Dell`; `HP`; `Intel`; `AMD`; `LSI`; `Lenovo` |

**[1] `hw.type`:** `gpu`に設定しなければなりません（MUST）。

**[2] `error.type`:** `error.type`は、エラーの種別を示すために以下のいずれかの値に設定すべきです（SHOULD）。

* `corrected`：GPUが検出し訂正したエラー。
* `uncorrected`：検出されたが、GPUが訂正できなかったエラー。

---

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

| Value | Description | Stability |
| --- | --- | --- |
| `_OTHER` | 計装がカスタム値を定義していない場合に使用する、フォールバック用のエラー値。 | ![Stable](https://img.shields.io/badge/-stable-lightgreen) |

---

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

| Value | Description | Stability |
| --- | --- | --- |
| `battery` | バッテリー | ![Development](https://img.shields.io/badge/-development-blue) |
| `cpu` | CPU | ![Development](https://img.shields.io/badge/-development-blue) |
| `disk_controller` | ディスクコントローラー | ![Development](https://img.shields.io/badge/-development-blue) |
| `enclosure` | エンクロージャー | ![Development](https://img.shields.io/badge/-development-blue) |
| `fan` | ファン | ![Development](https://img.shields.io/badge/-development-blue) |
| `gpu` | GPU | ![Development](https://img.shields.io/badge/-development-blue) |
| `logical_disk` | 論理ディスク | ![Development](https://img.shields.io/badge/-development-blue) |
| `memory` | メモリ | ![Development](https://img.shields.io/badge/-development-blue) |
| `network` | ネットワーク | ![Development](https://img.shields.io/badge/-development-blue) |
| `physical_disk` | 物理ディスク | ![Development](https://img.shields.io/badge/-development-blue) |
| `power_supply` | 電源ユニット | ![Development](https://img.shields.io/badge/-development-blue) |
| `tape_drive` | テープドライブ | ![Development](https://img.shields.io/badge/-development-blue) |
| `temperature` | 温度 | ![Development](https://img.shields.io/badge/-development-blue) |
| `voltage` | 電圧 | ![Development](https://img.shields.io/badge/-development-blue) |

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

### メトリクス: `hw.gpu.io`

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

<!-- semconv metric.hw.gpu.io -->
<!-- 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.gpu.io` | Counter | `By` | GPUが送受信したバイト数。 | ![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` |
| [`network.io.direction`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/network/) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Required` | string | 観測対象ホストの物理または仮想ネットワークインターフェースから見たトラフィックの方向。ステートフルな接続やネットワークフローの論理的な方向を表すために使用すべきではありません（should not）。 | `receive`; `transmit` |
| [`hw.driver_version`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/hardware/) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | ハードウェアコンポーネントのドライバーバージョン | `10.2.1-3` |
| [`hw.firmware_version`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/hardware/) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | ハードウェアコンポーネントのファームウェアバージョン | `2.0.1` |
| [`hw.model`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/hardware/) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | ハードウェアコンポーネントを説明するモデル名 | `PERC H740P`; `Intel(R) Core(TM) i7-10700K`; `Dell XPS 15 Battery` |
| [`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` |
| [`hw.serial_number`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/hardware/) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | ハードウェアコンポーネントのシリアル番号 | `CNFCP0123456789` |
| [`hw.vendor`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/hardware/) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | ハードウェアコンポーネントのベンダー名 | `Dell`; `HP`; `Intel`; `AMD`; `LSI`; `Lenovo` |

---

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

| Value | Description | Stability |
| --- | --- | --- |
| `receive` | receive（受信） | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) |
| `transmit` | transmit（送信） | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) |

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

### メトリクス: `hw.gpu.memory.limit`

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

<!-- semconv metric.hw.gpu.memory.limit -->
<!-- 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.gpu.memory.limit` | UpDownCounter | `By` | GPUメモリのサイズ。 | ![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.driver_version`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/hardware/) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | ハードウェアコンポーネントのドライバーバージョン | `10.2.1-3` |
| [`hw.firmware_version`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/hardware/) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | ハードウェアコンポーネントのファームウェアバージョン | `2.0.1` |
| [`hw.model`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/hardware/) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | ハードウェアコンポーネントを説明するモデル名 | `PERC H740P`; `Intel(R) Core(TM) i7-10700K`; `Dell XPS 15 Battery` |
| [`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` |
| [`hw.serial_number`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/hardware/) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | ハードウェアコンポーネントのシリアル番号 | `CNFCP0123456789` |
| [`hw.vendor`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/hardware/) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | ハードウェアコンポーネントのベンダー名 | `Dell`; `HP`; `Intel`; `AMD`; `LSI`; `Lenovo` |

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

### メトリクス: `hw.gpu.memory.utilization`

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

<!-- semconv metric.hw.gpu.memory.utilization -->
<!-- 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.gpu.memory.utilization` | Gauge | `1` | 使用済みGPUメモリの割合。 | ![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.driver_version`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/hardware/) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | ハードウェアコンポーネントのドライバーバージョン | `10.2.1-3` |
| [`hw.firmware_version`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/hardware/) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | ハードウェアコンポーネントのファームウェアバージョン | `2.0.1` |
| [`hw.model`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/hardware/) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | ハードウェアコンポーネントを説明するモデル名 | `PERC H740P`; `Intel(R) Core(TM) i7-10700K`; `Dell XPS 15 Battery` |
| [`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` |
| [`hw.serial_number`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/hardware/) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | ハードウェアコンポーネントのシリアル番号 | `CNFCP0123456789` |
| [`hw.vendor`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/hardware/) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | ハードウェアコンポーネントのベンダー名 | `Dell`; `HP`; `Intel`; `AMD`; `LSI`; `Lenovo` |

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

### メトリクス: `hw.gpu.memory.usage`

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

<!-- semconv metric.hw.gpu.memory.usage -->
<!-- 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.gpu.memory.usage` | UpDownCounter | `By` | 使用済みGPUメモリ。 | ![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.driver_version`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/hardware/) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | ハードウェアコンポーネントのドライバーバージョン | `10.2.1-3` |
| [`hw.firmware_version`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/hardware/) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | ハードウェアコンポーネントのファームウェアバージョン | `2.0.1` |
| [`hw.model`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/hardware/) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | ハードウェアコンポーネントを説明するモデル名 | `PERC H740P`; `Intel(R) Core(TM) i7-10700K`; `Dell XPS 15 Battery` |
| [`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` |
| [`hw.serial_number`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/hardware/) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | ハードウェアコンポーネントのシリアル番号 | `CNFCP0123456789` |
| [`hw.vendor`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/hardware/) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | ハードウェアコンポーネントのベンダー名 | `Dell`; `HP`; `Intel`; `AMD`; `LSI`; `Lenovo` |

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

### メトリクス: `hw.gpu.utilization`

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

<!-- semconv metric.hw.gpu.utilization -->
<!-- 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.gpu.utilization` | Gauge | `1` | 特定のタスクに費やした時間の割合。 | ![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.driver_version`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/hardware/) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | ハードウェアコンポーネントのドライバーバージョン | `10.2.1-3` |
| [`hw.firmware_version`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/hardware/) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | ハードウェアコンポーネントのファームウェアバージョン | `2.0.1` |
| [`hw.gpu.task`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/hardware/) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | GPUが実行しているタスクの種別 | `decoder`; `encoder`; `general` |
| [`hw.model`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/hardware/) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | ハードウェアコンポーネントを説明するモデル名 | `PERC H740P`; `Intel(R) Core(TM) i7-10700K`; `Dell XPS 15 Battery` |
| [`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` |
| [`hw.serial_number`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/hardware/) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | ハードウェアコンポーネントのシリアル番号 | `CNFCP0123456789` |
| [`hw.vendor`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/hardware/) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | ハードウェアコンポーネントのベンダー名 | `Dell`; `HP`; `Intel`; `AMD`; `LSI`; `Lenovo` |

---

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

| Value | Description | Stability |
| --- | --- | --- |
| `decoder` | Decoder（デコーダー） | ![Development](https://img.shields.io/badge/-development-blue) |
| `encoder` | Encoder（エンコーダー） | ![Development](https://img.shields.io/badge/-development-blue) |
| `general` | General（汎用） | ![Development](https://img.shields.io/badge/-development-blue) |

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

### メトリクス: `hw.status`（GPU）

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

<!-- semconv metric.hw.gpu.status -->
<!-- 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.status` | UpDownCounter | `1` | 動作ステータス：可能な各状態に対して`1`（true）または`0`（false）。 [1] | ![Development](https://img.shields.io/badge/-development-blue) | |

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

**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.state`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/hardware/) | ![Development](https://img.shields.io/badge/-development-blue) | `Required` | string | コンポーネントの現在の状態 [1] | `ok`; `degraded`; `failed`; `predicted_failure` |
| [`hw.type`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/hardware/) | ![Development](https://img.shields.io/badge/-development-blue) | `Required` | string | コンポーネントの種別 [2] | `gpu` |
| [`hw.driver_version`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/hardware/) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | ハードウェアコンポーネントのドライバーバージョン | `10.2.1-3` |
| [`hw.firmware_version`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/hardware/) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | ハードウェアコンポーネントのファームウェアバージョン | `2.0.1` |
| [`hw.model`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/hardware/) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | ハードウェアコンポーネントを説明するモデル名 | `PERC H740P`; `Intel(R) Core(TM) i7-10700K`; `Dell XPS 15 Battery` |
| [`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` |
| [`hw.serial_number`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/hardware/) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | ハードウェアコンポーネントのシリアル番号 | `CNFCP0123456789` |
| [`hw.vendor`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/hardware/) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | ハードウェアコンポーネントのベンダー名 | `Dell`; `HP`; `Intel`; `AMD`; `LSI`; `Lenovo` |

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

* `ok`：GPUは正常に動作しています。
* `degraded`：GPUは機能または性能が低下した状態で動作しています。
* `failed`：GPUは故障し、動作していません。
* `predicted_failure`：GPUは現在動作していますが、近いうちに故障すると予測されています。

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

---

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

| Value | Description | Stability |
| --- | --- | --- |
| `degraded` | Degraded（劣化） | ![Development](https://img.shields.io/badge/-development-blue) |
| `failed` | Failed（故障） | ![Development](https://img.shields.io/badge/-development-blue) |
| `needs_cleaning` | Needs Cleaning（清掃が必要） | ![Development](https://img.shields.io/badge/-development-blue) |
| `ok` | OK（正常） | ![Development](https://img.shields.io/badge/-development-blue) |
| `predicted_failure` | Predicted Failure（故障予測） | ![Development](https://img.shields.io/badge/-development-blue) |

---

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

| Value | Description | Stability |
| --- | --- | --- |
| `battery` | バッテリー | ![Development](https://img.shields.io/badge/-development-blue) |
| `cpu` | CPU | ![Development](https://img.shields.io/badge/-development-blue) |
| `disk_controller` | ディスクコントローラー | ![Development](https://img.shields.io/badge/-development-blue) |
| `enclosure` | エンクロージャー | ![Development](https://img.shields.io/badge/-development-blue) |
| `fan` | ファン | ![Development](https://img.shields.io/badge/-development-blue) |
| `gpu` | GPU | ![Development](https://img.shields.io/badge/-development-blue) |
| `logical_disk` | 論理ディスク | ![Development](https://img.shields.io/badge/-development-blue) |
| `memory` | メモリ | ![Development](https://img.shields.io/badge/-development-blue) |
| `network` | ネットワーク | ![Development](https://img.shields.io/badge/-development-blue) |
| `physical_disk` | 物理ディスク | ![Development](https://img.shields.io/badge/-development-blue) |
| `power_supply` | 電源ユニット | ![Development](https://img.shields.io/badge/-development-blue) |
| `tape_drive` | テープドライブ | ![Development](https://img.shields.io/badge/-development-blue) |
| `temperature` | 温度 | ![Development](https://img.shields.io/badge/-development-blue) |
| `voltage` | 電圧 | ![Development](https://img.shields.io/badge/-development-blue) |

<!-- 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