Allocate Costs Based Telemtry & KPIs
Instead of splitting shared cost by fixed percentages, you can split it by real consumption - using a telemetry measure or a KPI as the allocation weight. This happens in Business Mapping.
Create or edit a mapping, enable Split cost, and choose the Metric / KPI Based method.
Configure a telemetry-based split
-
Define the filter conditions that capture the costs you want to allocate (for example, Service is not BigQuery).
-
Select the Pipeline that holds your telemetry.
-
Choose the Custom Dimension (Group By) to split costs by - for example, Department or Customer.
-
Select the Allocation Metric used as the proportional weight - for example,
api_calls,compute_hours, ordata_processed_gb. -
Set the Time Granularity to match your billing period.
-
Click Save.

How the split is calculated
Umbrella calculates each dimension value's share of the total metric and allocates cost by that weighted percentage.
ExampleIf Account A used 7,200 compute hours and Account B used 2,800 of 10,000 total, Account A receives 72% of the cost and Account B 28%. As telemetry values change, allocations recalculate.
📸 Screenshots: unit-economics-bm-edit.png → Image 12; unit-economics-bm-create.png → Image 13
❓ Confirm: exact path to Business Mapping; the difference between the Metric / KPI Based tab (Edit Mapping) and the Telemetry-Based create flow (Help panel) - confirm these are the same feature or distinguish them.
✅ Verify: the 72/28 split is an illustrative PRD example - keep it framed as an example, not a guarantee.
