Add process.cpu.utilization metric (#2436)

* Add process.cpu.utilization * Update with PR # * fix, and more clarity Co-authored-by: Bogdan Drutu <[email protected]>
open-telemetry · Mar 30, 2022 · 76f6e8e · 76f6e8e
1 parent 2d2c555
commit 76f6e8e
Show file tree

Hide file tree

Showing 2 changed files with 3 additions and 0 deletions.
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -66,6 +66,8 @@ release.
   ([#2290](https://github.com/open-telemetry/opentelemetry-specification/pull/2290))
 - Add semantic conventions for [CloudEvents](https://cloudevents.io).
   ([#1978](https://github.com/open-telemetry/opentelemetry-specification/pull/1978))
+- Add `process.cpu.utilization` metric.
+  ([#2436](https://github.com/open-telemetry/opentelemetry-specification/pull/2436))
 
 ### Compatibility
 

diff --git a/specification/metrics/semantic_conventions/process-metrics.md b/specification/metrics/semantic_conventions/process-metrics.md
@@ -30,6 +30,7 @@ Below is a table of Process metric instruments.
 | Name | Instrument | Units | Description | Labels |
 |------|------------|-------|-------------|--------|
 | `process.cpu.time` | Asynchronous Counter | s | Total CPU seconds broken down by different states. | `state`, if specified, SHOULD be one of: `system`, `user`, `wait`. A process SHOULD be characterized _either_ by data points with no `state` labels, _or only_ data points with `state` labels. |
+| `process.cpu.utilization` | Asynchronous Gauge | s | Difference in process.cpu.time since the last measurement, divided by the elapsed time and number of CPUs available to the process. | `state`, if specified, SHOULD be one of: `system`, `user`, `wait`. A process SHOULD be characterized _either_ by data points with no `state` labels, _or only_ data points with `state` labels. |
 | `process.memory.usage` | Asynchronous UpDownCounter | By | The amount of physical memory in use. |  |
 | `process.memory.virtual` | Asynchronous UpDownCounter | By | The amount of committed virtual memory. |  |
 | `process.disk.io` | Asynchronous Counter | By | Disk bytes transferred. | `direction` SHOULD be one of: `read`, `write` |