Find the traces, sessions, and spans your application sent, narrow them down with search and filters, and read each one step by step.
Before you start
- Your application sends traces to a project. To set that up, see Instrument your code.
- To group traces into sessions, your application sets a session ID on each trace. To set that up, see Track users and sessions.
Open a list of traces, sessions, or spans
- Open your project, and then go to Traces. To find your project, see Create a project.

- Select the tab for the list you want: Sessions, Traces, or Spans.
- For Time, select a range.
The Traces list shows one row per trace, newest first. Its stats show Traces, Error rate, p95 duration, Avg duration, Tokens, and Cost.
The Sessions list shows one row per session, most recent activity first. A session groups the traces that share a session ID. Its stats show Sessions, With errors, Avg turns, p95 turns, Tokens, and Cost. Turns, tokens, and cost count only the activity inside the time range.

The Spans list shows the individual steps across every trace, such as model calls, tool calls, and retrievals, newest first. Its stats show Spans, Error rate, p95 duration, Avg TTFT (time to first token), Cache hits (the share of prompt tokens served from cache), and Cost. Cost covers every span in the time range, whatever filters you set.

Time offers these ranges:
- Last 15 minutes
- Last hour
- Last 24 hours (the default)
- Last 7 days
- Last 30 days
- Last 60 days
- Last 90 days
There's no "all time" option. Ranges longer than your project keeps data are unavailable and marked "beyond retention". To learn how long data is kept, see Data retention.
Choose a project on the shared Traces page
If you open Traces without a project in the link, the page asks you to pick one. It shows "Pick a project to see traces".
- For Project, choose your project. You can also select Browse projects to pick one from your project list.
The time range and other settings stay the same when you switch projects.

Search a list
- In the search box, enter part of a name or ID. The list updates shortly after you stop typing.
- To clear the search, press Esc.
Each list matches your text against different fields:
| List | Search box | Matches |
|---|---|---|
| Traces | Search trace or id | Trace name, trace ID, session ID |
| Sessions | Search session or user | Session ID, creator |
| Spans | Search span or trace id | Span name, tool name, trace ID |
Filter a list
- In the Filters rail, select a value in any group. Each value shows how many rows match it.
- To see more values in a group, select Show 3 more. The number in the label is the count of values that aren't showing yet. To show fewer, select Show less.
- To remove one filter, select the remove control on its chip above the list. To remove every filter, select Clear all.
Each list offers these filter groups:
- Traces: Trace, Span Kind, Status, Assets, Provider, Model
- Sessions: Has errors, Provider
- Spans: Step, Type, Status, Exception, Provider, Model, Tool, Finish reason, Payload, Service, Environment, Release, Agent, SDK
On the Traces list, Provider and Model count the traces whose model calls in the time range used that provider or model. On the Sessions list, Has errors counts only errors inside the time range. To learn what the Assets values mean, see Data quality overview.
A No value entry matches rows that have no value for that group. Yes/no values show as yes or no.
On narrow screens (1,080 pixels wide or less), the rail starts collapsed. Select Filters to show it. The page remembers whether you showed or hid it.
Filter by tags
- For Tags, choose one or more tags to include or exclude. The Tags filter is hidden while the Rules filter is on. To learn how tags work and how to filter by them, see Tag traces.
Show infrastructure traces and spans
The Traces and Spans lists hide infrastructure calls by default.
- On the Traces list, clear Hide infra traces to include traces whose root is an HTTP or MCP call.
- On the Spans list, clear Hide infra spans to include HTTP and MCP spans. The stats follow this setting.
Tip: The page link keeps the project, time range, page, page size, search text, tags filter, and rules filter, so you can share the view you're looking at. It doesn't keep your selections in the Filters rail.
Show only items that failed a rule
- For Rules, select Any failed rule, or select a single rule type if the list offers one. Each rule type shows how many items failed it.
- Review the list. It now shows only items with failing checks, most recent failure first.
While this filter is on, facets and search pause, sorting is off, and the Tags filter and Hide infra checkboxes are hidden. The stats are replaced by a count of the items with failing checks. To see every item again, select Clear rules filter (on the Sessions list, Clear checks filter). To learn what rules check, see Rules overview.
Sort, arrange, and page through a list
- Sort: Select a column header. Each selection cycles through descending, ascending, and the default order (newest first). Only some columns sort. For the list, see Read the list columns.
- Columns: Select Columns to show or hide columns. The label shows how many columns are visible out of the total, for example Columns 9/26. You can't hide the last visible column. Select Reset to defaults to restore the default columns. Your choices are saved in your browser for each list.
- Rows per page: For Show Rows:, select 10, 20, 50, or 100. The default is 20. Changing the page size or a filter takes you back to the first page.
- Pages: Use Go to previous page and Go to next page to move through the list.
- Refresh: Select Refresh to reload the rows and rule results. It's unavailable while the list is loading or when no project is chosen.
Read the list columns
Each list starts with a set of default columns. Add others, such as Session, User, or Model, with Columns.
| List | Default columns | Columns you can sort by |
|---|---|---|
| Traces | Started, Input, Output, Trace, Error, Rules, Assets, Duration, Tokens, Cost | Started, Ended, Trace, Trace id, Span Kind, Status, Duration, Session, User |
| Sessions | Last activity, First message, Created by, Has errors, Rules, Assets, Turns, Duration, Tokens, Cost | Last activity, Session, Created by |
| Spans | Start time, Input, Output, Error, Rules, Assets, Name, Type, Duration, Cost | Every column except Input, Output, Cost, Rules, and Assets |
Some cells need a word of explanation:
- Error (Traces): Shows "—" for traces that are ok. For a failed trace, it shows the first error message. If there's no message, it shows a count such as "3 spans errored", or "error" when only one span failed.
- Error (Spans): Empty for spans that are ok. For a failed span, it shows the error message, or the exception type, or "error".
- Status (Traces): A pill that reads "ok", or "error" with the number of failed spans.
- Duration (Traces): Includes a bar scaled to the slowest trace on the screen.
- Duration (Sessions): The time from the session's first activity to its last. Avg turn is that duration divided by the number of turns, and Messages is the number of turns times two.
- Created by (Sessions): The user who started the session.
- Assets: The data assets the run read or wrote. To learn how to read it, see Data quality overview.
Open a trace
- On the Traces list, select the link in the Trace column. You can also select the link in the Trace id column if you've shown it.
To open the trace with one span already selected, select its link in the Name column on the Spans list instead.

