Skip to content

LLM Observability: document OTel span links support#37399

Merged
ZStriker19 merged 6 commits into
masterfrom
zach.groves/llmobs-otel-span-links-docs
Jun 12, 2026
Merged

LLM Observability: document OTel span links support#37399
ZStriker19 merged 6 commits into
masterfrom
zach.groves/llmobs-otel-span-links-docs

Conversation

@ZStriker19

@ZStriker19 ZStriker19 commented Jun 9, 2026

Copy link
Copy Markdown
Contributor

What

Documents OpenTelemetry span links support in Agent Observability (LLM Observability):

  • New Span links subsection under OTel Supported features — explains that OTel span links are converted to Agent Observability span links, that in-trace links render as edges in the Execution Graph, and includes a from/to code example (tool output → LLM input).
  • New Span links table in the Attribute mapping reference (trace_id / span_id / attributes, including the dotted-key → underscore note).

Related

Backend support: dd-go PR #240129 (trace-indexer OTel → Agent Observability span link conversion).

Visual

A realistic example (support_agent_span_links.py) produces a trace whose Execution Graph shows a lookup_order → compose-answer span-link edge — screenshot to be added.

Claude session: b4fae8f5-991e-42ed-ba20-f2078a34cdfd

Add a Span links subsection under OTel Supported features (with a from/to
example and an Execution Graph note) and a span-link attribute-mapping
table to the reference section.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@ZStriker19 ZStriker19 force-pushed the zach.groves/llmobs-otel-span-links-docs branch from ca223b2 to 110003e Compare June 9, 2026 22:46
@github-actions

github-actions Bot commented Jun 9, 2026

Copy link
Copy Markdown
Contributor

Preview links (active after the build_preview check completes)

Modified Files

Add a multi-agent content-pipeline Execution Graph image to the OTel
span links section, showing span-link edges connecting the research,
writer, and editor agents.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@github-actions github-actions Bot added the Images Images are added/removed with this PR label Jun 9, 2026
Drop the "converts to Agent Observability span links" framing and the
"To match the convention used by the SDK" lead-in; describe how to use
span links instead.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@datadog-datadog-prod-us1

This comment has been minimized.

@ZStriker19 ZStriker19 marked this pull request as ready for review June 10, 2026 17:24
@ZStriker19 ZStriker19 requested a review from a team as a code owner June 10, 2026 17:24
@domalessi domalessi self-assigned this Jun 10, 2026

@domalessi domalessi left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

A few minor suggestions in line!

Comment thread content/en/llm_observability/instrumentation/otel_instrumentation.md Outdated
Comment thread content/en/llm_observability/instrumentation/otel_instrumentation.md Outdated
Comment thread content/en/llm_observability/instrumentation/otel_instrumentation.md Outdated
ZStriker19 and others added 3 commits June 10, 2026 14:39
…ion.md

Co-authored-by: domalessi <111786334+domalessi@users.noreply.github.com>
…ion.md

Co-authored-by: domalessi <111786334+domalessi@users.noreply.github.com>
…ion.md

Co-authored-by: domalessi <111786334+domalessi@users.noreply.github.com>
@ZStriker19 ZStriker19 requested a review from domalessi June 11, 2026 18:29
@ZStriker19

Copy link
Copy Markdown
Contributor Author

This is ready to merge now

@ZStriker19

Copy link
Copy Markdown
Contributor Author

@domalessi domalessi left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🚀

@ZStriker19 ZStriker19 merged commit f7bec2f into master Jun 12, 2026
26 checks passed
@ZStriker19 ZStriker19 deleted the zach.groves/llmobs-otel-span-links-docs branch June 12, 2026 17:50
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Images Images are added/removed with this PR

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants