open-telemetry
/
semantic-conventions
mirror of https://github.com/open-telemetry/semantic-conventions.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Add `process.runtime.jvm.cpu.time` metric (#55)

This commit is contained in:
Trask Stalnaker 2023-06-13 17:50:05 -07:00 committed by GitHub
parent f07495d905
commit 8f9fbdf8d6
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
3 changed files with 26 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
CHANGELOG.md
View File

@ -80,3 +80,5 @@ release.
([#70](https://github.com/open-telemetry/semantic-conventions/pull/70))
- Clarify that OTEL_SEMCONV_STABILITY_OPT_IN is a comma-separated list of values
([#104](https://github.com/open-telemetry/semantic-conventions/pull/104))
- Add `process.runtime.jvm.cpu.time` metric.
([#55](https://github.com/open-telemetry/semantic-conventions/pull/55))

7
semantic_conventions/metrics/process-runtime-jvm-metrics.yaml
View File

@ -122,6 +122,13 @@ groups:
instrument: updowncounter
unit: "{class}"
- id: metric.process.runtime.jvm.cpu.time
type: metric
metric_name: process.runtime.jvm.cpu.time
brief: "CPU time used by the process."
instrument: counter
unit: "s"
- id: metric.process.runtime.jvm.cpu.recent_utilization
type: metric
metric_name: process.runtime.jvm.cpu.recent_utilization

17
specification/metrics/semantic_conventions/runtime-environment-metrics.md
View File

@ -30,6 +30,7 @@ semantic conventions when instrumenting runtime environments.
* [Metric: `process.runtime.jvm.classes.loaded`](#metric-processruntimejvmclassesloaded)
* [Metric: `process.runtime.jvm.classes.unloaded`](#metric-processruntimejvmclassesunloaded)
* [Metric: `process.runtime.jvm.classes.current_loaded`](#metric-processruntimejvmclassescurrent_loaded)
* [Metric: `process.runtime.jvm.cpu.time`](#metric-processruntimejvmcputime)
* [Metric: `process.runtime.jvm.cpu.recent_utilization`](#metric-processruntimejvmcpurecent_utilization)
* [Metric: `process.runtime.jvm.system.cpu.utilization`](#metric-processruntimejvmsystemcpuutilization)
* [Metric: `process.runtime.jvm.system.cpu.load_1m`](#metric-processruntimejvmsystemcpuload_1m)
@ -298,6 +299,22 @@ This metric is obtained from [`ClassLoadingMXBean#getLoadedClassCount()`](https:
<!-- semconv metric.process.runtime.jvm.classes.current_loaded(full) -->
<!-- endsemconv -->
### Metric: `process.runtime.jvm.cpu.time`
This metric is [recommended][MetricRecommended].
This metric is obtained from [`com.sun.management.OperatingSystemMXBean#getProcessCpuTime()`](https://docs.oracle.com/en/java/javase/17/docs/api/jdk.management/com/sun/management/OperatingSystemMXBean.html#getProcessCpuTime()) on HotSpot
and [`com.ibm.lang.management.OperatingSystemMXBean#getProcessCpuTime()`](https://www.ibm.com/docs/api/v1/content/SSYKE2_8.0.0/openj9/api/jdk8/jre/management/extension/com/ibm/lang/management/OperatingSystemMXBean.html#getProcessCpuTime--) on J9.
<!-- semconv metric.process.runtime.jvm.cpu.time(metric_table) -->
| Name | Instrument Type | Unit (UCUM) | Description |
| -------- | --------------- | ----------- | -------------- |
| `process.runtime.jvm.cpu.time` | Counter | `s` | CPU time used by the process. |
<!-- endsemconv -->
<!-- semconv metric.process.runtime.jvm.cpu.time(full) -->
<!-- endsemconv -->
### Metric: `process.runtime.jvm.cpu.recent_utilization`
This metric is [recommended][MetricRecommended].