- Review the stat strip at the top: Message, Duration, Tokens, Spans, Documents, Errors, Rules, and Cost.
The header shows the trace ID and who started the trace and when, for example "Started by Dana Lee · 10:42 AM". If no user is known, it reads "Started" and the time. If the trace belongs to a session, a pill reads "Part of chat-4821 — open in session ›". Select it to open this trace inside its session.
The trace's tags show as chips above the stat strip. To add or remove tags, see Tag traces.
Rules in the stat strip shows a value such as "2 failed", "3 passed", "couldn't run", or "pending". While rules are still running, it adds "so far", as in "3 passed so far". When the trace has rule verdicts, a panel lists them. Totals on the page are calculated when you open it, so treat them as provisional.
If the trace recorded the data it used, an Assets used panel lists those assets. Select a row to open the span that used it. To learn more, see Data quality overview.
Work with the waterfall
The waterfall lists each span with its kind, a bar on a time axis, and its duration. The pane's header shows how long ago the last span arrived.
- Expand rows: Rows more than two levels deep start collapsed and show how many spans they hide, for example "4 hidden". Use the arrow next to a row to expand or collapse it.
- Spot problems: Errored spans are hatched and marked "err". Retrieval spans show how many documents they returned, for example "3 docs".
- See data use: Spans that read or wrote data assets show a count, for example "2 assets". The count is marked as failing when an asset was failing a data quality policy at the time it was read.
- Zoom in: Select a span's bar to focus the waterfall on that span and the spans under it. The header shows the span name and its position, for example "3 of 12". To go back, select the back button in the header, such as Back to the whole trace, or press Esc.
- Find a span: In Search spans, enter part of a span name. The waterfall shows only matching rows.
- Hide span kinds: In the legend, select a kind to hide or show it. The kinds are model call, tool, retrieval, agent, chain, mcp, http, database, and other. Your hidden kinds carry over to other traces. Select reset to show all kinds again.
- Open a span: Select a span name to open its detail pane.
A trace with more than 2,000 spans shows only the first 2,000. Later spans aren't loaded, so the time axis ends before the trace does.
Read a span's detail
- In the waterfall, select a span name. The span detail pane opens on the right.

