Read the usage page
The Usage page answers two questions. How close is this organisation to the limits of its plan? And how busy has it been? It shows quotas with bars, the features your plan includes, deployments per day with the failures marked, and the space your backups take at each storage provider. Anyone who can view resources can open it, so it is the page to send to a colleague who asks "why can't I add another server?".
This article explains each part of the page, what is counted and what is not, how the period buttons work and what the CSV export contains. For what the limits mean, see Compare plans and know your limits.
Before you begin
- Permission to view resources. The page needs resources:view, which every built-in role has. You do not need to be the owner, unlike the Billing page.
- An organisation with some history. A new organisation shows zeros until servers, sites and deployments exist.
- The right organisation. The numbers are for the organisation you are in, except the member count, which covers the whole account. Check the organisation name at the start of the breadcrumb.
1. Open the page
Choose Usage in the sidebar. The page is titled "What the organisation uses against its plan, and how busy it was."
- 7d, 30d, 90d. The period for the deployment figures and the day-by-day table below. The page opens on 30 days. The quotas and the backup storage do not change with the period, because they describe now, not a period.
- Export CSV. Downloads the figures on screen as a spreadsheet file (step 6).
- Plan quota. "What the owner's plan allows." Each line reads "used / limit" with a bar: Servers (archived servers are not counted), Sites, Members and Deployments this month ("Since" the first of the month).
- Included features. "Switched on by the plan." Backups, Monitoring, Teams and custom roles and API, each marked Included or not.
Two details trip people up. Unlimited in the limit column means the plan has no cap for that item. And Members counts people across every organisation of the account: the page says so under the line. It can therefore be higher than the number of members you see on the Members page of this organisation, for example 6 against 5, because the owner's personal organisation and any other organisations they own are included.
The quotas count everything in the organisation, whatever you are allowed to see. A member who sees only some servers because of teams still sees the true totals here, so that "limit reached" messages make sense.
2. Read the totals for the period
Below the cards, three tiles summarise the period you chose.
- Period buttons. The selected one, here 30d, is highlighted.
- Deployments, last 30 days. Every deployment of every site in the organisation, whatever its result.
- Failed. How many of them failed, and the share ("4% of deployments"). A failed deployment still counts as a deployment.
- Backup storage. The total size of the backup archives that are kept, "Across all storage providers". It is a total for now, not for the period.
A failure rate that jumps is worth a look: open the sites with failed deployments and read their logs. See Read a deployment log and find the failing step.
3. See the busy days
Scroll to Deployments per day: "Every deployment of every site, failures in red." There is one bar per day of the period, with the failed part in red on top. Hover a bar to read the day.
- The chart. The oldest day on the left (the date is printed at the bottom left) and today on the right. The tallest bar is the busiest day. Red on top of a bar is the failed part of that day's deployments.
- The table. The same figures as text: Day, Deployments and Failed, newest first. Click a column title to sort, use the search box ("Search a day...") to find a date, View to hide columns, and the page controls at the bottom for more rows. A day without deployments is listed with zeros.
Deployments are counted on the day they were created.
4. See where backups take space
At the bottom, Backup storage by provider lists each storage provider you have connected.
- The table. The Provider (its name and the kind, for example Amazon S3 or a custom S3-compatible service), the number of Archives kept and the space they use under Stored. "Archives kept by retention, database and file backups together." Archives that retention has already removed are not counted.
Use it to find which provider holds the most data and whether a retention setting is keeping too much. Backups and their retention are explained in Retention, failure alerts and testing a restore.
5. Watch the quotas over time
The usage page does not draw a history of quotas, so make a habit of a quick look. A useful routine is to open it on the first of the month: the Deployments this month meter has just started again, and you can see which limits you filled last month by comparing with the CSV you exported then.
If a plan limit blocks you, this is the page to read first. The line that shows "used / limit" with a full bar is the one in your way. If it is Servers, remember that archived servers are not counted, so archiving a server you no longer use frees a place.
6. Export the figures
Export CSV downloads a file named like usage-30d-2026-10-24.csv: the period and the date. It contains the same tables as the page for the period that is selected, with four columns: section, label, value and limit.
| section | what a row holds |
|---|---|
quota |
One row for each quota: the label, the amount used and the limit (or unlimited). |
deployments_total |
One row for each day: the date and the number of deployments. |
deployments_failed |
One row for each day: the date and the number that failed. |
backup_storage_bytes |
One row for each provider: its name and the bytes stored. |
backup_archives |
One row for each provider: its name and the number of archives. |
Open it in a spreadsheet, filter on section, and chart whatever you need. The file holds counts and provider names only, no secrets.
Troubleshooting
- The Members number is higher than my team. It counts the members of every organisation the owner owns, as the line below it says. See Members on the page.
- Deployments this month looks wrong. It counts every deployment created since the first of the month, whatever its result, failed ones included.
- The backup storage is zero but I have backups. Archives only count when the backup configuration uses one of your storage providers and the archive has not been removed by retention. Check the storage provider setup.
- I cannot open Usage. Your role does not include resources:view. Ask an owner or admin.
- The chart looks flat. A short period with few deployments makes a flat chart. Switch to 90d for the longer picture.
- I need older data than 90 days. The page offers 7, 30 and 90 days. Export the CSV regularly if you want a longer record.
Related
- Compare plans and know your limits: what each plan allows.
- Change your plan, update payment details and find invoices: act on what you see.
- Retention, failure alerts and testing a restore: keep backup space under control.
- The activity log: the 14-day record of what happened.