Skip to content

Commit 1e096e9

Browse files
committed
tune cpu.mode for other metric
Signed-off-by: ChrsMark <[email protected]>
1 parent fac34bc commit 1e096e9

File tree

2 files changed

+8
-3
lines changed

2 files changed

+8
-3
lines changed

docs/system/container-metrics.md

+6-2
Original file line numberDiff line numberDiff line change
@@ -46,10 +46,12 @@ This metric is [opt-in][MetricOptIn].
4646

4747
| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
4848
|---|---|---|---|---|---|
49-
| [`cpu.mode`](/docs/attributes-registry/cpu.md) | string | The CPU mode for this data point. A container's CPU metric SHOULD be characterized _either_ by data points with no `mode` labels, _or only_ data points with `mode` labels. [1] | `user`; `system` | `Opt-In` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
49+
| [`cpu.mode`](/docs/attributes-registry/cpu.md) | string | The CPU mode for this data point. A container's CPU metric SHOULD be characterized _either_ by data points with no `mode` labels, _or only_ data points with `mode` labels. [1] | `user`; `system` | `Conditionally Required` [2] | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
5050

5151
**[1]:** Following states SHOULD be used: `user`, `system`, `kernel`
5252

53+
**[2]:** Required if mode is available, i.e. metrics coming from the Docker Stats API.
54+
5355

5456

5557
`cpu.mode` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
@@ -106,10 +108,12 @@ This metric is [opt-in][MetricOptIn].
106108

107109
| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
108110
|---|---|---|---|---|---|
109-
| [`cpu.mode`](/docs/attributes-registry/cpu.md) | string | The CPU mode for this data point. A container's CPU metric SHOULD be characterized _either_ by data points with no `mode` labels, _or only_ data points with `mode` labels. [1] | `user`; `system` | `Opt-In` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
111+
| [`cpu.mode`](/docs/attributes-registry/cpu.md) | string | The CPU mode for this data point. A container's CPU metric SHOULD be characterized _either_ by data points with no `mode` labels, _or only_ data points with `mode` labels. [1] | `user`; `system` | `Conditionally Required` [2] | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
110112

111113
**[1]:** Following states SHOULD be used: `user`, `system`, `kernel`
112114

115+
**[2]:** Required if mode is available, i.e. metrics coming from the Docker Stats API.
116+
113117

114118

115119
`cpu.mode` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.

model/metrics/container.yaml

+2-1
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,8 @@ groups:
1313
- ref: cpu.mode
1414
brief: "The CPU mode for this data point. A container's CPU metric SHOULD be characterized _either_ by data points with no `mode` labels, _or only_ data points with `mode` labels."
1515
note: "Following states SHOULD be used: `user`, `system`, `kernel`"
16-
requirement_level: opt_in
16+
requirement_level:
17+
conditionally_required: Required if mode is available, i.e. metrics coming from the Docker Stats API.
1718

1819
- id: metric.container.cpu.usage
1920
type: metric

0 commit comments

Comments
 (0)