From 9edb35ec65ad95fccf4cf180f9d454c84b4cd6e7 Mon Sep 17 00:00:00 2001 From: Robert Pajak Date: Fri, 7 Nov 2025 10:38:31 +0100 Subject: [PATCH 1/3] larify distinction between map and Attribute Collections --- specification/common/README.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/specification/common/README.md b/specification/common/README.md index eb775079801..9965ee1227e 100644 --- a/specification/common/README.md +++ b/specification/common/README.md @@ -122,6 +122,12 @@ outside OpenTelemetry into OpenTelemetry attribute values. [Log Records](../logs/data-model.md), contain a collection of attributes. +Attribute Collections are top-level collections of key-value pairs used in +OpenTelemetry data models. +Note that they are distinct from [`map`](#mapstring-anyvalue), +which is a type of [`AnyValue`](#anyvalue) used to represent nested data +structures within attribute values. + Implementation MUST by default ensure that the exported attribute collections contain only unique keys. The enforcement of uniqueness may be performed in a variety of ways as it best fits the limitations of the particular From 71a1b713d12ee547a8ed842394b0f1e19fe28d19 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Robert=20Paj=C4=85k?= Date: Fri, 7 Nov 2025 20:37:44 +0100 Subject: [PATCH 2/3] Update specification/common/README.md --- specification/common/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/specification/common/README.md b/specification/common/README.md index 9965ee1227e..22af87b3d90 100644 --- a/specification/common/README.md +++ b/specification/common/README.md @@ -126,7 +126,7 @@ Attribute Collections are top-level collections of key-value pairs used in OpenTelemetry data models. Note that they are distinct from [`map`](#mapstring-anyvalue), which is a type of [`AnyValue`](#anyvalue) used to represent nested data -structures within attribute values. +structures e.g. in attribute values, in [log record body](../logs/data-model.md#field-body). Implementation MUST by default ensure that the exported attribute collections contain only unique keys. The enforcement of uniqueness may be performed From b0b68351f785ad9ecf3b51b4aec2ab8f3b6e84af Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Robert=20Paj=C4=85k?= Date: Sat, 8 Nov 2025 00:14:26 +0100 Subject: [PATCH 3/3] Update specification/common/README.md Co-authored-by: Trask Stalnaker --- specification/common/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/specification/common/README.md b/specification/common/README.md index 22af87b3d90..7c6a5625686 100644 --- a/specification/common/README.md +++ b/specification/common/README.md @@ -126,7 +126,7 @@ Attribute Collections are top-level collections of key-value pairs used in OpenTelemetry data models. Note that they are distinct from [`map`](#mapstring-anyvalue), which is a type of [`AnyValue`](#anyvalue) used to represent nested data -structures e.g. in attribute values, in [log record body](../logs/data-model.md#field-body). +structures e.g. in attribute values and [log record body](../logs/data-model.md#field-body). Implementation MUST by default ensure that the exported attribute collections contain only unique keys. The enforcement of uniqueness may be performed