Skip to content

Usage and Metering

The Usage page gives you a clear picture of how your organization is using AI features in Agent Studio. It answers questions like: How many tool calls were made this month? Which agents are most popular? Are we approaching our quota?

Alation’s AI products are priced in Alation Consumption Units (ACUs) — a single currency you buy as one pool and spend across all AI-powered products, rather than per seat.

Agent Studio rate0.25 ACU per metered action
What’s a metered actionEach distinct LLM call or tool invocation an agent makes during a workflow
What’s freePassive activity — browsing, searching, reading, and manual edits never cost ACUs

Because most agent requests make 2–3 tool calls, a typical request costs roughly 0.5–0.75 ACU; a complex multi-step run costs more.

An admin (Server Admin or Catalog Admin) tracks the org-wide ACU balance on the Consumption Dashboard at Admin Settings → User Management → Consumption Dashboard. It refreshes daily and shows consumption trends, a per-product breakdown, and the remaining pool balance.

Alation warns at 80% and 90% of the pool. When ACUs run out, new metered actions are disabled — the affected buttons gray out with a tooltip explaining why.

The Usage page below is the Agent Studio-specific view of that consumption: every agent run, tool call, and action, with the filters to break it down.

Usage page showing KPI cards, time series charts, user breakdown, and tool call table

The Usage page shows aggregated counts of every AI interaction in your tenant — every agent run, every tool call, and every backend action (such as LLM calls or SQL queries). Data is broken down by time period so you can spot trends, identify spikes, and understand adoption patterns.

Every interaction is classified into one of three types:

TypeWhat it represents
AgentA complete agent run — the agent received a prompt, reasoned, called tools, and produced a response
ToolA single tool call made by an agent (e.g., searching the catalog, executing a query, fetching a data source)
ActionA backend operation that supports the AI — LLM inference calls, Alation API lookups, SQL query execution

A single agent run typically triggers multiple tool calls and actions. For example, asking an agent to “find revenue tables” might generate 1 agent run, 3 tool calls (search catalog, get data schema, get object fields), and 2 actions (LLM calls).

The specific name of the agent, tool, or action. Examples:

  • Agent names: sql_query_agent, catalog_context_search, charting
  • Tool names: search_catalog, execute_query, get_data_sources
  • Action names: query, search, data_source

How the interaction was triggered:

ProtocolMeaning
HTTPA call from the Agent Studio UI or a direct REST API integration
MCPA call from an MCP client (Claude Desktop, Cursor, VS Code, etc.)

This helps you understand where your usage is coming from — internal UI users vs. external MCP integrations.

Which Alation product triggered the usage:

Product areaDescriptionCounts against quota?
Agent StudioDirect usage via Agent Studio UI or APIYes
UnknownRequests where no product area was specifiedYes
Catalog SearchAI-powered search in the Alation catalogNo
Data Product MarketplaceData product generation and evaluationNo
AlamigoThe Alamigo virtual support assistantNo
Curation HubAI-assisted curation workflowsNo
Critical Data ManagerCritical data management workflowsNo

The pricing tier that was active when usage occurred:

TierMeaning
FreeUsage counting against your one-time free grant (never resets)
PaidUsage on an active subscription (resets monthly)

Total tool calls over time bar chart broken down by Free tier and Paid tier

Usage is shown at three levels of detail:

GranularityWhat it showsBest for
HourlyCounts per hourInvestigating specific spikes
DailyCounts per dayWeek-over-week trends
MonthlyCounts per monthBilling and capacity planning

Each time bucket shows two numbers:

  • Count — total number of invocations
  • Unique requests — how many distinct user requests generated those invocations

Agent Studio enforces usage limits based on your plan:

  • Free tier — a one-time cumulative grant of tool calls that never resets. Once exhausted, tool calls are blocked until you upgrade.
  • Paid tier — a monthly allocation that resets at the start of each billing period.

Only tool calls from quota-applicable product areas (Agent Studio and Unknown) count against your limit. Agent runs and actions do not consume quota directly.

Usage by users panel showing per-user tool call counts

You can narrow what you see on the Usage page by:

  • User — see a specific person’s usage (admins only)
  • Metric type — focus on just agents, tools, or actions
  • Protocol — compare MCP vs. HTTP usage
  • Product area — isolate Agent Studio usage from internal features
  • Tier — view only free or paid consumption
  • Time granularity — switch between hourly, daily, or monthly views

Why do I see usage I didn’t initiate? Some product areas (Catalog Search, Alamigo, Curation Hub) use AI features on your behalf as part of normal product operation. These show up in usage data but do not count against your quota.

Why is there a delay before my usage appears? Usage events are aggregated periodically (typically within a few minutes). Very recent activity may not appear immediately.

What’s the difference between “count” and “unique requests”? A single user request (like asking an agent a question) can trigger multiple tool calls internally. “Count” is the total number of tool calls, while “unique requests” is the number of original user requests that produced them.

Does Ask Alation (Alamigo) affect my tool usage quota? No. Alamigo is classified under the alamigo product area, which is exempt from quota. Ask Alation usage appears in the Usage page for visibility, but does not consume your tool call allocation.

Tool call table listing tool names, protocols, total counts, agent calls, and last used date

RoleWhat you can see
Server AdminAll users’ metrics across the entire tenant
All other rolesOnly your own usage