Chargeback & Allocation

Chargeback & Allocation turns normalized cloud, Kubernetes, data-platform, and SaaS billing into an auditable monthly allocation of cost to the teams, products, cost centers, and business owners responsible for it.

Use Chargeback & Allocation to classify direct and shared cost, apply allocation rules, reconcile allocated totals with source billing, and publish an authoritative monthly close for showback or chargeback reporting.

When to use it

• You need each team, product, business unit, or cost center to see the cost assigned to it.
• You want to distribute shared platform, support, tooling, networking, warehouse, or Kubernetes costs fairly.
• You need to allocate provider credits, discounts, refunds, and common costs.
• You want monthly showback or chargeback numbers that tie back to source billing.
• You need finance, FinOps, and engineering teams to review the same allocation ledger.

Before you start

Chargeback depends on complete source billing, clear ownership, and allocation rules that match your operating model.

Before closing a month, confirm:

• Billing ingestion is complete for the month.
• Perspectives, tags, accounts, projects, and resource ownership signals are up to date.
• Shared cost pools and allocation rules have been agreed with finance and service owners.
• The close period is open if rule changes or rebuilds are required.
• A chargeback worker is available to process queued runs.

Published months should be stable

Freeze a published month after finance review so its numbers cannot drift because of late rule changes or rebuilds.

Open Chargeback & Allocation

Go to Cost Management > Chargeback & Allocation from product navigation.

The active tab is reflected in the URL, for example:

/chargeback-allocation?tab=overview

Choose the right tab

Tab	Use it for	Close dependency
Overview	Executive summary for the selected month, including total allocated cost, provider split, top recipients, trends, and reconciliation health.	Requires an authoritative run.
Credit Allocation	Review how provider credits, discounts, and refunds are distributed.	Independent of monthly close status.
Chargeback Ledger	Drill into the detailed allocation receipt by recipient, component, account, region, resource, and line item.	Requires an authoritative run and showback projections.
Close	Run, monitor, validate, publish, or diagnose the monthly chargeback close.	Shows the latest run, including failed or non-authoritative runs.

Review the Overview

Open the Overview tab for the selected month.

Use it to answer:

• What was charged back this month?
• Which providers contributed the most allocated cost?
• Which teams, products, cost centers, or recipients received the highest allocation?
• Did allocated cost reconcile with source billing?
• How did allocation trend compared with recent months?

Numbers on the Overview reflect the authoritative run for the selected month. If the month does not have an authoritative run yet, the Overview is empty. Check the Close tab to see the latest run status and failing step.

Review the Chargeback Ledger

Open the Chargeback Ledger tab for the detailed allocation receipt.

The ledger shows:

Area	What to review
Recipient summaries	Total cost charged to each recipient.
Components	Direct usage, shared allocation, credits, refunds, and other allocation components.
Drill-downs	Account, region, resource, and line-item detail behind the recipient total.
Reconciliation	Whether allocated cost ties back to source billing within tolerance.

Use ledger drill-downs when a recipient asks why a number changed, why a shared cost was assigned, or which resources contributed to the total.

The ledger reads materialized showback projection tables. If those projections are missing for an authoritative run, CloudVerse can rebuild them on demand from the authoritative ledger.

Review Credit Allocation

Open the Credit Allocation tab to review how provider credits, discounts, and refunds are distributed.

Credit Allocation is driven by credit and discount configuration plus product cost. It can render even when the selected month has not completed an authoritative chargeback close.

Review this tab before publishing finance-facing numbers so credit handling is clear to recipients.

Manage allocation rules

Allocation rules move cost from a source onto recipients during close.

Concept	Meaning
Cost pool	A bucket of cost. Direct pools map to an owner. Shared pools hold cost that must be spread across recipients.
Perspective	An organizational lens such as business unit, team, product, environment, or cost center. Dynamic Perspective leaves can receive allocated cost.
Direct allocation	Cost is attributed as-is to the owner or recipient.
Shared allocation	Shared or pooled cost is spread using a rule.

Create a Perspective-to-Perspective rule

Use a Perspective-to-Perspective rule when direct cost from one Perspective should be allocated to the leaves of another Perspective. This is common for cross-charging between organizational views.

Go to Allocation Management > Allocation Rules, then click Create.

1. For Rule type, choose Allocate to Perspective.
2. Select the Source Perspective whose leaves are the cost origin.
3. Select the Target or Receiver Perspective whose leaves receive the cost.
4. Choose the allocation Basis:
   • Proportional - spread cost in proportion to each target leaf's own direct cost.
   • Fixed % - spread cost using explicit percentages. The percentages must sum to 100%.
5. Save the rule.

The rule executes on the next close or rebuild for the period. For Perspective rules, the source pool is normally resolved automatically from the source Perspective.

When rule changes take effect

Creating, editing, or toggling a rule for an open period triggers a durable full rebuild of that period so the ledger reflects the change.

Frozen periods are protected. Reopen the period before changing rules that affect published numbers.

Run a monthly close

Open the Close tab to run and publish a month.

The Close tab shows:

• Close readiness checks, including source completeness, rule execution, and reconciliation tolerance.
• Current run status and step progress.
• Failed or non-authoritative runs for diagnosis.
• Publish controls for promoting a successful run to authoritative.

Close lifecycle

A close run processes source billing through classification, allocation, reconciliation, projection materialization, and publication.

