Session Tracker ULTRA

The Session Tracker gives you full visibility into every agent execution session. View running, completed, and failed sessions with step-by-step execution traces, Gantt timeline visualizations, and detailed duration analytics.

Session List

The main view displays a paginated list of sessions sorted by start time (most recent first). Each session row shows:

• Session ID — Unique identifier (e.g., ses_abc123)
• Agent — The agent that executed the session, with status indicator
• Status — Running, Completed, or Failed with color-coded badge
• Start time — When the session began (relative & absolute)
• Duration — Elapsed time for completed sessions, live counter for running ones
• Steps — Number of execution steps (completed / total)

Session Statuses

Execution Trace

Click any session to expand its execution trace. The trace shows every step the agent performed during the session, including:

• Step number — Sequential index within the session
• Step name — Human-readable label (e.g., "Parse user query", "Retrieve knowledge base context", "Generate response")
• Status — Completed, running, pending, or failed
• Start time & duration — Precise timing for each step
• Input data — The data passed into the step (expandable)
• Output data — The result produced by the step (expandable)
• Error details — For failed steps, the error message and stack trace

Gantt Timeline View

The Gantt timeline view provides a visual representation of session execution. Each step is rendered as a horizontal bar on a time axis, showing:

• Parallelism — Steps that execute concurrently appear on separate rows at the same horizontal position
• Duration proportionality — Bar length is proportional to step duration, making bottlenecks immediately visible
• Color coding — Green for completed steps, blue for running, gray for pending, red for failed
• Hover details — Hover over any bar to see the step name, duration, and status
• Zoom controls — Zoom in to see millisecond-level detail or zoom out for the full session overview

The Gantt view is particularly useful for identifying performance bottlenecks. Long bars indicate steps that take disproportionate time and may benefit from optimization.

Duration Tracking

The Session Tracker records precise timing data at multiple levels:

• Total session duration — Wall-clock time from first step start to last step completion
• Per-step duration — Individual step execution time
• Wait time — Time between steps (idle periods)
• Overhead — Difference between total duration and sum of step durations

Duration statistics are aggregated in the session list header, showing the average, median, and p95 session duration across all sessions in the current filter view.

Filtering Sessions

The Session Tracker supports multiple filter dimensions to help you find specific sessions:

Filter by Agent

Select one or more agents from the dropdown to show only sessions executed by those agents. This is useful for comparing performance between agents or investigating an issue with a specific agent.

Filter by Status

Toggle Running, Completed, and Failed to show only sessions matching the selected statuses. For example, filter to Failed only to review all error cases.

Filter by Date Range

Use the date picker to define a start and end date for the session list. Preset options include: Last hour, Last 24 hours, Last 7 days, Last 30 days, and Custom range.

Session Detail View

Click any session row to open the full detail view. This view combines all available information about the session into a single page:

• Header — Session ID, agent name, status badge, total duration, start/end timestamps
• Gantt timeline — Full-width timeline visualization of all steps
• Step list — Expandable list of each step with input/output data
• Error panel — For failed sessions, a prominent error panel showing the failure step, error message, and context
• Related events — Links to corresponding events in the Event Feed
• Related task — If the session was triggered by a task, a link to the task on the Task Board

Real-Time Updates

Running sessions update in real time via the Mission Control SSE stream. As an agent completes each step, the session detail view updates immediately:

• The step list adds the newly completed step
• The Gantt timeline extends with the new bar
• The duration counter continues to tick
• The step progress indicator (e.g., "3 / 7 steps") increments

When the session completes or fails, the status badge updates and the final duration is recorded. No page refresh is needed at any point.

Performance Analysis

Use the Session Tracker to identify performance patterns and optimization opportunities:

• Sort sessions by duration to find the slowest executions
• Compare Gantt timelines across sessions to spot inconsistent step durations
• Filter to failed sessions and examine common failure patterns
• Track duration trends over time to verify optimization improvements