USER MANUAL · INSIGHTS

Analytics

Track agent activity patterns, tool usage frequency, and cost trends with interactive dashboards.

/analytics

Overview#

The Analytics page provides a comprehensive metrics dashboard for your entire agent ecosystem. View aggregated usage data, identify activity patterns, and monitor cost trends over time.

Metric cards give you an at-a-glance summary, while interactive charts and usage tables let you drill down into specific agents, tools, and time periods.

Prerequisites#

Prerequisites

At least one active agent generating usage data
Cost data synced from your connected instances

Expected Results#

Once your agents have generated activity data, the Analytics page displays:

-Metric cards showing total requests, active agents, tool invocations, and cost totals for the selected period
-Interactive charts visualizing activity trends, cost breakdowns, and usage distribution
-Usage tables with sortable columns for per-agent and per-tool breakdowns

Web Operations#

The Analytics page is organized into three main areas: summary cards, trend charts, and detail tables.

Overview Dashboard

The top section displays metric cards for key indicators: total requests, active agent count, tool invocation count, and total cost. Each card shows the current value and a comparison delta against the previous period.

Time Range Selection

Use the time range selector to switch between preset periods (24h, 7d, 30d, 90d) or define a custom date range. All metric cards, charts, and tables update to reflect the selected window.

Metric Details

Below the charts, usage tables provide granular data. Sort by any column to find your most active agents or most frequently used tools. Click a row to navigate to that agent or tool's detail page.

CLI Operations#

Display a summary of analytics metrics for the current organization

Terminal

$ ap analytics overview

Show usage analytics for a specific agent

Terminal

$ ap analytics agent <id>

List the most frequently used tools across all agents

Terminal

$ ap analytics tools --top 10

FAQ#

Q: Why are my analytics metrics showing zero?

A: Analytics data requires agents to be actively processing requests. Verify that your agents are online and that the connector has synced recently. New data typically appears within a few minutes of agent activity.

Q: Can I export analytics data?

A: Yes. Use the Reports page to generate exportable reports from your analytics data. The CLI also supports exporting analytics output in JSON format with the --json flag.

Q: How far back does analytics data go?

A: Analytics data is retained based on your plan. Free plans retain 30 days of data, while Pro plans retain up to 1 year. You can query any time range within your retention window.