Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update spec to include Process CPU Time #450

Merged
merged 3 commits into from Sep 27, 2019
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Jump to
Jump to file
Failed to load files.
Diff view
Diff view
3 changes: 3 additions & 0 deletions spec/src/main/asciidoc/changelog.adoc
Expand Up @@ -23,6 +23,9 @@

Changes marked with icon:bolt[role="red"] are breaking changes relative to previous versions of the spec.

* Changes in 2.2
** Added ProcessCpuTime as a new optional base metric.

* Changes in 2.1
** Clarified that metric registry implementations are required to be thread-safe.
** Clarified in the API code that Gauges must return values that extend `java.lang.Number`.
Expand Down
13 changes: 12 additions & 1 deletion spec/src/main/asciidoc/required-metrics.adoc
@@ -1,5 +1,5 @@
//
// Copyright (c) 2016-2018 Contributors to the Eclipse Foundation
// Copyright (c) 2016-2019 Contributors to the Eclipse Foundation
//
// See the NOTICE file(s) distributed with this work for additional
// information regarding copyright ownership.
Expand Down Expand Up @@ -240,3 +240,14 @@ Vendors should either use other metrics that are close enough as substitute or n
Note: This is a vendor specific attribute/operation that is not defined in java.lang
|===

*(Optional) ProcessCpuTime*
[cols="1,4"]
|===
|Name| cpu.processCpuTime
|DisplayName| Process CPU Time
|Type| Gauge
|Unit| Nanoseconds
|Description| Displays the CPU time used by the process on which the Java virtual machine is running in nanoseconds.
|MBean| java.lang:type=OperatingSystem (com.sun.management.UnixOperatingSystemMXBean for Oracle Java, similar one exists for IBM Java: com.ibm.lang.management.ExtendedOperatingSystem)
Note: This is a vendor specific attribute/operation that is not defined in java.lang
|===