Merge branch 'main' into add_k8s_volume_type

.chloggen/add_container_cpu_usage.yaml

@@ -0,0 +1,22 @@
+# Use this changelog template to create an entry for release notes.
+#
+# If your change doesn't affect end users you should instead start
+# your pull request title with [chore] or use the "Skip Changelog" label.
+
+# One of 'breaking', 'deprecation', 'new_component', 'enhancement', 'bug_fix'
+change_type: enhancement
+
+# The name of the area of concern in the attributes-registry, (e.g. http, cloud, db)
+component: container
+
+# A brief description of the change. Surround your text with quotes ("") if it needs to start with a backtick (`).
+note: Add container.cpu.usage metric
+
+# Mandatory: One or more tracking issues related to the change. You can use the PR number here if no issue exists.
+# The values here must be integers.
+issues: [1128]
+
+# (Optional) One or more lines of additional information to render under the primary note.
+# These lines will be padded with 2 spaces and then inserted directly into the document.
+# Use pipe (|) for multiline entries.
+subtext:

.github/ISSUE_TEMPLATE/bug_report.yaml

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

.github/ISSUE_TEMPLATE/change_proposal.yaml

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

.github/ISSUE_TEMPLATE/new-conventions.yaml

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

docs/attributes-registry/README.md

@@ -61,6 +61,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 `hw.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/database/README.md

@@ -15,7 +15,7 @@ database metrics and logs.
 > **Warning**
 > Existing database instrumentations that are using
 > [v1.24.0 of this document](https://github.com/open-telemetry/semantic-conventions/blob/v1.24.0/docs/database/README.md)
-> (or prior) SHOULD NOT change the version of the database conventions that they emit
+> (or prior) SHOULD NOT change the version of the database conventions that they emit by default
 > until a transition plan to the (future) stable semantic conventions has been published.
 > Conventions include, but are not limited to, attributes, metric and span names, and unit of measure.
 

docs/database/cassandra.md

@@ -12,7 +12,7 @@ The Semantic Conventions for [Cassandra](https://cassandra.apache.org/) extend a
 
 ## Attributes
 
-<!-- semconv db.cassandra(full) -->
+<!-- semconv db.cassandra -->
 <!-- NOTE: THIS TEXT IS AUTOGENERATED. DO NOT EDIT BY HAND. -->
 <!-- see templates/registry/markdown/snippet.md.j2 -->
 <!-- prettier-ignore-start -->

docs/database/cosmosdb.md

@@ -15,7 +15,7 @@ extend and override the [Database Semantic Conventions](database-spans.md).
 
 Cosmos DB instrumentation includes call-level (public API) surface spans and network spans. Depending on the connection mode (Gateway or Direct), network-level spans may also be created.
 
-<!-- semconv db.cosmosdb(full) -->
+<!-- semconv db.cosmosdb -->
 <!-- NOTE: THIS TEXT IS AUTOGENERATED. DO NOT EDIT BY HAND. -->
 <!-- see templates/registry/markdown/snippet.md.j2 -->
 <!-- prettier-ignore-start -->

docs/database/couchdb.md

@@ -12,7 +12,7 @@ The Semantic Conventions for [CouchDB](https://couchdb.apache.org/) extend and o
 
 ## Attributes
 
-<!-- semconv db.couchdb(full) -->
+<!-- semconv db.couchdb -->
 <!-- NOTE: THIS TEXT IS AUTOGENERATED. DO NOT EDIT BY HAND. -->
 <!-- see templates/registry/markdown/snippet.md.j2 -->
 <!-- prettier-ignore-start -->

docs/database/database-metrics.md

@@ -36,7 +36,7 @@ and attributes but more may be added in the future.
 > [v1.24.0 of this document](https://github.com/open-telemetry/semantic-conventions/blob/v1.24.0/docs/database/database-spans.md)
 > (or prior):
 >
-> * SHOULD NOT change the version of the database conventions that they emit
+> * SHOULD NOT change the version of the database conventions that they emit by default
 >   until the database semantic conventions are marked stable.
 >   Conventions include, but are not limited to, attributes,
 >   metric and span names, and unit of measure.
@@ -91,7 +91,7 @@ of `[ 0.001, 0.005, 0.01, 0.05, 0.1, 0.5, 1, 5, 10 ]`.
 <!-- END AUTOGENERATED TEXT -->
 <!-- endsemconv -->
 
-<!-- semconv metric.db.client.operation.duration(full) -->
+<!-- semconv metric.db.client.operation.duration -->
 <!-- NOTE: THIS TEXT IS AUTOGENERATED. DO NOT EDIT BY HAND. -->
 <!-- see templates/registry/markdown/snippet.md.j2 -->
 <!-- prettier-ignore-start -->
@@ -234,7 +234,7 @@ This metric is [required][MetricRequired].
 <!-- END AUTOGENERATED TEXT -->
 <!-- endsemconv -->
 
-<!-- semconv metric.db.client.connection.count(full) -->
+<!-- semconv metric.db.client.connection.count -->
 <!-- NOTE: THIS TEXT IS AUTOGENERATED. DO NOT EDIT BY HAND. -->
 <!-- see templates/registry/markdown/snippet.md.j2 -->
 <!-- prettier-ignore-start -->
@@ -280,7 +280,7 @@ This metric is [recommended][MetricRecommended].
 <!-- END AUTOGENERATED TEXT -->
 <!-- endsemconv -->
 
-<!-- semconv metric.db.client.connection.idle.max(full) -->
+<!-- semconv metric.db.client.connection.idle.max -->
 <!-- NOTE: THIS TEXT IS AUTOGENERATED. DO NOT EDIT BY HAND. -->
 <!-- see templates/registry/markdown/snippet.md.j2 -->
 <!-- prettier-ignore-start -->
@@ -318,7 +318,7 @@ This metric is [recommended][MetricRecommended].
 <!-- END AUTOGENERATED TEXT -->
 <!-- endsemconv -->
 
-<!-- semconv metric.db.client.connection.idle.min(full) -->
+<!-- semconv metric.db.client.connection.idle.min -->
 <!-- NOTE: THIS TEXT IS AUTOGENERATED. DO NOT EDIT BY HAND. -->
 <!-- see templates/registry/markdown/snippet.md.j2 -->
 <!-- prettier-ignore-start -->
@@ -356,7 +356,7 @@ This metric is [recommended][MetricRecommended].
 <!-- END AUTOGENERATED TEXT -->
 <!-- endsemconv -->
 
-<!-- semconv metric.db.client.connection.max(full) -->
+<!-- semconv metric.db.client.connection.max -->
 <!-- NOTE: THIS TEXT IS AUTOGENERATED. DO NOT EDIT BY HAND. -->
 <!-- see templates/registry/markdown/snippet.md.j2 -->
 <!-- prettier-ignore-start -->
@@ -394,7 +394,7 @@ This metric is [recommended][MetricRecommended].
 <!-- END AUTOGENERATED TEXT -->
 <!-- endsemconv -->
 
-<!-- semconv metric.db.client.connection.pending_requests(full) -->
+<!-- semconv metric.db.client.connection.pending_requests -->
 <!-- NOTE: THIS TEXT IS AUTOGENERATED. DO NOT EDIT BY HAND. -->
 <!-- see templates/registry/markdown/snippet.md.j2 -->
 <!-- prettier-ignore-start -->
@@ -432,7 +432,7 @@ This metric is [recommended][MetricRecommended].
 <!-- END AUTOGENERATED TEXT -->
 <!-- endsemconv -->
 
-<!-- semconv metric.db.client.connection.timeouts(full) -->
+<!-- semconv metric.db.client.connection.timeouts -->
 <!-- NOTE: THIS TEXT IS AUTOGENERATED. DO NOT EDIT BY HAND. -->
 <!-- see templates/registry/markdown/snippet.md.j2 -->
 <!-- prettier-ignore-start -->
@@ -470,7 +470,7 @@ This metric is [recommended][MetricRecommended].
 <!-- END AUTOGENERATED TEXT -->
 <!-- endsemconv -->
 
-<!-- semconv metric.db.client.connection.create_time(full) -->
+<!-- semconv metric.db.client.connection.create_time -->
 <!-- NOTE: THIS TEXT IS AUTOGENERATED. DO NOT EDIT BY HAND. -->
 <!-- see templates/registry/markdown/snippet.md.j2 -->
 <!-- prettier-ignore-start -->
@@ -508,7 +508,7 @@ This metric is [recommended][MetricRecommended].
 <!-- END AUTOGENERATED TEXT -->
 <!-- endsemconv -->
 
-<!-- semconv metric.db.client.connection.wait_time(full) -->
+<!-- semconv metric.db.client.connection.wait_time -->
 <!-- NOTE: THIS TEXT IS AUTOGENERATED. DO NOT EDIT BY HAND. -->
 <!-- see templates/registry/markdown/snippet.md.j2 -->
 <!-- prettier-ignore-start -->
@@ -546,7 +546,7 @@ This metric is [recommended][MetricRecommended].
 <!-- END AUTOGENERATED TEXT -->
 <!-- endsemconv -->
 
-<!-- semconv metric.db.client.connection.use_time(full) -->
+<!-- semconv metric.db.client.connection.use_time -->
 <!-- NOTE: THIS TEXT IS AUTOGENERATED. DO NOT EDIT BY HAND. -->
 <!-- see templates/registry/markdown/snippet.md.j2 -->
 <!-- prettier-ignore-start -->

docs/database/database-spans.md

@@ -24,7 +24,7 @@ linkTitle: Client Calls
 > [v1.24.0 of this document](https://github.com/open-telemetry/semantic-conventions/blob/v1.24.0/docs/database/database-spans.md)
 > (or prior):
 >
-> * SHOULD NOT change the version of the database conventions that they emit
+> * SHOULD NOT change the version of the database conventions that they emit by default
 >   until the database semantic conventions are marked stable.
 >   Conventions include, but are not limited to, attributes,
 >   metric and span names, and unit of measure.
@@ -81,7 +81,7 @@ For example, for an operation describing SQL query on an anonymous table like `S
 
 These attributes will usually be the same for all operations performed over the same database connection.
 
