Unit Economics

Unit economics is available on Professional and above. Everyone can view it. Only organisation admins can add metrics, values or targets. Revenue metrics need Business or Enterprise.

Cost per unit, not just totals

Total spend going up is not always bad news. If it grows slower than your business, each customer, order or request is getting cheaper. Unit economics shows which way it is going. Add a business metric, give it values, and CostOptix divides spend by it every month:

Scope	Spend it divides
Organisation	The total from Overview, with every dollar counted once
Team	That team’s sealed monthly bill from Ownership, or an estimate until the bill seals
Specific spend	Only what you pick: namespaces, workloads, host services, cloud accounts or services, tag values, or AI coding tool repositories

Open Unit Economics from the navigation. Each metric shows its latest cost per unit, the change from the month before, and a row per month for the last 12 months.

Add a metric

Click New metric, or pick one of the examples.
Give it a name and a unit, such as Active customers and customer.
Choose how a month adds up:
- Total for things that happen, such as orders or requests.
- Average for things you count at a point in time, such as active customers. Adding up daily customer counts would multiply your customers by 30.
Choose whether you record it daily or monthly, and whether it divides the whole organisation, one team, or specific spend.

How a month adds up, how often you record it and its scope cannot change later, because they change every past figure. The name, unit, target and the spend a specific spend metric picks can.

Scale large numbers. “API requests (thousands)” with the unit 1k requests reads better than a cost per request of $0.0003.

Specific spend

Some numbers belong to one part of the system, not a whole team. Cost per order of the checkout service, or AI coding tool cost per merged pull request in one repository. Choose Specific spend and pick what it divides, with the same pickers as Ownership:

Source	What you can pick
Kubernetes	Whole namespaces, or single workloads
Hosts	Whole hosts, or single services on them
Cloud	Whole accounts, services or resource groups within an account, or tag values
AI repositories	Git repositories that AI coding tools report usage from

Mix sources freely. A product can be its namespace, its database service and the repository its team works in. How it is counted:

Teams can own the same spend. A metric does not own anything, so a namespace can sit in a team and in any number of metrics.
Counted once. Cloud accounts leave out the cluster and host spend inside them, as on Overview, so picking an account and a namespace in it never counts the same dollar twice.
Direct cost. Kubernetes and hosts count what the picked workloads used, without a share of idle capacity.
Repositories get each day’s actual AI coding tool spend, seats included, in proportion to their share of that day’s usage.

Cloud picks by service, resource group or tag share Ownership’s choices: one tag key per cloud, and one split (service or resource group) per account. If nothing uses a tag key or split yet, the first metric to pick it sets it.

Cloud spend by tag or service is collected from when that tag key or split is first used, by a metric or by Ownership. Months before that show as Partial and cannot be locked. Whole accounts, Kubernetes, hosts and repositories have their full history.

Give it values

Method	How
By hand	Enter values on the metric, one per day or month
CSV	One `period,value` pair per line, with `YYYY-MM-DD` or `YYYY-MM` periods. A header line is skipped.
API	Create a key with only the `metrics:ingest` permission, then post values from your own systems
BigQuery	A query in your warehouse runs every day. See Import from BigQuery

curl -X POST https://costoptix.com/api/v1/metrics/<metric-id>/values \
  -H "X-API-Key: <metrics-key>" \
  -H "Content-Type: application/json" \
  -d '{"values":[{"period":"2026-10","value":1250}]}'

Sending the same period again replaces its value. Every change is recorded, with who made it and the value before.

Labels

Give a metric a label key, such as team, and each value carries a label: orders per team instead of one total. The metric’s unit cost uses the total across labels. Send one value per period and label:

-d '{"values":[{"period":"2026-10","label":"payments","value":900},{"period":"2026-10","label":"search","value":350}]}'

CSV lines become period,label,value. Once a metric has labels, every value needs one. Labels can only be turned on or off while the metric has no values. Revenue metrics can’t have labels. A shared cost on Ownership can be split by a labelled metric. Each label maps to a team, and each month is split by that month’s values. Labels without a team stay unallocated. A month waits for the metric’s values before its fully loaded cost seals, and reseals once they arrive.

Import from BigQuery

A count metric can take its values from a BigQuery query instead.

In Google Cloud, create a service account. Give it BigQuery Job User on the project that runs the query and BigQuery Data Viewer on the data it reads.
Create a JSON key for it.
On the metric, choose Import from BigQuery, paste the key and write the query.

The query returns one row per day: a day column (DATE) and a value column (a number), plus a label column (STRING) if the metric has labels. Filter it with @start and @end so each run reads only the days it needs:

SELECT DATE(created_at) AS day, COUNT(*) AS value
FROM `my-project.shop.orders`
WHERE DATE(created_at) >= @start AND DATE(created_at) < @end
GROUP BY day

