Extend the set of attribute value types

CHANGELOG.md

@@ -45,6 +45,9 @@ release.
 
 ### Common
 
+- Extend the set of attribute value types to support more complex data structures.
+  ([#4651](https://github.com/open-telemetry/opentelemetry-specification/pull/4651))
+
 ### Supplementary Guidelines
 
 ### OTEPs

oteps/4485-extending-attributes-to-support-complex-values.md

@@ -23,6 +23,7 @@
   * [Configurable OTLP exporter behavior (both SDK and Collector)](#configurable-otlp-exporter-behavior-both-sdk-and-collector)
   * [Record pointer to repetitive data](#record-pointer-to-repetitive-data)
 - [Backend research](#backend-research)
+- [Appendix](#appendix)
 
 <!-- tocstop -->
 
@@ -94,7 +95,7 @@ extending the standard attributes provides a more seamless and user-friendly API
 
 Currently, the SDK specification has a clause that says extending
 the set of standard attribute would be
-[considered a breaking change](/specification/common/README.md#standard-attribute).
+[considered a breaking change](https://github.com/open-telemetry/opentelemetry-specification/blob/v1.44.0/specification/common/README.md#standard-attribute).
 
 We believe that removing this clause and extending standard
 attributes can be done gracefully across the OpenTelemetry ecosystem
@@ -309,3 +310,9 @@ for additional details.
 
 > [!NOTE]
 > This list only reflects the behavior at the time of writing and may change in the future.
+
+## Appendix
+
+The [Extend the set of attribute value types #4651](https://github.com/open-telemetry/opentelemetry-specification/pull/4651) PR implements part of this OTEP by requiring that both the OTel API and SDK MUST support complex attributes.
+Some languages aim to support complex attributes for all kinds of telemetry.
+To maintain consistency across languages, we agreed that all languages should provide the same level of support for complex attributes.

oteps/entities/0256-entities-data-model.md

@@ -139,7 +139,7 @@ MAY change over the lifetime of the entity. MAY be empty. These
 attributes are not part of entity's identity.
 <p>
 Follows <a
-href="../../specification/logs/data-model.md#type-any">any</a>
+href="https://github.com/open-telemetry/opentelemetry-specification/blob/v1.44.0/specification/logs/data-model.md#type-any">any</a>
 value definition in the OpenTelemetry spec - it can be a scalar value,
 byte array, an array or map of values. Arbitrary deep nesting of values
 for arrays and maps is allowed.
@@ -682,7 +682,7 @@ There are a couple of reasons:
 ### Attribute Data Type
 
 The data model requires the Attributes field to use the extended
-[any](../../specification/logs/data-model.md#type-any)
+[any](https://github.com/open-telemetry/opentelemetry-specification/blob/v1.44.0/specification/logs/data-model.md#type-any)
 attribute values, that allows more complex data types. This is different from the data
 type used by the Id field, which is more restricted in the shape.
 

spec-compliance-matrix.md

@@ -199,7 +199,6 @@ Disclaimer: this list of features is still a work in progress, please refer to t
 | LoggerProvider.Shutdown |  |  | + |  | + | + |  | + |  | + | - |  |
 | LoggerProvider.ForceFlush |  |  | + |  | + | + |  | + |  | + | - |  |
 | Logger.Emit(LogRecord) |  |  | + |  | + | + |  | + |  | + | - |  |
-| Reuse Standard Attributes | X | + |  |  |  |  |  |  |  |  |  |  |
 | LogRecord.Set EventName |  | + |  |  |  |  |  |  | + | + |  |  |
 | Logger.Enabled | X | + |  |  |  |  |  | + | + | + |  |  |
 | SimpleLogRecordProcessor |  |  | + |  | + | + |  | + |  | + |  |  |

spec-compliance-matrix/cpp.yaml

@@ -357,8 +357,6 @@ sections:
         status: '+'
       - name: Logger.Emit(LogRecord)
         status: '+'
-      - name: Reuse Standard Attributes
-        status: '?'
       - name: LogRecord.Set EventName
         status: '+'
       - name: Logger.Enabled

spec-compliance-matrix/dotnet.yaml

@@ -357,8 +357,6 @@ sections:
         status: '-'
       - name: Logger.Emit(LogRecord)
         status: '-'
-      - name: Reuse Standard Attributes
-        status: '?'
       - name: LogRecord.Set EventName
         status: '?'
       - name: Logger.Enabled

spec-compliance-matrix/erlang.yaml

@@ -357,8 +357,6 @@ sections:
         status: '?'
       - name: Logger.Emit(LogRecord)
         status: '?'
-      - name: Reuse Standard Attributes
-        status: '?'
       - name: LogRecord.Set EventName
         status: '?'
       - name: Logger.Enabled

spec-compliance-matrix/go.yaml

@@ -357,8 +357,6 @@ sections:
         status: '?'
       - name: Logger.Emit(LogRecord)
         status: '?'
-      - name: Reuse Standard Attributes
-        status: '+'
       - name: LogRecord.Set EventName
         status: '+'
       - name: Logger.Enabled

spec-compliance-matrix/java.yaml

@@ -357,8 +357,6 @@ sections:
         status: '+'
       - name: Logger.Emit(LogRecord)
         status: '+'
-      - name: Reuse Standard Attributes
-        status: '?'
       - name: LogRecord.Set EventName
         status: '?'
       - name: Logger.Enabled

spec-compliance-matrix/js.yaml

@@ -357,8 +357,6 @@ sections:
         status: '?'
       - name: Logger.Emit(LogRecord)
         status: '?'
-      - name: Reuse Standard Attributes
-        status: '?'
       - name: LogRecord.Set EventName
         status: '?'
       - name: Logger.Enabled

spec-compliance-matrix/php.yaml

@@ -357,8 +357,6 @@ sections:
         status: '+'
       - name: Logger.Emit(LogRecord)
         status: '+'
-      - name: Reuse Standard Attributes
-        status: '?'
       - name: LogRecord.Set EventName
         status: '?'
       - name: Logger.Enabled

spec-compliance-matrix/python.yaml

@@ -357,8 +357,6 @@ sections:
         status: '+'
       - name: Logger.Emit(LogRecord)
         status: '+'
-      - name: Reuse Standard Attributes
-        status: '?'
       - name: LogRecord.Set EventName
         status: '?'
       - name: Logger.Enabled

spec-compliance-matrix/ruby.yaml

@@ -357,8 +357,6 @@ sections:
         status: '+'
       - name: Logger.Emit(LogRecord)
         status: '+'
-      - name: Reuse Standard Attributes
-        status: '?'
       - name: LogRecord.Set EventName
         status: '?'
       - name: Logger.Enabled

spec-compliance-matrix/rust.yaml

@@ -357,8 +357,6 @@ sections:
         status: '?'
       - name: Logger.Emit(LogRecord)
         status: '?'
-      - name: Reuse Standard Attributes
-        status: '?'
       - name: LogRecord.Set EventName
         status: '+'
       - name: Logger.Enabled

spec-compliance-matrix/swift.yaml

@@ -357,8 +357,6 @@ sections:
         status: '?'
       - name: Logger.Emit(LogRecord)
         status: '?'
-      - name: Reuse Standard Attributes
-        status: '?'
       - name: LogRecord.Set EventName
         status: '?'
       - name: Logger.Enabled

spec-compliance-matrix/template.yaml

@@ -234,8 +234,6 @@ sections:
       - name: LoggerProvider.Shutdown
       - name: LoggerProvider.ForceFlush
       - name: Logger.Emit(LogRecord)
-      - name: Reuse Standard Attributes
-        optional: true
       - name: LogRecord.Set EventName
       - name: Logger.Enabled
         optional: true