Finance Revenue Metrics Outcome

Consumption Revenue

Consumption Revenue: Revenue earned as customers use the product: consumption drawn from a prepaid balance, billed as overage above a commitment or billed on demand with no commitment.

Formula

Consumption Revenue = Sum of consumption drawn, billed as overage or billed on demand in the period

Computable definition

The canonical formula in the GASP formula grammar. The MCP server compiles it to SQL over the datasets listed below.

-sum(field.credit_amount where field.credit_event_type = 'consumption')

Unit: currency

Breakdowns

by_basis: one row per consumption_basis value
by_segment: one row per segment value

Notes: Consumption events carry a negative credit_amount; the metric reports a positive amount. Revenue recognised as usage occurs: drawn from a prepaid balance (committed), above a commitment (overage) or with no commitment (on_demand). Usage within a ratable commitment is no event; that revenue is the commitment, in MRR. by_basis returns one row per consumption basis.

Data requirements

Grain: Per credit event, aggregate monthly · Frequency: Daily sync · Aggregation: aggregate (month) · Staged: no · Main source: Billing.

Field	Dataset	Type
`credit_amount`	credit_event	decimal
`credit_event_type`	credit_event	string
`event_date`	credit_event	date

Example SQL (Postgres)

SELECT (-(SELECT COALESCE(SUM(credit_amount), 0) FROM credit_event WHERE event_date >= :period_start AND event_date <= :period_end AND credit_event_type = 'consumption')) AS consumption_revenue

Access: recommended sensitivity tier confidential, access scope unscoped. Guidance your policy engine enforces.

From an agent: with the GASP MCP server, call lookup_metric({ "name": "Consumption Revenue" }) or generate_query({ "metric": "Consumption Revenue", "adapter": "<your adapter JSON>" }).

What It Tells You

How much revenue usage earned in the period, whichever way the customer bought it. The breakdown by basis shows how much came from prepaid commitments, how much ran past them and how much arrived with no commitment at all.

Common Mistakes

Counting credit purchases as consumption revenue
Adding consumption revenue to MRR, which excludes uncommitted usage
Counting usage within a ratable commitment a second time beside the commitment

Connected in the GASP relationship graph.

Downstream: what this drives

Consumption Revenue measures Customer (Entity)
Consumption Revenue measures Subscription (Entity)

View canonical definition →

Sources

← Back to Finance metrics