- On the Input / Output tab, review the span's fields: Type, Status, Duration, Model, Tokens (input and output), First token, Cost, and Children.
- To share this exact view, select Copy link.
- To close the pane, select Close span detail (✕) or press Esc. If you've zoomed in, Esc leaves the zoom first.
Drag the pane's edge to resize it. It starts 400 pixels wide. The pane shows the span's own tags as chips. If the span errored, the pane shows the exception type and the error message. Cost appears in USD and is hidden when the span has no price. To learn how cost is estimated, see Cost tracking.
The pane can also show these sections:
- System instructions: Collapsed until you open it. Instructions longer than 8,000 characters are cut short. Select Show all to see the full text, and Copy to copy it.
- Input and output: Previews are capped at 2,000 characters. If the content was truncated, redacted, or expired, a pill shows that state. To learn how withheld content appears, see Redaction overview.
- Retrieved documents: For retrieval spans, this list replaces the output. It shows each document's rank, score, source URI, and chunk ID. Text longer than 320 characters is shortened. Select Show more to see the rest. Document text is capped at 4,000 characters.
The Raw tab shows the stored values the waterfall reads for this span. It doesn't show the original OpenTelemetry span.
Read a session
- On the Sessions list, select the link in the First message column. If you've shown the Session column, you can select its link instead. The session opens with its first turn selected.

- Review the stat strip: First message, Traces, Duration, Tokens, Documents, Errors, Rules, and Cost.
- In the Turns rail, select a turn. Each turn is one trace in the session.

- In the turn's waterfall, select a span name to open its detail pane.

The session page shows the session's tags as chips, the stat strip, the rule verdicts when there are any, and the Assets used panel. Select a row in Assets used to open the turn and span that first used that asset. Duration in the stat strip is the sum of the turns' durations.
Each turn in the rail shows its number, its message, and its start time, duration, and token count. Errored turns are marked. The message is the turn's input preview. If there's no preview, the rail shows the root span name, and if that's missing too, the trace ID. A session with more than 500 turns shows only the first 500, with a "capped" pill, and the stat strip reads "Duration (first 500 turns)". To hide the rail, select Collapse turns. When collapsed, the rail shows the number of turns, for example "Turns · 12".
Selecting a turn closes any open span. The turn's waterfall and span detail work the same way as on a trace page. For details, see Work with the waterfall.
Use the keyboard to move between turns:
| Key | Action |
|---|---|
| j or Down arrow | Select the next turn |
| k or Up arrow | Select the previous turn |
| Esc | Leave the zoom, then close the span detail pane |
The shortcuts don't work while you're typing in a box or holding a modifier key.
Troubleshooting
| Message | What to do |
|---|---|
| "No traces in this window", "No sessions in this window", or "No spans in this window" | Widen the time range or clear your filters. If nothing shows up at all, check that your application is running with the SDK set up. |
| "No sessions in this window" when the Traces list has rows | Your application might not be setting a session ID. See Track users and sessions. |
| "No failing rules in this window" | Widen the time range, or select Clear rules filter to see every item. |
| "No failing checks in this window" | Widen the time range, or select Clear checks filter to see every item. |
| "Pick a project to see traces" | For Project, choose a project, or select Browse projects. |
| "No project called “checkout-bot”" | The project in the link doesn't exist in this tenant. It might have been deleted, or it might belong to a tenant you're not signed in to. Select Pick a project. |
| "This link is missing its project" | The trace or session link doesn't name a project. Select Pick a project and choose the project the trace belongs to. |
| "No spans recorded for this trace" | The trace ID exists, but no spans were found for it within the 30-day retention window. The spans might have been dropped when they were received, or the trace is older than your data is kept. See Data retention. |
| "No turns recorded for this session" or "No spans recorded for this turn" | The session or turn exists, but no traces or spans were found for it within the retention window. See Data retention. |

Have a suggestion?