Browsing sessions v1

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:

ColumnDefaultSortableDescription
Session IDAlways visibleYesMonospace identifier. Select it to open the Session Detail page.
PurposeVisibleYesDeclared purpose from the Airman MCP configuration.
StartedVisibleYesTimestamp of the first statement in the session.
CommandsHiddenNoTags showing the SQL command types in the session (SELECT, INSERT, UPDATE, and so on).
StepsVisibleYesTotal number of SQL statements executed.
ErrorsVisibleYesCount 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:

FilterOptionsDescription
OutcomeOK, IssuesShow 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 Session Detail page, where you can inspect each SQL statement step by step and read the full audit log for that session.