oceanbase / oceanbase/powercontext
Tracking Issue: Fine-Grained Tracing for PowerContext
Nobody has claimed this yet.
- Dominant language
- Python
- Stars
- 1.1k
- Forks
- 212
- Avg merge
- 1d 11h
- Merged PRs (30d)
- 199
Description
Goal
Track the remaining tracing work on top of PowerContext's OpenTelemetry support.
This issue replaces #159 and the tracing requirements in #1163.
Current support
- W3C Trace Context propagation
- Optional OTLP export
- HTTP and MCP ingress spans
- Application operation spans
- Outbound PowerContext Client spans
- Request, trace, and span correlation in logs
Remaining work
- Document OpenTelemetry Collector and trace backend setup
- Trace Memory search and retrieval stages
- Trace reranking and context preparation
- Trace Memory capture, extraction, indexing, and persistence
- Trace generation, embedding, and other remote calls
- Trace scheduled and background processing
- Test span hierarchy, outcomes, and context propagation
Constraints
- Do not record queries, prompts, responses, Memory content, or vectors.
- Keep span attributes bounded.
- Tracing must remain optional and must not affect Runtime behavior.
- Do not store traces or build a trace viewer in PowerContext.
- Keep the existing operation names and W3C propagation contract.
References
docs/en/rfcs/0046_observability_foundations.mdsrc/powercontext/server/tracing.pysrc/powercontext/client/tracing.py
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start with docs/en/rfcs/0046_observability_foundations.md and inspect src/powercontext/server/tracing.py and src/powercontext/client/tracing.py. Map the unchecked tracing stages and the existing operation and propagation contracts before locating their implementation points. Done means the remaining stages and span hierarchy are covered without recording sensitive data, changing Runtime behavior, or breaking optional tracing.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- python
- Domain
- observability-sre
- Issue type
- Feature
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Quiet
- Clarity
- Needs clarification
- Newbie friendliness
- 35/100