Step	What it does
INGEST_SOURCE_FACTS	Loads and validates normalized billing for the month.
CLASSIFY_FACTS_TO_POOLS	Assigns each cost line to a cost pool.
BUILD_DIRECT_EFFECTIVE_COST	Computes direct cost per pool.
BUILD_POOLS	Builds pool balances.
ALLOCATE_POOLS	Applies allocation rules onto recipients.
FINALIZE_CLOSE	Assembles the reconciled ledger and enforces the reconciliation gate.
MATERIALIZE_PROJECTIONS	Builds showback projection tables used by Overview and Ledger.
VALIDATE_RUN_INTEGRITY	Verifies projection and total consistency.
FINALIZE_RUN_STATUS	Marks the run authoritative and visible to users.

A run becomes visible on Overview and Ledger only after FINALIZE_RUN_STATUS completes successfully.

Authoritative runs and freeze

A month can have multiple runs, but only one run is authoritative.

Overview and Ledger use the authoritative run. If there is no authoritative run, those tabs are empty even if an earlier step completed successfully.

Use freeze after publishing a reviewed month. A frozen authoritative month is locked so its numbers cannot drift.

Technical data flow

Chargeback uses analytical billing data for source and ledger computation, then materializes showback projections for the UI.

Provider billing
  -> normalized billing facts
  -> chargeback engine
  -> cost pools
  -> allocation rules
  -> reconciled ledger
  -> showback projections
  -> Overview and Chargeback Ledger

Layer	Stores	Purpose
Analytical billing store	Normalized billing facts, source facts, and authoritative ledger entries.	Heavy cost analysis, source lineage, and reconciliation.
Operational store	Run state, run steps, showback projections, recipient summaries, drill summaries, line-item detail, and overview snapshots.	UI status, fast drill-down, and monthly showback views.

Per-tab data behavior

Tab	Reads from	Needs materialization?	Requires authoritative run?
Overview	Recipient summaries and overview snapshot, with reconciliation fallback where available.	Partial.	Yes.
Chargeback Ledger	Showback recipient, drill, and line-item projections; can rebuild from the ledger when needed.	Yes.	Yes.
Close	Run and step status, close readiness, and reconciliation checks.	No.	No.
Credit Allocation	Credit and discount configuration plus product cost.	No.	No.

If projection materialization fails after the ledger reconciles, Overview may degrade to reconciliation numbers and Ledger may rebuild lazily. This only works when an authoritative run exists. If the run never reaches FINALIZE_RUN_STATUS, the data tabs remain empty.

Detail levels

Ledger drill-downs can include these detail levels:

Detail level	Meaning
ACCOUNT_SCOPE	Account, subscription, project, workspace, or comparable billing scope.
REGION	Provider region or location dimension.
RESOURCE	Resource-level lineage where available.
LINE_ITEM	Finest-grain source billing line.

LINE_ITEM is the highest-cardinality level and can dominate projection materialization cost for large organizations.

Best practices

• Separate direct cost from shared cost before defining allocation rules.
• Reconcile allocated totals with source billing for the same period and cost basis.
• Publish only after source completeness, rule execution, and reconciliation checks pass.
• Freeze reviewed months so published chargeback figures stay stable.
• Review allocation rules quarterly and after reorganizations, tag changes, account additions, or major platform changes.
• Use Perspectives with clear owners and high coverage before relying on Perspective-based rules.
• Treat LINE_ITEM detail carefully for very large organizations because it can create large projection volumes.

Troubleshooting

A month is empty or all zero

Most often, the selected month has no authoritative run.

Open the Close tab and check the latest run and failing step.

Cause	What to check
No authoritative run	Confirm the run reached FINALIZE_RUN_STATUS and was published as authoritative.
Reconciliation gate failed	Check whether allocated cost ties back to source billing within tolerance. Look for mismatched holding, coverage, or shared buckets.
Incomplete ingestion	Confirm all provider billing dates and accounts were ingested for the period.
Materialization timeout	Review whether MATERIALIZE_PROJECTIONS failed for a large organization or high line-item volume.
No worker	Confirm a chargeback worker is running so queued runs do not remain pending.

A large organization fails during materialization

If FINALIZE_CLOSE succeeds but MATERIALIZE_PROJECTIONS fails, the ledger may reconcile but the run may never become authoritative. In that state, Overview and Ledger can appear empty while earlier months still show data.

This can happen when LINE_ITEM detail produces a very large number of projection rows.

Recommended remediation direction:

• Materialize projections in batches instead of one long transaction.
• Keep only the minimal atomic swap in a short transaction.
• Consider thresholding or gating LINE_ITEM detail for very large organizations.
• Do not rely only on increasing transaction timeout.

Glossary

Term	Meaning
Source facts	Normalized per-line billing for a month and provider.
Cost pool	A direct or shared bucket of cost used during allocation.
Perspective	A business lens such as team, product, business unit, environment, or cost center.
Allocation rule	Logic that moves cost from a source pool or Perspective onto recipients.
Ledger	The reconciled record of allocated cost.
Projection	Denormalized showback tables used by the UI for fast summaries and drill-downs.
Authoritative run	The single published monthly run shown by Overview and Ledger.
Freeze	A lock that prevents a published month from changing.

Related pages

• Perspectives - build the business scopes used by allocation rules.
• Cost Explorer - compare allocated results with source cost views.
• Budgets - monitor budget consumption after allocation is stable.
• Login and access issues - troubleshoot missing access to Chargeback & Allocation.