Sign in →

Analytics

Deep usage analytics, revenue attribution, COGS tracking, and custom reports powered by a high-performance analytics engine.

Updated 2026-06-15Suggest edits

Analytics

Aforo's analytics layer is built on a columnar analytics engine optimized for aggregation queries over billions of usage events. Usage events stream in continuously and are pre-aggregated so dashboards stay fast even at scale.

Usage Analytics

By Billable Unit

See how much of each billable unit customers consume, broken down by period:

GET /api/v1/analytics/usage/by-billable-unit?tenantId=...&period=30d

Returns per-unit totals, customer breakdowns, and trend data.

By Customer

Revenue and usage attribution by customer, including:

  • Total usage per billable unit
  • Invoice totals
  • Churn risk signals (declining usage, failed payments)

By Product

Usage across product types — compare API call volume between your Standard API and Agentic API products.

MCP Server Analytics

Specialized analytics for Model Context Protocol servers:

  • Tool invocations — which tools are called most
  • Agent sessions — session duration, active session counts
  • Revenue by tool — understand which tool calls generate most revenue
  • Agent attribution — which AI agents (Claude, GPT, LangChain, etc.) drive most usage

Event Log

The Event Log is a searchable audit trail of everything that happens on your platform:

  • API events — every request, status code, latency
  • Billing events — invoice created, payment received, subscription changed
  • Auth events — logins, API key creation, SSO
  • System events — deploys, health alerts, ERP syncs
  • Usage events — ingested events, anomalies, threshold breaches

Live Stream

The Event Log has a live stream mode powered by Server-Sent Events (SSE). Events appear in real time as they're ingested, with severity color-coding and auto-scroll.

Event log data is retained for 365 days.

Storefront Analytics

Track how customers interact with your public storefront:

  • Conversion funnel — Visitors → Product Views → Pricing Views → Signups → Subscriptions → First API Call
  • Drop-off analysis — which funnel step loses the most visitors
  • Daily trend charts — per-step historical data

COGS Analytics

Track Cost of Goods Sold to understand your gross margin:

  • Infrastructure costs per tenant
  • AI model costs (OpenAI, Anthropic) per product
  • Attribution to subscriptions for margin-per-customer reporting

Data Retention

StoreRetentionUse Case
Analytics store365 daysPrimary analytics, event log
Transactional store90 daysFallback, transactional queries
Rate-limit cache24 hoursReal-time rate limiting counters