USER MANUAL · OPERATE

Activity

Real-time event feed of all agent operations across your fleet — powered by Server-Sent Events.

/activity

Overview#

The Activity page provides real-time operational visibility into everything happening across your agent fleet. Every significant event — approvals, cron job runs, cost anomalies, heartbeat checks, and configuration reconciliations — appears as a timestamped entry in a continuous, auto-updating feed.

The feed is powered by Server-Sent Events (SSE), which means new events stream into the page the moment they occur — no manual refresh needed. A live streaming indicator confirms the connection is active, and color-coded event cards let you scan for issues at a glance.

Prerequisites#

Prerequisites

At least one connector synced and online (see Connectors)
Agents running and generating events (approvals, cron runs, cost records, etc.)

Expected Results#

Once events are flowing, the Activity page shows:

-A live event stream that auto-updates via SSE, with a streaming indicator confirming the connection is active
-Color-coded event cards: amber for approvals, red for failures, green for successful completions, blue for informational events
-Each card displays event type badge, agent name, timestamp, and risk level where applicable

Web Operations#

Navigate to Activity from the Operate section in the sidebar.

Live Feed

The activity feed streams events in real-time using SSE (Server-Sent Events). New events appear at the top of the list as they happen. A pulsing dot indicator in the page header confirms the live connection is active. If the connection drops, it automatically reconnects.

Event Cards

Each event renders as a card showing: a colored type badge, the agent name that triggered it, a human-readable timestamp, and the risk level (if applicable). Cards are designed for fast visual scanning — you can spot failures (red) or pending approvals (amber) immediately.

Event Types

The feed captures five primary event types: approval (human-in-the-loop decisions), cron (scheduled job executions), cost (anomaly alerts and budget threshold warnings), heartbeat (periodic agent health pings), and reconcile (configuration drift detection and resolution events).

Filtering

Use the event type filter to narrow the feed to specific categories (e.g., show only approval or cost events). You can also filter by date range to review historical activity.

CLI Operations#

List recent activity events with optional type and date filters

Terminal

$ ap activity list

FAQ#

Q: Events are not appearing in real-time.

A: Verify that your connector is online and the SSE connection is active (look for the streaming indicator). If the indicator is missing, check your network connection and ensure the connector is synced (see Connectors).

Q: What event types exist in the activity feed?

A: There are five primary event types: approval (HITL decisions), cron (scheduled job runs), cost (spend anomalies and budget alerts), heartbeat (periodic health pings), and reconcile (config drift detection). Each type has a distinct color badge for quick identification.

Q: How long is activity data retained?

A: Activity events are stored as part of the audit trail. By default, events are retained indefinitely. You can search and filter historical events by date range. For export needs, use the CLI export command.