docs(research): agent-first OpenTelemetry semantics#1184
Draft
chadhietala wants to merge 1 commit into
Draft
Conversation
Contributor
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
chadhietala
force-pushed
the
chad/agent-otel-semantics
branch
from
July 24, 2026 17:56
0a9b9d4 to
8c4a345
Compare
chadhietala
force-pushed
the
chad/agent-otel-semantics
branch
from
July 24, 2026 18:00
8c4a345 to
63a4de7
Compare
Add a research proposal for a self-contained, vendor-neutral agent.* OTel convention that treats the agent run as the primary subject: span hierarchy (session trace → turn → step → action), an attribute registry (identity, agent/framework identity, structure & lineage, context, principal), a span-event vocabulary, and the natural extension points. Signed-off-by: Chad Hietala <chadhietala@gmail.com>
chadhietala
force-pushed
the
chad/agent-otel-semantics
branch
from
July 24, 2026 18:36
63a4de7 to
2e69dbf
Compare
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
1 participant
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 research proposal (
research/agent-otel-semantics.md) for a self-contained, vendor-neutralagent.*OpenTelemetry convention that treats the agent run as the primary subject — rather than layering on OTel's model-call-centric, payload-heavy GenAI conventions.The proposal defines, together:
agent.turn→agent.step→agent.action, with the tree reconstructed fromtraceId+ identity attributes + span links (emission-independent).agent.action.kinddiscriminator + singleagent.action.name), context, and principal.agent.action ⊂ agent.step, failures recorded on the span that failed (no propagation), uniform lineage, identifiers open by default with PII redactable.Status
Draft — research/design doc for review. No code changes;
research/-only, so no changeset ordocs:check.Open questions
agent.principal.id).