この記事は英語の原文を日本語に翻訳したものです。原文: https://opentelemetry.io/docs/specs/semconv/hardware/logical-disk/
翻訳元: open-telemetry/semantic-conventions v1.44.0（コミット e10a930）
論理ディスクメトリクスに関するセマンティック規約
ステータス: Development
論理ディスクメトリクス hw.logical_disk.*
ディスクコントローラーがオペレーティングシステムに物理ディスクとして提示するストレージ領域（例：2台のディスクで構成されたRAID 1セットを、コントローラーが/dev/hdd0として公開する場合）。
メトリクス: hw.errors（論理ディスク）
このメトリクスは推奨（recommended）です。
| Name | Instrument Type | Unit (UCUM) | Description | Stability | Entity Associations |
|---|---|---|---|---|---|
hw.errors | Counter | {error} | この論理ディスクで発生したエラーの数。 |  |
Attributes:
| Key | Stability | Requirement Level | Value Type | Description | Example Values |
|---|---|---|---|---|---|
hw.id | | Required | string | 監視対象のホスト内で一意な、ハードウェアコンポーネントの識別子 | win32battery_battery_testsysa33_1 |
hw.type | | Required | string | コンポーネントの種別 [1] | logical_disk |
error.type |  | Conditionally Required if and only if an error has occurred | string | コンポーネントで発生したエラーの種別。 [2] | uncorrected; zero_buffer_credit; crc; bad_sector |
hw.logical_disk.raid_level | | Recommended | string | 論理ディスクのRAIDレベル | RAID0+1; RAID5; RAID10 |
hw.name | | Recommended | string | ハードウェアコンポーネントの、見てすぐわかる名前 | eth0 |
hw.parent | | Recommended | string | 親コンポーネントの一意識別子（通常はエンクロージャーまたはディスクコントローラーのhw.id属性） | dellStorage_perc_0 |
[1] hw.type: logical_diskに設定しなければなりません（MUST）。
[2] error.type: error.typeは、コンポーネントが報告するエラーコード、エラーの正式名称、またはそれ以外の低カーディナリティなエラー識別子と一致すべきです（SHOULD）。計装は、報告するエラーの一覧を文書化すべきです（SHOULD）。
error.typeには、以下のよく知られた値のリストがあります。これらのいずれかが該当する場合は、対応する値を使用しなければならず（MUST）、そうでない場合はカスタム値を使用してもよい（MAY）です。
| Value | Description | Stability |
|---|---|---|
_OTHER | 計装がカスタム値を定義していない場合に使用する、フォールバック用のエラー値。 | |
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 | 電圧 | |
メトリクス: hw.logical_disk.limit
このメトリクスは推奨（recommended）です。
| Name | Instrument Type | Unit (UCUM) | Description | Stability | Entity Associations |
|---|---|---|---|---|---|
hw.logical_disk.limit | UpDownCounter | By | 論理ディスクのサイズ。 | |
Attributes:
| Key | Stability | Requirement Level | Value Type | Description | Example Values |
|---|---|---|---|---|---|
hw.id | | Required | string | 監視対象のホスト内で一意な、ハードウェアコンポーネントの識別子 | win32battery_battery_testsysa33_1 |
hw.logical_disk.raid_level | | Recommended | string | 論理ディスクのRAIDレベル | RAID0+1; RAID5; RAID10 |
hw.name | | Recommended | string | ハードウェアコンポーネントの、見てすぐわかる名前 | eth0 |
hw.parent | | Recommended | string | 親コンポーネントの一意識別子（通常はエンクロージャーまたはディスクコントローラーのhw.id属性） | dellStorage_perc_0 |
メトリクス: hw.logical_disk.usage
このメトリクスは推奨（recommended）です。
| Name | Instrument Type | Unit (UCUM) | Description | Stability | Entity Associations |
|---|---|---|---|---|---|
hw.logical_disk.usage | UpDownCounter | By | 論理ディスクの空き容量の使用状況。 | |
Attributes:
| Key | Stability | Requirement Level | Value Type | Description | Example Values |
|---|---|---|---|---|---|
hw.id | | Required | string | 監視対象のホスト内で一意な、ハードウェアコンポーネントの識別子 | win32battery_battery_testsysa33_1 |
hw.logical_disk.state | | Required | string | 論理ディスク空き容量の使用状態 | used; free |
hw.logical_disk.raid_level | | Recommended | string | 論理ディスクのRAIDレベル | RAID0+1; RAID5; RAID10 |
hw.name | | Recommended | string | ハードウェアコンポーネントの、見てすぐわかる名前 | eth0 |
hw.parent | | Recommended | string | 親コンポーネントの一意識別子（通常はエンクロージャーまたはディスクコントローラーのhw.id属性） | dellStorage_perc_0 |
hw.logical_disk.stateには、以下のよく知られた値のリストがあります。これらのいずれかが該当する場合は、対応する値を使用しなければならず（MUST）、そうでない場合はカスタム値を使用してもよい（MAY）です。
| Value | Description | Stability |
|---|---|---|
free | Free（空き） | |
used | Used（使用済み） | |
メトリクス: hw.logical_disk.utilization
このメトリクスは推奨（recommended）です。
| Name | Instrument Type | Unit (UCUM) | Description | Stability | Entity Associations |
|---|---|---|---|---|---|
hw.logical_disk.utilization | Gauge | 1 | 論理ディスクの空き容量の使用率。 | |
Attributes:
| Key | Stability | Requirement Level | Value Type | Description | Example Values |
|---|---|---|---|---|---|
hw.id | | Required | string | 監視対象のホスト内で一意な、ハードウェアコンポーネントの識別子 | win32battery_battery_testsysa33_1 |
hw.logical_disk.state | | Required | string | 論理ディスク空き容量の使用状態 | used; free |
hw.logical_disk.raid_level | | Recommended | string | 論理ディスクのRAIDレベル | RAID0+1; RAID5; RAID10 |
hw.name | | Recommended | string | ハードウェアコンポーネントの、見てすぐわかる名前 | eth0 |
hw.parent | | Recommended | string | 親コンポーネントの一意識別子（通常はエンクロージャーまたはディスクコントローラーのhw.id属性） | dellStorage_perc_0 |
hw.logical_disk.stateには、以下のよく知られた値のリストがあります。これらのいずれかが該当する場合は、対応する値を使用しなければならず（MUST）、そうでない場合はカスタム値を使用してもよい（MAY）です。
| Value | Description | Stability |
|---|---|---|
free | Free（空き） | |
used | Used（使用済み） | |
メトリクス: 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] | logical_disk |
hw.logical_disk.raid_level | | Recommended | string | 論理ディスクのRAIDレベル | RAID0+1; RAID5; RAID10 |
hw.name | | Recommended | string | ハードウェアコンポーネントの、見てすぐわかる名前 | eth0 |
hw.parent | | Recommended | string | 親コンポーネントの一意識別子（通常はエンクロージャーまたはディスクコントローラーのhw.id属性） | dellStorage_perc_0 |
[1] hw.state: 以下のいずれかの値に設定しなければなりません（MUST）。
ok：論理ディスクは正常に動作しています。degraded：論理ディスクは機能または性能が低下した状態で動作しています。failed：論理ディスクは故障し、動作していません。
[2] hw.type: logical_diskに設定しなければなりません（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 | 電圧 | |