Add system.cpu.frequency metric. (#337)

Signed-off-by: ChrsMark <[email protected]>
Co-authored-by: Pablo Baeyens <[email protected]>

CHANGELOG.md

@@ -182,6 +182,8 @@ release.
 - BREAKING: Rename `telemetry.auto.version` resource attribute to `telemetry.distro.version`
   and add `telemetry.distro.name` resource attribute
   ([#178](https://github.com/open-telemetry/semantic-conventions/pull/178))
+- Add `system.cpu.frequency` metric.
+  ([#337](https://github.com/open-telemetry/semantic-conventions/pull/337))
 - Improve HTTP metric briefs.
   ([#366](https://github.com/open-telemetry/semantic-conventions/pull/366))
 - Add `host.ip` resource attribute convention.

docs/system/system-metrics.md

@@ -26,6 +26,7 @@ Resource attributes related to a host, SHOULD be reported under the `host.*` nam
   * [Metric: `system.cpu.utilization`](#metric-systemcpuutilization)
   * [Metric: `system.cpu.physical.count`](#metric-systemcpuphysicalcount)
   * [Metric: `system.cpu.logical.count`](#metric-systemcpulogicalcount)
+  * [Metric: `system.cpu.frequency`](#metric-systemcpufrequency)
 - [Memory Metrics](#memory-metrics)
   * [Metric: `system.memory.usage`](#metric-systemmemoryusage)
   * [Metric: `system.memory.utilization`](#metric-systemmemoryutilization)
@@ -145,6 +146,22 @@ This metric is [recommended][MetricRecommended].
 <!-- semconv metric.system.cpu.logical.count(full) -->
 <!-- endsemconv -->
 
+### Metric: `system.cpu.frequency`
+
+This metric is [recommended][MetricRecommended].
+
+<!-- semconv metric.system.cpu.frequency(metric_table) -->
+| Name     | Instrument Type | Unit (UCUM) | Description    |
+| -------- | --------------- | ----------- | -------------- |
+| `system.cpu.frequency` | Gauge | `{Hz}` | Reports the current frequency of the CPU in Hz |
+<!-- endsemconv -->
+
+<!-- semconv metric.system.cpu.frequency(full) -->
+| Attribute  | Type | Description  | Examples  | Requirement Level |
+|---|---|---|---|---|
+| `system.cpu.logical_number` | int | The logical CPU number [0..n-1] | `1` | Recommended |
+<!-- endsemconv -->
+
 ## Memory Metrics
 
 **Description:** System level memory metrics capture under the namespace `system.memory`.

model/metrics/system-metrics.yaml

@@ -61,6 +61,15 @@ groups:
       - ref: system.cpu.state
       - ref: system.cpu.logical_number
 
+  - id: metric.system.cpu.frequency
+    type: metric
+    metric_name: system.cpu.frequency
+    brief: "Reports the current frequency of the CPU in Hz"
+    instrument: gauge
+    unit: "{Hz}"
+    attributes:
+      - ref: system.cpu.logical_number
+
   - id: metric.system.cpu.physical.count
     type: metric
     metric_name: system.cpu.physical.count