Skip to main content
AI failures rarely produce one reliable error code. Observal preserves the session transcript so you can inspect what the user asked, which tools ran, what results the harness recorded, and how the agent responded.

1. Find the session

Open /traces in the web UI or list recent sessions:
Filter by harness, agent, user, model, or time range. Select the session that matches the reported failure.

2. Inspect the event sequence

Expand the session to review prompts, assistant responses, tool calls, tool results, lifecycle events, and subagent activity in source order. The CLI can unfold the same session structure:
Look for repeated tool calls, error results, missing inputs, unexpected model responses, or a stop event that occurred before the expected work completed.

3. Inspect recorded tool detail

The detail available for a tool call depends on the harness transcript. When present, Observal displays the tool name, input, result, and error indicators. Observal does not intercept MCP transport traffic or invent payload fields that the harness did not record.

4. Common patterns

5. Recover incomplete delivery

If the local harness still contains the session source, run:
Reconciliation resumes from the acknowledged checkpoint and replays missing source records idempotently.