Tracing Patterns

What problem does it solve?

This Skill addresses the challenge of understanding and debugging complex, distributed systems by providing a robust framework for implementing end-to-end distributed tracing.

Core Features & Use Cases

• Context Propagation: Ensures trace context is automatically passed across service boundaries (e.g., Next.js to FastAPI) and between agent orchestrator, specialists, and tools.
• Span Hierarchy: Creates a clear, nested structure of spans representing the flow of execution, making it easy to pinpoint latency or errors.
• Automatic Instrumentation: Integrates with frameworks like FastAPI and SQLAlchemy to automatically create spans for requests and database queries, minimizing manual code changes.
• Use Case: Debugging a slow API request that involves multiple microservices, an agent performing several sub-tasks, and database interactions. This Skill allows you to visualize the entire request lifecycle, identify the bottleneck, and understand the root cause.

Quick Start

Apply the Tracing Patterns skill to instrument your FastAPI application by adding the TracingMiddleware as the outermost middleware.