CostOptix checks the query with a free dry run before saving, then imports the last 12 months. After that it imports each day at 05:45 UTC. Days add up into months the way the metric counts them: counters sum, gauges average.

Limit
One SELECT	Other statements are refused
10 GB per run	Billed to your project. A larger run fails without a charge
200,000 rows per run	Group the query by day
Service account keys only	Created in Google Cloud. The key is encrypted at rest

For a labelled metric, each run replaces the labels of the months it reads: a label the query no longer returns is removed for those months, and the removal is recorded in history. A run that returns no rows at all removes nothing, so an emptied or moved table never wipes past values. While connected, values can’t be edited by hand. Disconnect to edit them again.

Lock closed months

Cloud billing for a month can still change for a few days after it ends. Once it settles, the month shows Ready to lock. Locking it freezes the cost, the metric value and the unit cost, so later changes never move it. If a value changes after locking, the month shows Changed since lock. Locking it again adds a new version. Earlier versions are kept, never rewritten.

Targets and alerts

Give a metric a target cost per unit, and months above it are flagged. The Unit Cost Changed webhook (unit_cost.changed) alerts you when:

A daily metric’s cost per unit jumps well above its own recent history.
A month’s cost per unit goes above its target.

See Webhooks for the payload. Overview also calls it out when spend and unit cost move in opposite directions, such as spend rising while cost per customer falls.

Revenue

Revenue metrics need Business or Enterprise. If you move to a lower plan, revenue metrics are kept but become read-only, and imports pause.

Add a metric and choose Revenue, with the currency it is recorded in. Instead of a cost per unit, it shows infrastructure cost as a share of revenue, and the margin left after it. A target is entered as a percentage, such as 15%. Use the same currency as your costs. Revenue is never converted between currencies.

Revenue stays private

Control	What it means
Encrypted at rest	Revenue values, their history and locked months are stored encrypted
Admins only	Only organisation admins can see revenue, or anything worked out from it. Other members see that the metric exists and nothing else.
Never in webhooks	Revenue metrics never send the Unit Cost Changed webhook
AI assistant, by choice	The assistant can read revenue only if an admin turns that on for the metric, and only when an admin asks
Audited	Every view and change is recorded in the audit log

Import revenue from Stripe

Instead of entering revenue, connect it to Stripe and it updates every day.

In the Stripe Dashboard, open API keys and create a restricted key.
Leave every permission at None except Read on balance transactions. If Stripe reports a missing permission when you connect, add Read for the one it names.
On the revenue metric, choose Import from a payment platform, pick Stripe and paste the key.

CostOptix checks the key with Stripe before saving it, then imports the last 12 months. After that it imports each day at 05:45 UTC. You can also choose Import now.

What is imported	Detail
Net sales	Charges, minus refunds, disputes and failed payments, plus disputes you win and refunds that fail
Before fees	Stripe’s processing fees are not subtracted
By UTC day	Each transaction counts on the day Stripe created it
One currency	Only transactions in the metric’s currency. Totals in other currencies are listed on the metric, so nothing goes missing quietly.

Payouts, transfers, Stripe fees and Connect platform earnings are left out. If you run a Stripe Connect platform with destination charges, gross charges include money passed on to connected accounts. Only restricted keys (rk_live_ or rk_test_) are accepted. Secret keys are refused, so a leaked key can read balance data but never move money. The key is stored encrypted. While a metric is connected, its values cannot be entered by hand, by CSV or by API. Disconnect deletes the stored key. Values already imported are kept and become editable again.

Stripe is the first payment platform. Until yours is supported, send revenue by API.

Who can do what

Action	Who
View unit costs for count metrics	Everyone in the organisation
View revenue, its share and margin	Organisation admins
Add, edit, lock or delete metrics and values	Organisation admins
Connect or disconnect a payment platform	Organisation admins, on Business and above
Connect or disconnect BigQuery	Organisation admins
Send values by API	A key with the `metrics:ingest` permission

Getting Started

Connect Your Sources

See Your Spend

Act On It

Tools and Alerts

API Reference

Account

Security

Cost per unit, not just totals

Add a metric

Specific spend

Give it values

Labels

Import from BigQuery

Lock closed months

Targets and alerts

Revenue

Revenue stays private

Import revenue from Stripe

Who can do what

​Cost per unit, not just totals

​Add a metric

​Specific spend

​Give it values

​Labels

​Import from BigQuery

​Lock closed months

​Targets and alerts

​Revenue

​Revenue stays private

​Import revenue from Stripe

​Who can do what

Cost per unit, not just totals

Add a metric

Specific spend

Give it values

Labels

Import from BigQuery

Lock closed months

Targets and alerts

Revenue

Revenue stays private

Import revenue from Stripe

Who can do what