From e8fdae7684fbafd5ea0e4d80015b2385066b924c Mon Sep 17 00:00:00 2001 From: David Ashpole Date: Thu, 23 May 2024 14:10:52 +0000 Subject: [PATCH] clarify that unit must be a suffix for metric names --- CHANGELOG.md | 3 +++ specification/compatibility/prometheus_and_openmetrics.md | 6 +++--- 2 files changed, 6 insertions(+), 3 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 2743be345ff..4cc3c4a2ae6 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -23,6 +23,9 @@ release. ### Compatibility +- Prometheus: Clarify location of unit suffix within metric names. + ([#4057](https://github.com/open-telemetry/opentelemetry-specification/pull/4057)) + ### SDK Configuration ### Common diff --git a/specification/compatibility/prometheus_and_openmetrics.md b/specification/compatibility/prometheus_and_openmetrics.md index 824ea018c9d..8b1dfb5db3d 100644 --- a/specification/compatibility/prometheus_and_openmetrics.md +++ b/specification/compatibility/prometheus_and_openmetrics.md @@ -267,9 +267,9 @@ The Unit of an OTLP metric point SHOULD be converted to the equivalent unit in P The resulting unit SHOULD be added to the metric as [UNIT metadata](https://github.com/OpenObservability/OpenMetrics/blob/main/specification/OpenMetrics.md#metricfamily) -and as a suffix to the metric name unless the metric name already contains the -unit, or the unit MUST be omitted. The unit suffix comes before any -type-specific suffixes. +and as a suffix to the metric name unless the metric name already ends with the +unit (before type-specific suffixes), or the unit MUST be omitted. The unit +suffix comes before any type-specific suffixes. The description of an OTLP metrics point MUST be added as [HELP metadata](https://prometheus.io/docs/instrumenting/exposition_formats/#comments-help-text-and-type-information).