Skip to content

Document decimal format requirement for span/trace IDs in LLM Obs OTel evals#35137

Merged
Kyle-Verhoog merged 1 commit intomasterfrom
kyle/llmobs-otel-span-id-format
Mar 10, 2026
Merged

Document decimal format requirement for span/trace IDs in LLM Obs OTel evals#35137
Kyle-Verhoog merged 1 commit intomasterfrom
kyle/llmobs-otel-span-id-format

Conversation

@Kyle-Verhoog
Copy link
Member

@Kyle-Verhoog Kyle-Verhoog commented Mar 10, 2026

Summary

  • Clarify that span_id and trace_id must be decimal strings when submitting evaluations for OTel-instrumented spans
  • Add conversion guidance for OTel users whose instrumentation produces hexadecimal IDs
  • Update otel_instrumentation.md, external_evaluations.md, and api.md

Context

OTel uses hexadecimal span/trace IDs natively, but the backend stores and matches them as decimal strings. Users submitting evals with hex span IDs were experiencing silent join failures (evals not appearing on spans).

Test plan

  • Verify docs render correctly on preview
  • Confirm the format guidance is clear for OTel users

🤖 Generated with Claude Code

…bs OTel evaluations

Clarify that span_id and trace_id must be provided as decimal strings
when submitting evaluations, especially for OTel users whose
instrumentation natively produces hexadecimal IDs.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@Kyle-Verhoog Kyle-Verhoog requested a review from a team as a code owner March 10, 2026 13:47
@Kyle-Verhoog Kyle-Verhoog merged commit c79a570 into master Mar 10, 2026
22 of 26 checks passed
@Kyle-Verhoog Kyle-Verhoog deleted the kyle/llmobs-otel-span-id-format branch March 10, 2026 18:03
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants