llmobs: document gen_ai.conversation.id for multi-root grouping#37084
Open
ZStriker19 wants to merge 4 commits into
Open
llmobs: document gen_ai.conversation.id for multi-root grouping#37084ZStriker19 wants to merge 4 commits into
ZStriker19 wants to merge 4 commits into
Conversation
Adds a recommendation paragraph in the OTel instrumentation reference's Session and conversation section. After the trace-indexer change that stops preserving non-gen_ai workflow root spans, APM traces with multiple sibling gen_ai LLM calls now produce multiple independent LLM Observability traces (each with its own trace ID). Setting gen_ai.conversation.id to the same value on every gen_ai span keeps the resulting traces grouped together by session_id in the UI. Tracked in DataDog/dd-go PR #239022. Claude session: 3d39dd2d-18eb-4730-9671-8c93804e3657 Resume: claude --resume 3d39dd2d-18eb-4730-9671-8c93804e3657 Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Picks up the in-IDE refinement of the recommendation paragraph: clearer
phrasing ("APM trace's top-most span is not a gen_ai span"), explicit
nod to the cross-request conversation-grouping use case, and a "Tip:"
prefix in line with how the docs surface non-blocking guidance.
Claude session: 3d39dd2d-18eb-4730-9671-8c93804e3657
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Contributor
Preview links (active after the
|
ZStriker19
commented
May 28, 2026
cswatt
approved these changes
May 28, 2026
heyitsgrace996
approved these changes
May 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
3 participants
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.
Summary
Adds a recommendation paragraph in the OpenTelemetry instrumentation reference's "Session and conversation" subsection. After the trace-indexer change in DataDog/dd-go#239022, APM traces with multiple sibling gen_ai LLM calls under a non-gen_ai parent produce multiple independent LLM Observability traces (each with its own trace ID). Customers who want the resulting traces grouped together in the UI should set
gen_ai.conversation.idto the same value on every gen_ai span; that flows through to LLMObssession_id.The attribute mapping itself is already documented (one-line entry in the table). This adds a short paragraph below it explaining when and why to set it.
Test plan
Related
Claude session: `3d39dd2d-18eb-4730-9671-8c93804e3657`
Resume: `claude --resume 3d39dd2d-18eb-4730-9671-8c93804e3657`
🤖 Generated with Claude Code