Skip to content

docs: propose MCP server and backend client spans - #2669

Open
0YHR0 wants to merge 2 commits into
theagentrouter:mainfrom
0YHR0:proposal/mcp-backend-tracing
Open

0YHR0 wants to merge 2 commits into
theagentrouter:mainfrom
0YHR0:proposal/mcp-backend-tracing

Conversation

@0YHR0

@0YHR0 0YHR0 commented Sep 10, 2026

Copy link
Copy Markdown
Contributor

Description

The current MCP span combines the gateway's server role and its backend client roles, so fan-out backend latency and partial failures cannot be represented as independent operations.

Propose an opt-in SERVER span with per-backend CLIENT children, including unsampled propagation, independent request metadata ownership, JSON-RPC completion boundaries, and compatibility with current defaults. The design maps initialization, direct calls, aggregation, and notifications to concrete proxy integration points and specifies acceptance tests.

Related Issues/PRs (if applicable)

Design for #2562. This does not close the implementation issue.

Special notes for reviewers (if applicable)

Documentation only; no runtime topology changes. Please review the separate topology opt-in, request/dispatch trace handles, and matching-response completion semantics before implementation.

Developed with assistance from OpenAI Codex.

Signed-off-by: 0YHR0 <97868579@qq.com>
@0YHR0
0YHR0 requested a review from a team as a code owner September 10, 2026 07:22
@netlify

netlify Bot commented Sep 10, 2026

Copy link
Copy Markdown

Deploy Preview for theagentrouter ready!

Name Link
🔨 Latest commit db0713f
🔍 Latest deploy log https://app.netlify.com/projects/theagentrouter/deploys/6aa4b8e1636e2c00084fc356
😎 Deploy Preview https://deploy-preview-2669--theagentrouter.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

Signed-off-by: 0YHR0 <97868579@qq.com>
@codecov

codecov Bot commented Sep 12, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

@missBerg missBerg added design This is related to a design proposal or discussion area/mcp MCP proxy, MCPRoute, and MCP spec conformance area/observability Metrics, tracing, logging, GenAI observability labels Sep 16, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area/mcp MCP proxy, MCPRoute, and MCP spec conformance area/observability Metrics, tracing, logging, GenAI observability design This is related to a design proposal or discussion

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants