Browsing sessions#
Use the Sessions List to audit all AI agent sessions detected for a cluster. Each session represents a complete interaction — all the SQL statements an AI agent executed within a single Airman MCP session.
Finding the sessions list#
The Home page lists every cluster across all configured instances. Each cluster card shows the cluster name, its status, and its project, and a search box filters the list. Select a cluster card to open its Sessions List.
If a configured instance fails to load, the Home page shows a per-instance error alert. If no instances are configured yet, it shows a zero state with a Configure Instances button. See Connecting data sources .
When you open a cluster, the Sessions List loads automatically and triggers a background sync if needed, so you see the latest data from the upstream source.
Reading the sessions table#
The sessions table supports customizable column visibility:
Column |
Default |
Sortable |
Description |
|---|---|---|---|
Session ID |
Always visible |
Yes |
Monospace identifier. Select it to open the Session Detail page. |
Purpose |
Visible |
Yes |
Declared purpose from the Airman MCP configuration. |
Started |
Visible |
Yes |
Timestamp of the first statement in the session. |
Commands |
Hidden |
No |
Tags showing the SQL command types in the session (SELECT, INSERT, UPDATE, and so on). |
Steps |
Visible |
Yes |
Total number of SQL statements executed. |
Errors |
Visible |
Yes |
Count of statements with error severity. Shown as a red badge when greater than zero. |
To change which columns appear, select the column visibility button (the gear icon) in the toolbar and use the checkbox list. Session ID is always visible and can’t be hidden.
Searching sessions#
The search field in the toolbar performs full-text matching across the session ID and purpose. Type a term and press Enter, or wait for auto-filtering. Use the clear button to reset the search.
Filtering by outcome#
The toolbar’s filter lets you narrow the list by outcome:
Filter |
Options |
Description |
|---|---|---|
Outcome |
OK, Issues |
Show only sessions that completed cleanly, or only those that contain at least one error. |
The filter is single-select — selecting a different option replaces the current one. Clear it to show all sessions again.
Configuring page size#
The table shows 10 sessions per page by default, configurable to 10, 20, or 50, with standard previous and next navigation.
Opening a session#
Select a session ID to open the Inspecting a session page, where you can inspect each SQL statement step by step and read the full audit log for that session.