Skip to main content
Automatically capture module executions, signature predictions, and underlying LLM calls in DSPy programs.

Install

The dspy extra brings in DSPy itself along with the OpenInference instrumentor that emits its spans.

Set up

Usage

Once initialized, every DSPy module call and underlying LLM request is traced automatically:

Verify

Run your code and confirm the trace arrives:
  1. In the traceroot UI: Navigate to Tracing > Traces in traceroot Cloud. You should see a trace with root span CoTQA.forward — the outer module — with ChainOfThought.forward and Predict(StringSignature).forward nested beneath it.
  2. Via the CLI: Run traceroot traces list to inspect your recent traces from the terminal.

What gets captured

Limitations

  • Requires installing the dspy extra via pip install "traceroot[dspy]".

Run the example

Clone the repo and run a complete agent end-to-end.

Python

Run the Python example

Next steps

Python SDK Reference

Explore the full Python SDK reference and instrumentation options.

Cost Tracking

Learn how traceroot calculates token costs and tracks model spend.