move common hardware attributes and metrics to registry

.github/ISSUE_TEMPLATE/bug_report.yaml

@@ -44,6 +44,7 @@ body:
         - area:gen-ai
         - area:go
         - area:graphql
+        - area:hardware
         - area:heroku
         - area:host
         - area:http

.github/ISSUE_TEMPLATE/change_proposal.yaml

@@ -37,6 +37,7 @@ body:
         - area:gen-ai
         - area:go
         - area:graphql
+        - area:hardware
         - area:heroku
         - area:host
         - area:http

.github/ISSUE_TEMPLATE/new-conventions.yaml

@@ -46,6 +46,7 @@ body:
         - area:gen-ai
         - area:go
         - area:graphql
+        - area:hardware
         - area:heroku
         - area:host
         - area:http

docs/attributes-registry/README.md

@@ -57,6 +57,7 @@ Currently, the following namespaces exist:
 - [Gen AI](gen-ai.md)
 - [Go](go.md)
 - [GraphQL](graphql.md)
+- [Hardware](hardware.md)
 - [Heroku](heroku.md)
 - [Host](host.md)
 - [HTTP](http.md)

docs/attributes-registry/hardware.md

@@ -0,0 +1,48 @@
+<!--- Hugo front matter used to generate the website version of this page:
+--->
+
+<!-- NOTE: THIS FILE IS AUTOGENERATED. DO NOT EDIT BY HAND. -->
+<!-- see templates/registry/markdown/attribute_namespace.md.j2 -->
+
+# Hardware
+
+## Hardware Attributes
+
+Attributes for hardware.
+
+| Attribute   | Type   | Description                                                                                                   | Examples                            | Stability                                                        |
+| ----------- | ------ | ------------------------------------------------------------------------------------------------------------- | ----------------------------------- | ---------------------------------------------------------------- |
+| `hw.id`     | string | An identifier for the hardware component, unique within the monitored host                                    | `win32battery_battery_testsysa33_1` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| `hw.name`   | string | An easily-recognizable name for the hardware component                                                        | `eth0`                              | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| `hw.parent` | string | Unique identifier of the parent component (typically the `id` attribute of the enclosure, or disk controller) | `dellStorage_perc_0`                | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| `hw.state`  | string | The current state of the component                                                                            | `ok`; `degraded`; `failed`          | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| `hw.type`   | string | Type of the component [1]                                                                                     | `battery`; `cpu`; `disk_controller` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+
+**[1]:** Describes the category of the hardware component for which `hw.state` is being reported. For example, `hw.type=temperature` along with `hw.state=degraded` would indicate that the temperature of the hardware component has been reported as `degraded`.
+
+`hw.state` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
+
+| Value      | Description | Stability                                                        |
+| ---------- | ----------- | ---------------------------------------------------------------- |
+| `degraded` | Degraded    | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| `failed`   | Failed      | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| `ok`       | Ok          | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+
+`hw.type` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
+
+| Value             | Description     | Stability                                                        |
+| ----------------- | --------------- | ---------------------------------------------------------------- |
+| `battery`         | Battery         | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| `cpu`             | CPU             | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| `disk_controller` | Disk controller | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| `enclosure`       | Enclosure       | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| `fan`             | Fan             | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| `gpu`             | GPU             | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| `logical_disk`    | Logical disk    | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| `memory`          | Memory          | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| `network`         | Network         | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| `physical_disk`   | Physical disk   | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| `power_supply`    | Power supply    | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| `tape_drive`      | Tape drive      | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| `temperature`     | Temperature     | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| `voltage`         | Voltage         | ![Experimental](https://img.shields.io/badge/-experimental-blue) |

docs/hardware/README.md

@@ -0,0 +1,17 @@
+<!--- Hugo front matter used to generate the website version of this page:
+linkTitle: Hardware
+--->
+
+# Semantic Conventions for Hardware
+
+**Status**: [Experimental][DocumentStatus]
+
+This document describes instruments and attributes for common hardware level
+metrics in OpenTelemetry. Consider the [general metric semantic conventions](/docs/general/metrics.md#general-metric-semantic-conventions)
+when creating instruments not explicitly defined in the specification.
+
+Semantic conventions for hardware are defined as following:
+
+* [Common Hardware Metrics](common.md): Semantic Conventions for hardware *common* metrics.
+
+[DocumentStatus]: https://github.com/open-telemetry/opentelemetry-specification/tree/v1.31.0/specification/document-status.md