Clarify non-OTLP representation guidance nested AnyValue#5053
Open
pellared wants to merge 7 commits intoopen-telemetry:mainfrom
Open
Clarify non-OTLP representation guidance nested AnyValue#5053pellared wants to merge 7 commits intoopen-telemetry:mainfrom
pellared wants to merge 7 commits intoopen-telemetry:mainfrom
Conversation
Contributor
There was a problem hiding this comment.
Pull request overview
This PR refines the “AnyValue representation for non-OTLP protocols” guidance to make nested AnyValue encoding rules inside arrays and maps explicit and consistent with JSON semantics.
Changes:
- Make array encoding explicitly align with JSON arrays and enumerate JSON representations for each nested
AnyValuetype. - Clarify map encoding as JSON objects, including that keys are JSON member names and values follow the same rules as array elements.
- Add an Unreleased changelog entry for the documentation clarification.
Reviewed changes
Copilot reviewed 2 out of 2 changed files in this pull request and generated 3 comments.
| File | Description |
|---|---|
| specification/common/README.md | Expands nested AnyValue representation rules for arrays/maps using explicit JSON mappings. |
| CHANGELOG.md | Adds an Unreleased note documenting the clarification. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
bogdandrutu
reviewed
Apr 27, 2026
MrAlias
approved these changes
Apr 28, 2026
jmacd
approved these changes
Apr 29, 2026
reyang
approved these changes
Apr 29, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Why
Per #5028 (comment)
The previous wording only called out a few special nested cases, such as byte arrays, empty values, and special floating point values. This made the array and map sections less explicit than the top-level
AnyValuerepresentation guidance.The updated wording keeps the same intended representation, but makes the nested rules clearer and avoids duplicating full guidance between arrays and maps.
What
Clarifies how nested
AnyValuevalues are represented in the non-OTLP representation guidance for arrays and maps.This PR:
AnyValuetype should be represented as a JSON value;