From 76f6e8ed3f143cccc5954f3b95cb93367eba1938 Mon Sep 17 00:00:00 2001 From: Trask Stalnaker Date: Wed, 30 Mar 2022 08:08:22 -0700 Subject: [PATCH] Add process.cpu.utilization metric (#2436) * Add process.cpu.utilization * Update with PR # * fix, and more clarity Co-authored-by: Bogdan Drutu --- CHANGELOG.md | 2 ++ specification/metrics/semantic_conventions/process-metrics.md | 1 + 2 files changed, 3 insertions(+) diff --git a/CHANGELOG.md b/CHANGELOG.md index 9c09183b198..dd2eb3f7f58 100644 --- 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 index 6524a88f992..d51651de9db 100644 --- 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` |