From 675674ad52c51b5c1d3e8145e94a839a45b14137 Mon Sep 17 00:00:00 2001 From: Robert Pajak Date: Tue, 5 Aug 2025 21:03:55 +0200 Subject: [PATCH 1/3] Extending the set of standard attribute value types is no longer a breaking change --- CHANGELOG.md | 3 +++ specification/common/README.md | 15 --------------- 2 files changed, 3 insertions(+), 15 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 355dc9281f3..ee5b6a04a17 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -50,6 +50,9 @@ release. ### Common +- Extending the set of standard attribute value types is no longer a breaking change. + ([#TODO](https://github.com/open-telemetry/opentelemetry-specification/pull/4485)) + ### Supplementary Guidelines ### OTEPs diff --git a/specification/common/README.md b/specification/common/README.md index 4b95d8b8508..82f634d5dc9 100644 --- a/specification/common/README.md +++ b/specification/common/README.md @@ -83,21 +83,6 @@ reflects that LogRecord attributes are expected to model data produced from external log APIs, which do not necessarily have the same value type restrictions as the standard attribute definition. -Note: Extending the set of standard attribute value types is a breaking change. -This was decided after extensive debate, with arguments as follows: - -* Limiting the types of attribute values to a set which has proved sufficient - during several years of OpenTelemetry's development is a useful guardrail for - design. In taking additional value types off the table, we narrow the solution - space and have more productive design conversations. -* Upon proposing to extend support for complex value types, we received significant - pushback. Limiting attribute value types to primitives and arrays of primitives - simplifies data consumers' efforts to create search indexes and perform statistical - analysis. -* To address concerns over restricting standard attributes to primitive types, it was - called out that complex types can be encoded as existing primitive types, such as - representing datetime as a string or 64 bit integer. - ### Attribute Limits Execution of erroneous code can result in unintended attributes. If there are no From 64ad52d0438d7a166ac8a074cbedcca237b88b45 Mon Sep 17 00:00:00 2001 From: Robert Pajak Date: Tue, 5 Aug 2025 21:06:38 +0200 Subject: [PATCH 2/3] update PR number --- CHANGELOG.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index ee5b6a04a17..1d8c7fca5e6 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -51,7 +51,7 @@ release. ### Common - Extending the set of standard attribute value types is no longer a breaking change. - ([#TODO](https://github.com/open-telemetry/opentelemetry-specification/pull/4485)) + ([#4614](https://github.com/open-telemetry/opentelemetry-specification/pull/4614)) ### Supplementary Guidelines From c9c0fe7c42596e95a94294c483e65fa0d1a27d3f Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Robert=20Paj=C4=85k?= Date: Thu, 14 Aug 2025 10:23:37 +0200 Subject: [PATCH 3/3] Update CHANGELOG.md --- CHANGELOG.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 1d8c7fca5e6..e9d9316990e 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -50,7 +50,7 @@ release. ### Common -- Extending the set of standard attribute value types is no longer a breaking change. +- ⚠️ **IMPORTANT**: Extending the set of standard attribute value types is no longer a breaking change. ([#4614](https://github.com/open-telemetry/opentelemetry-specification/pull/4614)) ### Supplementary Guidelines