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.

Metric/KPI-based split in Edit Mapping

Configure a telemetry-based split

  1. Define the filter conditions that capture the costs you want to allocate (for example, Service is not BigQuery).

  2. Select the Pipeline that holds your telemetry.

  3. Choose the Custom Dimension (Group By) to split costs by - for example, Department or Customer.

  4. Select the Allocation Metric used as the proportional weight - for example, api_calls, compute_hours, or data_processed_gb.

  5. Set the Time Granularity to match your billing period.

  6. Click Save.

    Telemetry-based mapping in Create Mapping

How the split is calculated

Umbrella calculates each dimension value's share of the total metric and allocates cost by that weighted percentage.

📘

Example

If 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.