You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
[Feature]: Accept a per-chat traceparent so opencode spans nest under the caller's trace #109
I drive opencode from a Python API (FastAPI) that is itself instrumented with OpenTelemetry and reports to SigNoz. Each user gets a long-lived container running opencode serve, and the API dispatches every chat turn over HTTP to that server. Both sides report to the same collector, so I have API spans and opencode spans in one backend, but no way to connect them: I want one end-to-end view of UI -> API -> opencode -> LLM/tool calls, and today the two halves are separate traces.
The plugin already knows how to adopt a remote parent, but only once per process: traceparent is resolved in config.ts from OPENCODE_TRACEPARENT at load time, turned into a context by remoteParentContext in trace-context.ts, and captured in the rootContext closure in index.ts. Every opencode.session span for the life of the process then hangs off that one fixed parent.
Because the server is long-lived and shared across many turns (and in my case many chats for the same user), a spawn-time environment variable cannot express "this turn was caused by that request". Setting it anyway puts every session, LLM, and tool span for the whole container into a single unbounded trace, which is worse than leaving them unparented.
Describe the solution you'd like
Let a traceparent be supplied per turn, and use it as the parent for that run's spans instead of the process-wide root.
Any one of these injection points would work for me, roughly in order of preference:
A traceparent (and optional tracestate) HTTP header on the chat request (POST /session/{id}/message), if opencode surfaces incoming request headers to plugins. This is the standard W3C path and needs no opencode-specific convention.
A field the caller can set on the message, for example metadata.traceparent on the user message, read in the chat.message handler.
A plugin option callback, for example resolveTraceparent({ sessionID, messageID, agent }), letting the embedder decide per run.
Behavior I would expect:
When a per-turn traceparent is present and valid, the run's opencode.session span (and its opencode.llm / opencode.tool.* children) parent to it, so the whole turn nests under the caller's span.
When it is absent or invalid, fall back to today's behavior: OPENCODE_TRACEPARENT if set, otherwise ROOT_CONTEXT. No change for existing users.
Subagent sessions keep resolving through resolveSessionTraceContext, so they stay nested under the parent run rather than reattaching to the remote parent directly.
Describe alternatives you've considered
No response
Telemetry type
Logs/Events
Additional context
Version: @devtheops/opencode-plugin-otel@1.4.0, protocol grpc, exporting to an OpenTelemetry Collector that forwards to SigNoz.
Checklist
I have searched existing issues and discussions for similar feature requests
I have checked the changelog to see if this already exists
+1. We need this on the 2.x line too, with the same setup: one long-running OpenCode 2 opencode serve per container, handling many sessions for different callers, each from its own upstream trace.
Some OpenCode 2 details that may make option 2 straightforward:
Where the parent comes from in 2.1.0.plugin.ts resolves OPENCODE_TRACEPARENT once, through remoteParentContext, into rootContext (~L94-109). The primary-session branch in handlers/session.ts (~L191-193) then always starts from ctx.rootContext(). Subagents already get a per-session parent through resolveSubagentTraceContext.
OpenCode 2 can carry it at session creation.POST /api/session accepts metadata (alongside parentID, title, agent, model, location, permissions), so a caller can attach W3C context when it creates the session, not only per message.
Concrete proposal:
If a primary session's metadata holds otel.traceparent (and an optional otel.tracestate), use that as the remote parent for that session's span tree instead of rootContext(). Read it from the session.created event if the metadata is included there; otherwise fetch the session through the V2 client.
Optionally, a per-message metadata.otel.traceparent overrides it for that turn, which is your option 2 and covers long-lived chats.
If it's missing or invalid, keep today's behaviour: OPENCODE_TRACEPARENT, or else ROOT_CONTEXT, with an invalid value logged and ignored as now. Subagents keep their current resolution.
We're already writing metadata.otel = { traceparent, tracestate } on every session we create, so we can test a branch against a real daemon.
+1. We need this on the 2.x line too, with the same setup: one long-running OpenCode 2 opencode serve per container, handling many sessions for different callers, each from its own upstream trace.
Some OpenCode 2 details that may make option 2 straightforward:
Where the parent comes from in 2.1.0.plugin.ts resolves OPENCODE_TRACEPARENT once, through remoteParentContext, into rootContext (~L94-109). The primary-session branch in handlers/session.ts (~L191-193) then always starts from ctx.rootContext(). Subagents already get a per-session parent through resolveSubagentTraceContext.
OpenCode 2 can carry it at session creation.POST /api/session accepts metadata (alongside parentID, title, agent, model, location, permissions), so a caller can attach W3C context when it creates the session, not only per message.
Concrete proposal:
If a primary session's metadata holds otel.traceparent (and an optional otel.tracestate), use that as the remote parent for that session's span tree instead of rootContext(). Read it from the session.created event if the metadata is included there; otherwise fetch the session through the V2 client.
Optionally, a per-message metadata.otel.traceparent overrides it for that turn, which is your option 2 and covers long-lived chats.
If it's missing or invalid, keep today's behaviour: OPENCODE_TRACEPARENT, or else ROOT_CONTEXT, with an invalid value logged and ignored as now. Subagents keep their current resolution.
We're already writing metadata.otel = { traceparent, tracestate } on every session we create, so we can test a branch against a real daemon.
FYI I did end up just point Claude at the plugin and modified it and got it to do what I want. I ended up not moving forward with it since Signoz has a plugin for open code that makes the solution work plenty enough.
Activity
jasoncarreira commentedon Nov 11, 2026
+1. We need this on the 2.x line too, with the same setup: one long-running OpenCode 2
opencode serveper container, handling many sessions for different callers, each from its own upstream trace.Some OpenCode 2 details that may make option 2 straightforward:
plugin.tsresolvesOPENCODE_TRACEPARENTonce, throughremoteParentContext, intorootContext(~L94-109). The primary-session branch inhandlers/session.ts(~L191-193) then always starts fromctx.rootContext(). Subagents already get a per-session parent throughresolveSubagentTraceContext.POST /api/sessionacceptsmetadata(alongsideparentID,title,agent,model,location,permissions), so a caller can attach W3C context when it creates the session, not only per message.Concrete proposal:
otel.traceparent(and an optionalotel.tracestate), use that as the remote parent for that session's span tree instead ofrootContext(). Read it from thesession.createdevent if the metadata is included there; otherwise fetch the session through the V2 client.metadata.otel.traceparentoverrides it for that turn, which is your option 2 and covers long-lived chats.OPENCODE_TRACEPARENT, or elseROOT_CONTEXT, with an invalid value logged and ignored as now. Subagents keep their current resolution.We're already writing
metadata.otel = { traceparent, tracestate }on every session we create, so we can test a branch against a real daemon.jesse-schein commentedon Nov 11, 2026
FYI I did end up just point Claude at the plugin and modified it and got it to do what I want. I ended up not moving forward with it since Signoz has a plugin for open code that makes the solution work plenty enough.