Construct Queries
The filter bar supports structured queries with autocomplete for field names, operators, and enum values.
Syntax:
Fields
Fields are fetched dynamically and may vary. The defaults:
| Field | Type |
|---|
trace_id | text |
run_id | text |
session_id | text |
name | text |
status | enum: ok, error |
user_id | text |
agent_id | text |
team_id | text |
workflow_id | text |
created_at | datetime |
start_time | datetime |
end_time | datetime |
duration_ms | number |
Operators
| Operator | Symbol | Works With |
|---|
| Equals | = | all types |
| Not equals | != | all types |
| Greater than | > | number, datetime |
| Greater than or equal | >= | number, datetime |
| Less than | < | number, datetime |
| Less than or equal | <= | number, datetime |
| Contains | contains | text |
| Not contains | !contains | text |
| Starts with | startswith | text |
| In (multiple values) | in | enum |
Combining Conditions
AND — all conditions must matchOR — any condition must match- Operators and keywords are case-insensitive (
and, AND, And all work)
Examples
Single condition:
session_id = 625185b5-6a7a-43bd-afae-339a989ea1cc
agent_id contains my-agent
agent_id startswith chatbot
status = ok AND agent_id = my-agent
status in "ERROR" AND agent_id != "sdghs"
status = ok AND agent_id = my-agent OR team_id = my-team
Time Filters
The date picker sits next to the filter bar.
| Preset |
|---|
| Last 30 minutes |
| Last 1 hour |
| Last 6 hours |
| Last 1 day |
| Last 7 days |
| All time |
| Custom (pick start and end dates) |
The filter bar and date picker are mutually exclusive. Applying a text filter clears the date range. Picking a date range clears the text filter.
Views
Toggle between two views using the Runs / Sessions tab at the top right of the filter bar.
- Runs — individual trace executions
- Sessions — traces grouped by session
