diff --git a/CHANGELOG.md b/CHANGELOG.md index 24a8a4b8adb..63382fe20e1 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -26,6 +26,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..9ed1439d829 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 metadata 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).