Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
15 changes: 14 additions & 1 deletion docs/specs/om/open_metrics_spec_2_0.md
Original file line number Diff line number Diff line change
Expand Up @@ -697,7 +697,7 @@ If a unit is specified it MUST be provided in a UNIT metadata line. In addition,

Be aware that exposing metrics without the unit being a suffix (or infix) of the MetricFamily name directly to end-users may reduce the usability due to confusion about what the metric's unit is.

A valid example for a foo_seconds metric with a unit of "seconds":
A valid example for a `foo_seconds_total` metric with a unit of "seconds":

```openmetrics-add-eof
# TYPE foo_seconds_total counter
Expand Down Expand Up @@ -735,6 +735,19 @@ There MUST NOT be more than one of each type of metadata line for a MetricFamily

Aside from this metadata and the EOF line at the end of the message, you MUST NOT expose lines beginning with a #.

##### Unknown metadata

Ingestors MUST support Metric Families without metadata lines.

A valid, but discouraged example, for `foo_seconds_total` counter and a set of unrelated, unknown type metrics without metadata lines:

```openmetrics-add-eof
# TYPE foo_seconds_total counter
foo_seconds_total 1
foo_milliseconds_total 2
foo_count 3
```

#### Metric

Metrics MUST NOT be interleaved. See the StateSet example below.
Expand Down
Loading