diff --git a/docs/specs/om/open_metrics_spec_2_0.md b/docs/specs/om/open_metrics_spec_2_0.md index 562d23cc5..5b05ea96e 100644 --- a/docs/specs/om/open_metrics_spec_2_0.md +++ b/docs/specs/om/open_metrics_spec_2_0.md @@ -110,7 +110,7 @@ Strings MUST only consist of valid UTF-8 characters and MAY be zero length. NULL Labels are key-value pairs consisting of strings. -Label names beginning with two underscores are RESERVED and MUST NOT be used unless specified by this standard. Label names SHOULD follow the restrictions in the ABNF section under the `label-name` section. Label names MAY be any quoted escaped UTF-8 string as described in the ABNF section. Be aware that exposing UTF-8 metrics is still experimental and may reduce usability. +Label names beginning with two underscores are RESERVED for use for metric metadata. Label names beginning with two underscores MAY be used in cases where metrics could have conflicting metadata, such as federation, but MUST NOT be used otherwise. Label names SHOULD follow the restrictions in the ABNF section under the `label-name` section. Label names MAY be any quoted escaped UTF-8 string as described in the ABNF section. Be aware that exposing UTF-8 metrics is still experimental and may reduce usability. Empty label values SHOULD be treated as if the label was not present.