4.6. Monitoring & Analytics¶

Squad provides real-time monitoring, detailed execution history, and analytics to help you understand how your agent teams perform.

Monitoring Dashboard¶

The squad monitoring dashboard is your control center during execution. It uses a five-tab layout to organize information:

Overview Tab¶

The Overview tab shows a summary of the squad's current state. When any agent across any squad is waiting for tool-execution approval, a pinned Waiting for Approval section appears at the top of the tab, above the hero stats. It aggregates pending requests from all squads in a single view so no approval goes unnoticed while you are watching a different squad.

Each row in the approval section shows the agent ID, the tool name requesting approval, and a risk badge (safe, low, medium, high, or critical). Clicking a row opens the approval dialog for that request. The section collapses automatically once all pending approvals are resolved.

Hero Stats¶

At the top of the dashboard, three key metrics are shown at a glance:

• Active / Total agents — How many agents are currently running out of the total configured
• Session tokens — Cumulative token consumption for the current session across all agents
• Execution phase — Current phase of the squad execution (idle, planning, executing, aggregating, etc.)

Agent Activity¶

Below the hero stats, the Agent Activity section shows all agents in the squad. A List/Grid toggle in the section header switches between two layouts.

List view renders agents as a flat, sortable list. Each row shows the squad name, agent name, status badge, and a live preview of the agent's current task. Rows are sorted by urgency: running agents first, then agents waiting for approval, then agents in error, then idle.

Grid view renders each agent as a card in a responsive grid (1 column on mobile, 2 on tablet, 3 on desktop). Each card shows the agent name, status, token usage, and last activity. The grid uses the same filter controls as the list view.

Both views share the same two filter controls:

• Name filter — Type to filter by agent name (150 ms debounce, case-insensitive).
• Status chips — Click a chip (Running, Waiting, Error) to show only agents in that state. Chips display a count badge and only appear when at least one agent matches the status.

Clicking any row or card navigates to the agent's detail view at /squad/{squadId}/agent/{agentId}.

When no agents are configured, an empty state message is shown. When filters are active but match nothing, a "no match" message appears instead.

Execution Timeline¶

Below the agent activity section, the Execution Timeline shows each agent's state transitions as horizontal swimlanes. Each colored block represents one transition, sized proportionally to how long the agent spent in that state.

Colors correspond to agent states: green for running, red for error, yellow/amber for created, blue for completed, and gray for idle. Hover over a block to see a tooltip with the state label, duration, timestamp, and error cause if applicable.

A time axis below the swimlanes shows relative timestamps from the earliest recorded event to now. When no state transitions have been recorded yet, a placeholder message appears and the timeline populates automatically as agents run.

Activity Feed¶

A chronological log of squad events, including:

• Agent session started/stopped
• Task assigned, started, completed, or failed
• Memory updated
• Workspace file changed
• Budget warnings and overages

The feed updates in real time and keeps the most recent 200 entries. The following event types appear in the feed:

• Agent started, completed, or errored
• Task created or completed
• Full execution completed

Budget Meter¶

The budget meter (shown at the top of the Overview tab) displays real-time progress toward the squad's configured token and cost limits. It animates while the squad is executing. See Budget & Safety for details on setting limits.

Chat Tab¶

The Chat tab provides a conversational interface for interacting with the squad. Use it to:

• Send a new task or question to the squad
• Monitor streaming responses from agents as they execute
• Review the conversation history for the current session

Task Board¶

The Task Board tab provides a Kanban-style view of all tasks in the current execution:

Each task card shows:

• Task title and assigned agent
• Priority level (color-coded)
• Dependencies on other tasks
• Result summary or error message (when applicable)

Click a task card to open the Task Detail panel with the full description, output, logs, and token usage.

Workspace Tab¶

The Workspace tab provides a file browser for the squad's workspace directory. You can:

• Browse directories and preview files created by agents
• View logs, plans, task outputs, and generated artifacts

Analytics Tab¶

The Analytics tab combines the Execution History and the Analytics Dashboard.

Execution History¶

The Execution History panel lists all past executions for the squad:

• Search by request text or plan title
• Filter by status (completed, failed, cancelled)
• View summary: request, task count, token usage, duration

Click an entry to expand the execution detail drawer showing:

• Original request and generated plan
• Task-by-task results and artifacts
• Per-agent token usage breakdown
• Execution logs filterable by agent and severity
• Duration from start to completion

Generating Reports¶

Click Generate Report on any execution to produce a Markdown summary that includes:

• Execution overview (request, status, duration)
• Plan summary with task list
• Results from each task
• Token usage statistics
• Artifacts produced

Reports are saved to the workspace and can be shared with your team.

Analytics Dashboard¶

The Analytics Dashboard aggregates data across multiple executions to reveal performance trends.

Available Metrics¶

• Total executions — Count of completed, failed, and cancelled executions
• Success rate — Percentage of executions that completed successfully
• Average duration — Mean execution time in milliseconds
• Total tokens — Cumulative token consumption

Token Usage by Agent¶

A breakdown showing how tokens are distributed across agents. Identify which agents consume the most resources and whether the distribution matches expectations.

Daily Usage¶

A bar chart showing execution count and token usage per day, useful for spotting usage trends over time.

Period Selection¶

Filter analytics by time period:

• Day — Last 24 hours
• Week — Last 7 days
• Month — Last 30 days
• All — All recorded history