Usage and usage alerts

See what each service and usage type costs in the current and previous billing period, export the breakdown, and get an email when spending crosses a budget threshold.

The Usage page shows what the company’s services cost in the current and previous billing period: the total so far, a projection for the period, a daily chart and a breakdown by usage type and service. A usage alert on the same page emails you when spending crosses a share of a budget you set.

Before you begin

• You need the Company owner, Company admin or Company developer role to see the Usage page. Other people get You don’t have access to usage. People with a project role see their projects’ Usage tab instead.
• Only company owners and admins can create, update or delete a usage alert. Company developers see the alert but can’t change it. See Users and roles.

Open the Usage page

In the sidebar, under Company, click Usage. The page opens on the current billing period. Every filter you pick is kept in the page’s URL, so you can reload the page or share the link with the same view.

Usage takes 6 to 8 hours to appear, so the last hours of the period show up the next day. Usage data starts on Jan 31, 2026: periods before that are incomplete. Until a period has usage, the page shows No usage yet.

Read the summary

All amounts include tax.

Figure	What it is
Current period	What the services in your filters have cost so far this period
Projected total	Where the period is heading: the spend so far, plus the average daily spend of the completed days (leaving out the period’s first day) for each remaining day. The hint shows the daily average. It’s never lower than Current period. Until a full day has passed, it reads Not enough usage yet.
Previous period	The whole previous billing period
Change	Projected total compared with Previous period, in percent

With Previous period selected, the summary shows only Period total.

Filter the usage

Use the controls above the summary. Each filter narrows the summary, the chart, the breakdown and the export.

Control	Options
Period	Current period or Previous period. The dates of the period show beside the filters.
Projects	One or more projects. Picking projects narrows the Services list to theirs.
Services	One or more services, with an icon for each type
Usage type	One or more usage types
Clear filters	Removes the project, service and usage type filters

Read the chart

The Daily spend chart stacks each day’s spend by usage type. Up to seven usage types show by name; with more, the six largest show and the rest add up to Other. Switch between Daily and Cumulative (titled Spend over the period), between bars and lines, or click the table icon to see the values as a table. In the current period, the rest of the period shows the forecast, hatched on bars and dashed on lines. Hover a usage type in the breakdown to highlight it in the chart.

Read the breakdown

The Breakdown table lists every usage type with a cost in the period, largest first:

Column	What it shows
Name	The usage type and how many services used it. Expand a row to see each service’s cost. A service that no longer exists shows Deleted.
Net	The cost before tax
Gross	The cost with tax
% of total	The share of the period’s gross total

Usage types

Usage type	What it covers
App compute	Running instances of application processes
App persistent storage	Disks attached to application processes
App build time	Application builds
App bandwidth	Response data from applications’ domains
Database	Running databases
Static site build time	Static site builds beyond the free 600 minutes
Static site bandwidth	Static site bandwidth beyond the free 100 GB
Object storage	Data stored in buckets
Load balancer	The load balancer base fee
Load balancer bandwidth	Response data from load balancers

Prices for each are on Pricing.

Export or print the usage

Click Export, then Export as CSV or Export as JSON. The file contains the breakdown as filtered: each service’s net cost, gross cost and tax per usage type, rounded to cents. The CSV columns are Service type, Service, Net, Gross and Tax. Export is unavailable when the filtered period has no cost.

Click Print to print the page without its controls.

Project usage

A project’s Usage tab shows the same spending for the services in that project, with its own usage alert. See Projects.

Usage alerts

A usage alert sets a budget in USD for a billing period and sends an email when spending crosses a percentage of it. Alerts only notify: they never stop, suspend or limit a service.

Rule	Detail
Scope	One alert for the company (all services in every project) and one per project (that project’s services). Each is independent.
Budget limit (USD)	Any amount greater than $0. It counts as 100%.
Percentage thresholds	1 to 10 thresholds, each a whole number from 1 to 100, no duplicates. New alerts start with 80% and 100%.
Email recipients	One or more email addresses, no duplicates. They don’t need to be users of the company.
What’s compared	The period’s spending with tax, the same total as the Usage page
When	Sevalla checks every alert once an hour
How often an email goes out	Each threshold sends one email per billing period. Each hourly check sends at most one email, for the highest crossed threshold that hasn’t sent yet, so lower thresholds crossed at the same time send at later checks.
Reset	Thresholds become eligible again when the next billing period starts
Email	From [e-mail], subject Usage Alert: 80% of your spending limit reached (with the project’s name for a project alert)

Because usage takes 6 to 8 hours to arrive, an email can arrive a few hours after spending crossed the threshold.

Create a usage alert

1. Open the Usage page

   In the sidebar, under Company, click Usage. For a project alert, open the project and click its Usage tab instead.

2. Start the alert

   In the Usage alert card, click Add alert.

3. Set the budget

   In Budget limit (USD), enter the spending that counts as 100% for a billing period, for example 500.

4. Set the thresholds

   Under Percentage thresholds, keep or change 80 and 100. Click Add threshold for more, or the trash icon to remove one.

5. Add the recipients

   Under Email recipients, enter an email address. Click Add recipient for each additional address.

6. Save the alert

   Click Create alert.

The toast Usage alert created. confirms it. The Usage alert card then shows the period’s spend against the budget (for example $229.03 of $500.00 · 46% used), a bar with each threshold marked (red past 100%), when the budget resets, each threshold with Not sent yet or when it was sent, and the Email recipients.

Update a usage alert

In the Usage alert card, click Update, change the budget, thresholds or recipients, and click Update alert. Saving replaces the thresholds, so a threshold that already sent this period sends again at the next hourly check if spending is still past it.

Delete a usage alert

In the Usage alert card, click Delete, then Delete alert. No more emails go out for it. Deleting a project deletes its usage alert too.

Validation messages

Message	Cause
Budget is required	Budget limit (USD) is empty
Must be greater than 0	The budget is 0 or negative
Percentage is required	A threshold is empty
Must be a whole number between 1 and 100	A threshold is a decimal or out of range
Duplicate threshold	Two thresholds have the same percentage
Email is required	A recipient is empty
Invalid email	A recipient isn’t an email address
Duplicate email	The same address is listed twice

API and CLI

Task	API	CLI
List usage alerts	List usage alert configs	sevalla usage-alerts list
Get a usage alert	Get usage alert config	sevalla usage-alerts get <id>
Create a usage alert	Create usage alert config	sevalla usage-alerts create --limit-usd 500 --emails [e-mail] --triggers 80,100
Update a usage alert	Update usage alert config	sevalla usage-alerts update <id> --limit-usd 800
Delete a usage alert	Delete usage alert config	sevalla usage-alerts delete <id> --confirm

Add --project-id <id> to create for a project alert. A project alert’s project can’t be changed: delete the alert and create a new one.