Budget Management

On the [Cost & Finance > Budget Management] page, you can set cloud budgets, monitor spending against thresholds, and configure who is notified on exceedance.

Viewing Budgets

The page shows aggregated summary cards over a paginated budget list.

Summary Cards

CardDescription
Total Budget (Active)Sum of every active budget for the selected year
Effective ActualTotal cost recorded against active budgets — Effective Cost basis
Billed ActualSame total measured on the Billed Cost basis
Overall UsageAggregate utilization percentage across active budgets

Budget Table

ColumnDescription
Budget NameThe user-defined name. Click a row to open the detail page
PeriodPeriod type and range (Monthly / Quarterly / Yearly)
Budget AmountThe committed amount for the period
Used AmountCost incurred so far in the period
Remaining AmountBudget Amount − Used Amount
Usage RatePercentage of budget consumed
Cost vs BudgetInline progress bar paired with threshold colour
StatusActive / Expired / Not Started

Toolbar and Filters

UI ElementDescription
SearchSearch budgets by name
Period TypeFilter by All Periods / Monthly / Quarterly / Yearly
Cost BasisRestrict the actual values shown to Effective or Billed
Budget StatusAll / Active / Expired / Not Started
Threshold StatusAll / Exceeded / Critical / Warning / Normal
SyncTrigger a fresh aggregation (rate-limited)
More menu (⋮)Set Display (column visibility), Refresh

Bulk Actions

Selecting one or more rows reveals a floating bottom bar with a single bulk action — Delete. The bar shows the number of selected budgets and a Clear selection close button. Each row in the selection is deleted via an individual API call; partial failures are reported via toast (Some budgets failed to delete. Please retry.).

Creating a Budget

Click [+ Create Budget]

Click the [+ Create Budget] button in the upper right corner.

Enter budget details

FieldRequiredDescription
Budget NameYesDisplay name of the budget
Period TypeYesMonthly / Quarterly / Yearly
Period Start / EndYesRange based on the chosen Period TypeYear, Quarter, or Start Month / End Month
Duration(Yearly only)1 Year / 2 Years
Cost BasisYesEffective Cost or Billed Cost
OrganizationYesSelect the organization the budget belongs to. Organizations that already own a budget are filtered out
Budget ManagerYesPick a member of the selected organization, or type a free-form name
Notification RecipientsNoUsers notified when threshold rules trigger. Recommended list is sourced from the chosen organization
DescriptionNoOptional free-form description

Click [Create Budget]

Click the confirm button to save the budget. A success toast (Budget created.) is shown and the list refreshes.

Budget Detail Page

Clicking a row opens the detail page at /cost/budget/{budget_id}. The page has two tabs.

Overview

Summary cards (Budget Amount, Effective Actual, Billed Actual, ratio of actual of budget, Threshold Status) and a Budget vs Actual ({N}-Month) line chart. A Detail Sync action re-aggregates this single budget immediately.

Settings

Three sections:

  • Budget Manager — add / remove the manager assigned to this budget
  • Notification Recipients — add / remove users to notify on threshold breach
  • Threshold Rules — define when the budget triggers Warning, Critical, or Exceeded. Rules apply to both Effective and Billed values

Deleting a Budget

You can delete a budget either from the detail page (header trash icon) or by selecting one or more rows from the list and using the bulk bar described above. The confirmation dialog shows the budget name (or N budgets for bulk) and is required before the API is called.

⚠️
Deletion removes the budget definition, recipients, and threshold rules. Cost history is unaffected.
ℹ️
When no budgets exist, the page shows the empty state “No budgets found” with “Add a new budget to manage your cloud spending.” Click [+ Create Budget] in the header to begin.
v1.1.0