Skip to content

Alerts, rules and budgets ​

中文 Docs

Rules are evaluated against the ledger when the app opens and after each refresh — including the background refresh, which fetches each account once its refresh interval has passed while CloudBridge runs, with its window closed too on macOS and Windows. Each new alert posts a system notification. Opening the Alerts page re-checks whether open alerts have resolved.

The rules ​

Three rules ship enabled; review them on the Rules page and disable the ones you do not need.

RuleFires whenDefault
Model cost growth anomalyA source/service pair's daily spend exceeds its trailing 7-day baseline for consecutive daysAbove 2.5× for 2 consecutive days
Balance floorA prepaid balance falls below the account's monthly budget amount, or the default floor without one200, in the balance's own currency
Untagged spend ratioThe month's unallocated usage share exceeds the threshold and is higher than last month'sAbove 15% and growing

The anomaly rule needs a baseline: a service that cost nothing over the past seven days never fires it, however much it spends next. A workload that goes from nothing to a runaway — a forgotten project that starts looping — is caught by an Account budget rule based on the month-end forecast instead; Cloudflare walks through it.

New rule on the Rules page creates more: pick a kind, adjust its settings and click Create rule. A new rule is enabled at once, and an anomaly rule can be scoped to one account.

Budgets ​

The Monthly budgets card on the Rules page sets what an account may cost in a month. Pick the account, enter a Monthly budget and an Alert at (% of budget), and click Save budget; Remove deletes it. Each budgeted account then shows how much of its budget this month has used, in the reporting currency.

A budget on its own only draws that line. To be alerted, create an Account budget rule for the account and choose:

  • Based on — Cost to date for the month so far, or Month-end forecast for the run-rate projection;
  • Threshold type — % of budget, or a fixed Amount.

It works the other way too: the rule measures against the budget, so an Account budget rule on an account with no budget never fires, even with an Amount threshold. Set the budget first.

An account's budget also serves as its floor in the Balance floor rule.

Reading an alert ​

An alert carries the measurements behind it: spend and baseline, balance and floor, or unallocated share. Projections are estimates from recent data, not guaranteed month-end costs. Snooze hides an alert for a while; Dismiss closes it. An open alert is marked resolved when a later evaluation finds its condition no longer holds.

Notifications ​

Each alert that fires while CloudBridge runs is announced once as a system notification; alerts already open when the app started are not repeated. Turn them off under Settings → Background → Alert notifications.

Released under the MIT License.