-<!-- semconv db(full) -->
+<!-- semconv db -->
 <!-- NOTE: THIS TEXT IS AUTOGENERATED. DO NOT EDIT BY HAND. -->
 <!-- see templates/registry/markdown/snippet.md.j2 -->
 <!-- prettier-ignore-start -->

docs/database/elasticsearch.md

@@ -16,7 +16,7 @@ The **span name** follows the [general database span name guidelines](database-s
 
 ## Attributes
 
-<!-- semconv db.elasticsearch(full) -->
+<!-- semconv db.elasticsearch -->
 <!-- NOTE: THIS TEXT IS AUTOGENERATED. DO NOT EDIT BY HAND. -->
 <!-- see templates/registry/markdown/snippet.md.j2 -->
 <!-- prettier-ignore-start -->

docs/database/hbase.md

@@ -12,7 +12,7 @@ The Semantic Conventions for [HBase](https://hbase.apache.org/) extend and overr
 
 ## Attributes
 
-<!-- semconv db.hbase(full) -->
+<!-- semconv db.hbase -->
 <!-- NOTE: THIS TEXT IS AUTOGENERATED. DO NOT EDIT BY HAND. -->
 <!-- see templates/registry/markdown/snippet.md.j2 -->
 <!-- prettier-ignore-start -->

docs/database/mongodb.md

@@ -12,7 +12,7 @@ The Semantic Conventions for [MongoDB](https://www.mongodb.com/) extend and over
 
 ## Attributes
 
-<!-- semconv db.mongodb(full) -->
+<!-- semconv db.mongodb -->
 <!-- NOTE: THIS TEXT IS AUTOGENERATED. DO NOT EDIT BY HAND. -->
 <!-- see templates/registry/markdown/snippet.md.j2 -->
 <!-- prettier-ignore-start -->

docs/database/mssql.md

@@ -12,7 +12,7 @@ The Semantic Conventions for the *Microsoft SQL Server* extend and override the
 
 ## Attributes
 
-<!-- semconv db.mssql(full) -->
+<!-- semconv db.mssql -->
 <!-- NOTE: THIS TEXT IS AUTOGENERATED. DO NOT EDIT BY HAND. -->
 <!-- see templates/registry/markdown/snippet.md.j2 -->
 <!-- prettier-ignore-start -->

docs/database/redis.md

@@ -12,7 +12,7 @@ The Semantic Conventions for [Redis](https://redis.com/) extend and override the
 
 ## Attributes
 
-<!-- semconv db.redis(full) -->
+<!-- semconv db.redis -->
 <!-- NOTE: THIS TEXT IS AUTOGENERATED. DO NOT EDIT BY HAND. -->
 <!-- see templates/registry/markdown/snippet.md.j2 -->
 <!-- prettier-ignore-start -->

docs/database/sql.md

@@ -36,7 +36,7 @@ Instrumentations applied to generic SQL drivers SHOULD adhere to SQL semantic co
 
 ## Attributes
 
-<!-- semconv db.sql(full) -->
+<!-- semconv db.sql -->
 <!-- NOTE: THIS TEXT IS AUTOGENERATED. DO NOT EDIT BY HAND. -->
 <!-- see templates/registry/markdown/snippet.md.j2 -->
 <!-- prettier-ignore-start -->

docs/dns/dns-metrics.md

@@ -44,7 +44,7 @@ of `[ 0.005, 0.01, 0.025, 0.05, 0.075, 0.1, 0.25, 0.5, 0.75, 1, 2.5, 5, 7.5, 10
 <!-- END AUTOGENERATED TEXT -->
 <!-- endsemconv -->
 
-<!-- semconv metric.dns.lookup.duration(full) -->
+<!-- semconv metric.dns.lookup.duration -->
 <!-- NOTE: THIS TEXT IS AUTOGENERATED. DO NOT EDIT BY HAND. -->
 <!-- see templates/registry/markdown/snippet.md.j2 -->
 <!-- prettier-ignore-start -->

docs/dotnet/dotnet-aspnetcore-metrics.md

@@ -53,7 +53,7 @@ All routing metrics are reported by the `Microsoft.AspNetCore.Routing` meter.
 <!-- END AUTOGENERATED TEXT -->
 <!-- endsemconv -->
 
-<!-- semconv metric.aspnetcore.routing.match_attempts(full) -->
+<!-- semconv metric.aspnetcore.routing.match_attempts -->
 <!-- NOTE: THIS TEXT IS AUTOGENERATED. DO NOT EDIT BY HAND. -->
 <!-- see templates/registry/markdown/snippet.md.j2 -->
 <!-- prettier-ignore-start -->
@@ -112,7 +112,7 @@ Exceptions Metric is reported by the `Microsoft.AspNetCore.Diagnostics` meter.
 <!-- END AUTOGENERATED TEXT -->
 <!-- endsemconv -->
 
-<!-- semconv metric.aspnetcore.diagnostics.exceptions(full) -->
+<!-- semconv metric.aspnetcore.diagnostics.exceptions -->
 <!-- NOTE: THIS TEXT IS AUTOGENERATED. DO NOT EDIT BY HAND. -->
 <!-- see templates/registry/markdown/snippet.md.j2 -->
 <!-- prettier-ignore-start -->
@@ -199,7 +199,7 @@ All rate-limiting metrics are reported by the `Microsoft.AspNetCore.RateLimiting
 <!-- END AUTOGENERATED TEXT -->
 <!-- endsemconv -->
 
-<!-- semconv metric.aspnetcore.rate_limiting.active_request_leases(full) -->
+<!-- semconv metric.aspnetcore.rate_limiting.active_request_leases -->
 <!-- NOTE: THIS TEXT IS AUTOGENERATED. DO NOT EDIT BY HAND. -->
 <!-- see templates/registry/markdown/snippet.md.j2 -->
 <!-- prettier-ignore-start -->
@@ -247,7 +247,7 @@ of `[ 0.005, 0.01, 0.025, 0.05, 0.075, 0.1, 0.25, 0.5, 0.75, 1, 2.5, 5, 7.5, 10
 <!-- END AUTOGENERATED TEXT -->
 <!-- endsemconv -->
 
-<!-- semconv metric.aspnetcore.rate_limiting.request_lease.duration(full) -->
+<!-- semconv metric.aspnetcore.rate_limiting.request_lease.duration
 <!-- NOTE: THIS TEXT IS AUTOGENERATED. DO NOT EDIT BY HAND. -->
 <!-- see templates/registry/markdown/snippet.md.j2 -->
 <!-- prettier-ignore-start -->
@@ -291,7 +291,7 @@ of `[ 0.005, 0.01, 0.025, 0.05, 0.075, 0.1, 0.25, 0.5, 0.75, 1, 2.5, 5, 7.5, 10
 <!-- END AUTOGENERATED TEXT -->
 <!-- endsemconv -->
 
-<!-- semconv metric.aspnetcore.rate_limiting.queued_requests(full) -->
+<!-- semconv metric.aspnetcore.rate_limiting.queued_requests -->
 <!-- NOTE: THIS TEXT IS AUTOGENERATED. DO NOT EDIT BY HAND. -->
 <!-- see templates/registry/markdown/snippet.md.j2 -->
 <!-- prettier-ignore-start -->
@@ -339,7 +339,7 @@ of `[ 0.005, 0.01, 0.025, 0.05, 0.075, 0.1, 0.25, 0.5, 0.75, 1, 2.5, 5, 7.5, 10
 <!-- END AUTOGENERATED TEXT -->
 <!-- endsemconv -->
 
-<!-- semconv metric.aspnetcore.rate_limiting.request.time_in_queue(full) -->
+<!-- semconv metric.aspnetcore.rate_limiting.request.time_in_queue -->
 <!-- NOTE: THIS TEXT IS AUTOGENERATED. DO NOT EDIT BY HAND. -->
 <!-- see templates/registry/markdown/snippet.md.j2 -->
 <!-- prettier-ignore-start -->
@@ -399,7 +399,7 @@ Meter name: `Microsoft.AspNetCore.RateLimiting`; Added in: ASP.NET Core 8.0
 <!-- END AUTOGENERATED TEXT -->
 <!-- endsemconv -->
 
-<!-- semconv metric.aspnetcore.rate_limiting.requests(full) -->
+<!-- semconv metric.aspnetcore.rate_limiting.requests -->
 <!-- NOTE: THIS TEXT IS AUTOGENERATED. DO NOT EDIT BY HAND. -->
 <!-- see templates/registry/markdown/snippet.md.j2 -->
 <!-- prettier-ignore-start -->