Skip to content

7.2 Story 7.2: OPEA Services OTel Tracing (ChatQnA + Retriever)

Sprint Key: 7-2-opea-services-otel-tracing-chatqna-retriever Epic: 7 PRD: testing-framework

Story 7.2: OPEA Services OTel Tracing (ChatQnA + Retriever)

As a developer, I want the ChatQnA and Retriever FastAPI services instrumented with OpenTelemetry, so that RAG pipeline requests (embedding, retrieval, reranking, LLM inference) are traced end-to-end with distributed spans observable via an OTLP-compatible backend.

Key Deliverables

  • Shared genie-ai-overlay/tracing.py module for all OPEA services
  • ChatQnA service instrumented with FastAPI auto-instrumentation + manual RAG spans
  • Retriever service instrumented with FastAPI auto-instrumentation + manual hybrid search spans
  • OTel dependencies added to both Dockerfiles
  • W3C traceparent propagation on inter-service calls
  • PII protection enforced at span-creation level (no query text/document content in attributes)

Acceptance Criteria (14 total)

See full story file in _bmad-output/implementation-artifacts/7-2-opea-services-otel-tracing-chatqna-retriever.md