Activity Log

Real-time feed of agent events and tool calls — search, filter, and inspect every action across your organization.

Overview

The Activity page provides two complementary views into agent behavior:

• Events — High-level actions: agent started, stopped, deployed, errored, task created, etc.
• Tool Calls — Granular tool usage: which tool was called, by whom, how long it took, and whether it succeeded or failed

Both views support full-text search, agent filtering, type filtering (events only), pagination, and click-to-inspect detail modals.

How It Works

On page load:

1. /agents?orgId=... — Loads agent list for name resolution
2. /activity/events?limit=25 — Fetches the first page of events
3. /activity/tool-calls?limit=25 — Fetches the first page of tool calls
4. /activity/events?limit=500 — Fetches a larger batch to populate the event type filter dropdown

Data is re-fetched whenever filters, search terms, or page numbers change. Search has a 300ms debounce to avoid excessive API calls.

Key Concepts

Events vs Tool Calls

Events Tab

The events table shows:

Click any row to open the Event Detail modal.

Tool Calls Tab

The tool calls table shows:

Click any row to open the Tool Call Detail modal.

Filtering & Search

Both tabs share a filter bar with:

• Search box — Full-text search across event types, tool names, details, etc. Debounced at 300ms.
• Agent filter — Dropdown to filter by a specific agent
• Type filter (Events tab only) — Dropdown with all discovered event types

Changing any filter resets pagination to page 1.

Detail Modals

Event Detail Modal

Shows all event fields in a structured view:

• Timestamp, type badge, agent name
• Session ID
• All fields from the event's data object (expanded)
• Event ID

Tool Call Detail Modal

Shows comprehensive tool call information:

• Timestamp, tool name, agent name
• Status (Success/Failed) with colored badge
• Duration in milliseconds
• Session ID
• Parameters — Full input parameters sent to the tool
• Result — Full output returned by the tool
• Error — Error message (only shown for failed calls)
• Tool call ID

Pagination

Both tabs use server-side pagination with 25 items per page. The pagination bar shows:

• "Showing X–Y of Z" counter
• First («), Previous (‹), numbered page buttons, Next (›), Last (»)
• Up to 7 page buttons visible at once, centered on the current page

Configuration & Setup

The Activity Log works automatically — events and tool calls are recorded by the engine as agents operate. No additional configuration is needed.

What Gets Logged

• Events: Agent lifecycle changes, deployments, errors, task state changes
• Tool Calls: Every tool invocation by every agent, with timing, parameters, and results

Data Retention

Activity data retention depends on your deployment configuration. Check your engine settings for retention policies.

API Reference

Event Object

{
  "id": "evt_abc123",
  "timestamp": "2026-03-03T14:30:00Z",
  "type": "agent_started",
  "agentId": "agent_xyz",
  "sessionId": "sess_456",
  "data": { /* event-specific fields */ }
}

Tool Call Object

{
  "id": "tc_abc123",
  "timestamp": "2026-03-03T14:30:05Z",
  "tool": "web_search",
  "agentId": "agent_xyz",
  "sessionId": "sess_456",
  "durationMs": 1250,
  "success": true,
  "parameters": { "query": "AgenticMail docs" },
  "result": { "results": [...] }
}

Best Practices

• Check tool call durations: Consistently slow tool calls (1000ms+) may indicate network issues or overloaded external services.
• Monitor failure rates: A sudden spike in failed tool calls often points to expired API keys or service outages.
• Use search for debugging: When an agent misbehaves, search for its name + "error" to quickly find the root cause.
• Review event patterns: Frequent "agent_stopped" → "agent_started" cycles may indicate instability.
• Filter by agent for audits: When reviewing a specific agent's behavior, use the agent filter to isolate its activity.
• Export data regularly: If your retention policy is limited, export important activity data via the API for long-term storage.

Troubleshooting

Related Pages