diff --git a/CHANGELOG.md b/CHANGELOG.md index 6527f739564..9159647cce9 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -41,6 +41,7 @@ release. - Prometheus: Do not add `_total` suffix if the metric already ends in `_total`. ([#3581](https://github.com/open-telemetry/opentelemetry-specification/pull/3581)) - Prometheus type and unit suffixes are not trimmed by default. ([#3580](https://github.com/open-telemetry/opentelemetry-specification/pull/3580)) +- Prometheus exporters SHOULD provide configuration to disable the addition of `_total` suffixes. ([#3590](https://github.com/open-telemetry/opentelemetry-specification/pull/3590)) ### OpenTelemetry Protocol diff --git a/specification/compatibility/prometheus_and_openmetrics.md b/specification/compatibility/prometheus_and_openmetrics.md index 50db207ecf2..813bf2fb210 100644 --- a/specification/compatibility/prometheus_and_openmetrics.md +++ b/specification/compatibility/prometheus_and_openmetrics.md @@ -276,7 +276,7 @@ An [OpenTelemetry Gauge](../metrics/data-model.md#gauge) MUST be converted to a - The new data point's start time must match the time of the accumulated data point. If not, see [detecting alignment issues](../metrics/data-model.md#sums-detecting-alignment-issues). - Otherwise, it MUST be dropped. -If the metric name for monotonic Sum metric points does not end in a suffix of `_total` a suffix of `_total` MUST be added, otherwise the name MUST remain unchanged. +If the metric name for monotonic Sum metric points does not end in a suffix of `_total` a suffix of `_total` MUST be added by default, otherwise the name MUST remain unchanged. Exporters SHOULD provide a configuration option to disable the addition of `_total` suffixes. Monotonic Sum metric points with `StartTimeUnixNano` should export the `{name}_created` metric as well. ### Histograms