Skip to content

LLM Observability: document OTel span links support#37399

Draft
ZStriker19 wants to merge 2 commits into
masterfrom
zach.groves/llmobs-otel-span-links-docs
Draft

LLM Observability: document OTel span links support#37399
ZStriker19 wants to merge 2 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
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.

1 participant