oceanbase / oceanbase/powercontext

Tracking Issue: Fine-Grained Tracing for PowerContext

Open
#1,214 5 comments 0 reactions 0 assignees View on GitHub

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.md
  • src/powercontext/server/tracing.py
  • src/powercontext/client/tracing.py

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. 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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.