Skip to main content
Start every investigation with the trace overview. It returns the first 20 immediate steps in the root trace, including persisted summaries when available. Use the trace ID shown in Sovara or a unique ID prefix. To use your own identifier from the SDK, include --project-id.
Use the same trace argument with step-overview and logs. Use --range for another zero-based, end-exclusive page:
Subtraces stay collapsed in their parent overview. Open one with --scope; the range applies to that subtrace’s immediate steps, not to a flattened tree.
The first command returns 3.1 and 3.2; the second returns 3.2.1 and 3.2.2. Nesting can continue to any depth.

​
Inspect one step

Use the step_ref from the overview:
--preview keeps large fields readable. Use it before fetching full input or output.

​
Inspect selected keys

Use --input, --output, and --key-regex when you know the field you need:
For LLM steps, inspection uses the actual input sent to the model, including the supplementary user message containing lessons applied to that step. Use --key-regex to select only the fields you need instead of dumping full prompts, tool arguments, or response payloads.

​
Get a semantic summary

When the exact payload is less important than the behavior, ask Sovara for a step overview:

​
Read logs

Use logs for captured stdout and stderr:

​
Good inspection sequence

Use step refs such as 6.2, not internal IDs.