> Source: https://www.ymotongpoo.com/works/otel-specs-ja/semconv/hardware/voltage/ # 電圧メトリクスに関するセマンティック規約 **ステータス**: [Development][DocumentStatus] ## 電圧メトリクス `hw.voltage.*` 数値または離散値のいずれかを返す電圧センサー。 ### メトリクス: `hw.voltage` このメトリクスは[推奨（recommended）][MetricRecommended]です。 | Name | Instrument Type | Unit (UCUM) | Description | Stability | Entity Associations | | -------- | --------------- | ----------- | -------------- | --------- | ------ | | `hw.voltage` | Gauge | `V` | センサーが測定した電圧。 | ![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` | | [`hw.sensor_location`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/hardware/) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | センサーの位置 | `cpu0`; `ps1`; `INLET`; `CPU0_DIE`; `AMBIENT`; `MOTHERBOARD`; `PS0 V3_3`; `MAIN_12V`; `CPU_VCORE` | ### メトリクス: `hw.voltage.limit` このメトリクスは[推奨（recommended）][MetricRecommended]です。 | Name | Instrument Type | Unit (UCUM) | Description | Stability | Entity Associations | | -------- | --------------- | ----------- | -------------- | --------- | ------ | | `hw.voltage.limit` | Gauge | `V` | ボルトで表した電圧の上限。 | ![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.limit_type`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/hardware/) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | ハードウェアコンポーネントの限界値の種別 | `low.critical`; `low.degraded`; `high.degraded`; `high.critical` | | [`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.sensor_location`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/hardware/) | ![Development](https://img.shields.io/badge/-development-blue) | `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（危険） | ![Development](https://img.shields.io/badge/-development-blue) | | `degraded` | Degraded（劣化） | ![Development](https://img.shields.io/badge/-development-blue) | | `high.critical` | High Critical（高側の危険） | ![Development](https://img.shields.io/badge/-development-blue) | | `high.degraded` | High Degraded（高側の劣化） | ![Development](https://img.shields.io/badge/-development-blue) | | `low.critical` | Low Critical（低側の危険） | ![Development](https://img.shields.io/badge/-development-blue) | | `low.degraded` | Low Degraded（低側の劣化） | ![Development](https://img.shields.io/badge/-development-blue) | | `max` | Maximum（最大） | ![Development](https://img.shields.io/badge/-development-blue) | | `throttled` | Throttled（抑制） | ![Development](https://img.shields.io/badge/-development-blue) | | `turbo` | Turbo（ターボ） | ![Development](https://img.shields.io/badge/-development-blue) | ### メトリクス: `hw.voltage.nominal` このメトリクスは[推奨（recommended）][MetricRecommended]です。 | Name | Instrument Type | Unit (UCUM) | Description | Stability | Entity Associations | | -------- | --------------- | ----------- | -------------- | --------- | ------ | | `hw.voltage.nominal` | Gauge | `V` | 公称（想定）電圧。 | ![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` | | [`hw.sensor_location`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/hardware/) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | センサーの位置 | `cpu0`; `ps1`; `INLET`; `CPU0_DIE`; `AMBIENT`; `MOTHERBOARD`; `PS0 V3_3`; `MAIN_12V`; `CPU_VCORE` | ### メトリクス: `hw.status`（電圧） このメトリクスは[推奨（recommended）][MetricRecommended]です。 | 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` | | [`hw.type`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/hardware/) | ![Development](https://img.shields.io/badge/-development-blue) | `Required` | string | コンポーネントの種別 [2] | `voltage` | | [`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.sensor_location`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/hardware/) | ![Development](https://img.shields.io/badge/-development-blue) | `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（劣化） | ![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) | [DocumentStatus]: https://opentelemetry.io/docs/specs/otel/document-status [MetricRecommended]: /works/otel-specs-ja/semconv/general/metric-requirement-level/#recommended