Explore spans | Respan Docs

Open Observability → Spans to inspect individual LLM requests, tool calls, and workflow steps. Each row is one recorded operation.

Find the spans that matter

Select a project, then use the time picker to choose a preset range or enter a start and end time. The Time column shows the timezone.

Open table settings to change Sort by, the sort direction, and visible columns. Use Log ID to identify a span. For performance and usage, show Latency, Cost, and Total tokens; add Model or Span name for context. You can also display recorded custom properties as columns.

Full Spans page with Observability navigation, span table, toolbar, time range, and result count. — Each row on the Spans page is one recorded operation.

Filter spans

Click Filter (the funnel icon) in the table toolbar. Search for a field or scroll through the menu, then select the field you want to filter.

Full Spans page with the filter menu open at the top, showing Add filter group and the first filter fields. — Open Filter in the Spans toolbar to choose a field or add a filter group.

Full Spans page with the filter menu scrolled down through Feedback and the Log method submenu open. — Scroll down in the filter menu to see the remaining fields.

The value controls depend on the field:

Field	How to set the condition
Status	Choose Success, Error, or Warning. Use is to include a status or is not to exclude it. Error spans appear as Failed in the table.
Cost	Choose ≤ (at most), = (equal to), or ≥ (at least), enter a number, and click Apply.
Message	Enter text and click Apply. The resulting Message contains condition searches recorded message content.
Custom properties	Select a recorded property key, choose is or is not, enter its value, and click Apply.

Full Spans page with the Cost filter editor set to greater than or equal to 0.0005 and the Apply button enabled. — Set a comparison and value, then click Apply to add the Cost condition.

Use a condition’s × control to remove it, or Clear to remove all filters. The project and time range still limit the results.

Available filter fields

Filter by	Fields
Status and feedback	Status, Status code, Error, Error type, Fault domain, Behavior, Feedback
Content	Prompt, Message, Tools, Generation
Identifiers and application context	Customer ID, Evaluation ID, Group ID, Custom ID, Log ID, Thread ID, Trace ID, Parent span ID, Is root span, Workflow name, Task name
Provider and request configuration	API key, Credentials, Provider, Model, Log type, Log method
Usage and cost	Output tokens, Prompt tokens, All tokens, Cost
Cache and streaming	Is cache hit, Cache key, Is streamed
Custom properties	Property keys recorded by your application

Table columns and filter fields differ. Latency and Span name are columns; they are not fields in this filter menu. Provider is a filter, while Provider cache is a separate table column.

Conditions outside a group use AND: a span must match all of them. A new filter group uses OR, so a span can match any condition inside it. Click the group’s OR control to switch it to AND when every condition in the group must match.

This example finds spans containing AGENT_OK that either failed or cost at least 0.0005. The screenshots use a test request; replace AGENT_OK with text from your own spans.

Choose Filter → Message, enter AGENT_OK, and click Apply.
Open Filter again and choose Add filter group.
In the group, choose Status → Error.
Click Filter inside that group and choose Cost. Select ≥, enter 0.0005, and click Apply.
Keep OR selected inside the group.

Full Spans page showing Message contains AGENT_OK AND a group with Status is Error OR Cost greater than or equal to 0.0005, with matching rows below. — The Message condition must match, along with either condition in the OR group.

The complete filter is:

Message contains AGENT_OK AND (Status is Error OR Cost ≥ 0.0005)

Failed spans can match even when their cost is below the threshold. Successful spans can match when their cost meets it. Both still need AGENT_OK in their recorded message content.

Switch the group to AND to require both Error status and Cost ≥ 0.0005, as well as the Message condition:

Full Spans page with the same Message condition and an AND group requiring Error status and Cost greater than or equal to 0.0005, with no matching spans in this example. — With AND selected, both conditions inside the group must match.

Use × beside a condition to remove just that condition. The × beside the group removes the whole group.

Filter by custom properties

Choose Filter → Custom properties, select a property key, and enter its value with is or is not. Click Apply to add the condition.

For example, if your spans record environment: production, select environment and set it to is production. Available keys depend on what your application records. Check a span’s Metadata tab to see its properties.

Inspect a span

Select a row to open its detail panel. The header identifies the span and its timestamp, status, request type, and model where available.

Tab	Recorded content
Messages	Input and output
Tools	Tool definitions, arguments, and results
Metrics	Latency, tokens, cost, and other measurements
Metadata	Identifiers and custom properties
Config	Model and request configuration

The populated tabs and fields depend on the span type and what your application recorded.

Full Spans page with a span detail panel open, showing its header, Messages, Tools, Metrics, Metadata, and Config tabs, and AGENT_OK input and output. — Inspect recorded input and output in Messages, then use the other tabs for span details.

Use the message-format selector to choose Pretty, Markdown, JSON, or YAML. This changes the display format without changing the stored span.

Work with spans

The detail header includes Run, Assign to, and positive or negative feedback controls. Open the overflow menu for Show nearby requests and Save as Prompt.

To work with several spans, select their table checkboxes. The selection bar offers Assign to, Add to dataset, and a download control.

Full Spans page with selected rows and a bulk-action bar showing 22 selected, Assign to, Add to dataset, and a download icon. — Bulk controls appear when you select rows.

Troubleshooting

No spans match

Check the project and time range. Click Clear, then add conditions back one at a time. For a filter group, check whether AND requires conditions that the spans do not satisfy together.

Input or output is missing

Some span types do not contain messages. Check Metadata and Config for other recorded details, then confirm whether your application recorded content for that operation.