From 77c6b6657241a531d043f9036ad3b1e3b69a596c Mon Sep 17 00:00:00 2001 From: Johanna Ojeling Date: Mon, 11 May 2026 11:06:54 +0200 Subject: [PATCH 1/4] [prometheus] Stabilize SDK exporter resource attributes config --- .../metrics/sdk_exporters/prometheus.md | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/specification/metrics/sdk_exporters/prometheus.md b/specification/metrics/sdk_exporters/prometheus.md index 914e3237844..315a306e6f3 100644 --- a/specification/metrics/sdk_exporters/prometheus.md +++ b/specification/metrics/sdk_exporters/prometheus.md @@ -23,7 +23,7 @@ linkTitle: Prometheus * [Host](#host) * [Port](#port) * [Default Aggregation](#default-aggregation) - * [Resource Attributes as Metric Attributes](#resource-attributes-as-metric-attributes) + * [Resource Attributes as Metric Labels](#resource-attributes-as-metric-labels) * [Translation Strategy](#translation-strategy) * [Scope Info](#scope-info) * [Target Info](#target-info) @@ -127,15 +127,15 @@ the [MetricReader](../sdk.md#metricreader) default `aggregation` as a function of instrument kind. This option MAY be named `default_aggregation`, and MUST use the [default aggregation](../sdk.md#default-aggregation) by default. -### Resource Attributes as Metric Attributes +### Resource Attributes as Metric Labels -**Status**: [Development](../../document-status.md) +**Status**: [Stable](../../document-status.md) -A Prometheus Exporter MAY offer configuration to add resource attributes as metric attributes. -By default, it MUST NOT add any resource attributes as metric attributes. -The configuration SHOULD allow the user to select which resource attributes to copy (e.g. -include / exclude or regular expression based). Copied Resource attributes MUST NOT be -excluded from the `target` info metric. The option MAY be named `resource_constant_labels`. +A Prometheus Exporter MAY offer configuration to add resource attributes as metric labels. +By default, it MUST NOT add any resource attributes as metric labels. +The configuration SHOULD allow the user to select a list of resource attributes to include, +or a list of resource attributes to exclude. Copied Resource attributes MUST NOT be +excluded from the `target_info` metric. The option SHOULD be named `resource_constant_labels`. ### Translation Strategy From 5ceca7f946356c2a3b8efcfed981524cd657fc68 Mon Sep 17 00:00:00 2001 From: Johanna Ojeling Date: Tue, 12 May 2026 12:53:06 +0200 Subject: [PATCH 2/4] [prometheus] Keep Development status --- specification/metrics/sdk_exporters/prometheus.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/specification/metrics/sdk_exporters/prometheus.md b/specification/metrics/sdk_exporters/prometheus.md index 315a306e6f3..f31341c3b54 100644 --- a/specification/metrics/sdk_exporters/prometheus.md +++ b/specification/metrics/sdk_exporters/prometheus.md @@ -129,7 +129,7 @@ the [default aggregation](../sdk.md#default-aggregation) by default. ### Resource Attributes as Metric Labels -**Status**: [Stable](../../document-status.md) +**Status**: [Development](../../document-status.md) A Prometheus Exporter MAY offer configuration to add resource attributes as metric labels. By default, it MUST NOT add any resource attributes as metric labels. From cbbcb520b4017a57ab0d49318e75af05130afb1e Mon Sep 17 00:00:00 2001 From: Johanna Ojeling Date: Wed, 13 May 2026 12:42:53 +0200 Subject: [PATCH 3/4] [prometheus] Make resource attribute label selection more flexible --- specification/metrics/sdk_exporters/prometheus.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/specification/metrics/sdk_exporters/prometheus.md b/specification/metrics/sdk_exporters/prometheus.md index f31341c3b54..21e703329c8 100644 --- a/specification/metrics/sdk_exporters/prometheus.md +++ b/specification/metrics/sdk_exporters/prometheus.md @@ -133,8 +133,7 @@ the [default aggregation](../sdk.md#default-aggregation) by default. A Prometheus Exporter MAY offer configuration to add resource attributes as metric labels. By default, it MUST NOT add any resource attributes as metric labels. -The configuration SHOULD allow the user to select a list of resource attributes to include, -or a list of resource attributes to exclude. Copied Resource attributes MUST NOT be +The configuration SHOULD allow the user to select resource attributes to include or exclude. Copied Resource attributes MUST NOT be excluded from the `target_info` metric. The option SHOULD be named `resource_constant_labels`. ### Translation Strategy From 842e5986a03521fc17586edefe5fe789353f0ee7 Mon Sep 17 00:00:00 2001 From: Johanna Ojeling Date: Mon, 25 May 2026 09:50:15 +0200 Subject: [PATCH 4/4] [prometheus] Add changelog entry --- CHANGELOG.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/CHANGELOG.md b/CHANGELOG.md index c799eada700..c94f189ac6e 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -36,6 +36,10 @@ release. ### Compatibility +- Stabilize sections of Prometheus Metrics Exporter. + - Clarify resource attributes configuration. + ([#5084](https://github.com/open-telemetry/opentelemetry-specification/pull/5084)) + ### SDK Configuration ### Supplementary Guidelines