Quotas and Usage Alerts
Monitor workspace quota usage, configure alert thresholds, and acknowledge alerts in Devpilot.
Quotas and Usage Alerts
Every Devpilot workspace has quotas that cap how many of each resource type it can consume under its current plan. The quota dashboard shows live usage, the alert system warns you before you hit a limit, and the overage view shows what is already over. This guide covers what is tracked, how alerts work, and how to configure them.
Tracked Resource Types
Devpilot tracks quota usage for the following resources:
| Resource type | What it counts |
|---|---|
| Projects | Projects in the workspace (soft-deleted items excluded). |
| Apps | Apps across all projects. |
| Deployments | Deployments triggered in the current tracking period. |
| Team members | Active workspace members. |
A limit of 0 for a resource means unlimited under your current plan. The dashboard shows an Unlimited badge and the percentage is always zero.
The Quota Dashboard
The quota dashboard is available to every workspace member who can view the workspace — Owners, Admins, and Members all have read access.
Open Workspace > Quotas to see the following panels:
| Panel | Shows |
|---|---|
| Plan | The plan currently in effect (for example, Free, Pro, Enterprise). |
| Current usage per resource | Current count, quota limit, percentage used (rounded to 2 decimals), remaining units, and flags for Unlimited and Exceeded — one row per tracked resource. |
| Breakdown | Per-resource detail: current usage, quota limit, percentage used, remaining, projected usage, projected date when the quota will be hit, recent growth rate, and the resource's current status (Safe, Warning, Critical, or Exceeded). |
| Projections | A forecast for each resource: projected usage at the end of the window, projected date the limit is reached (null if not trending toward the limit), growth rate per day, and the number of historical data points used for the projection. |
| Active alerts | All alerts whose threshold still holds against live usage. |
| Calculated at | Timestamp of the snapshot, so you can tell how fresh the numbers are. |
The dashboard recomputes alerts against live usage, so alerts whose conditions no longer hold (for example, usage fell back below the threshold) are filtered out automatically. Only alerts that still apply are shown on the dashboard.
Usage Status Levels
Devpilot classifies every resource's usage into one of four status levels:
| Status | Condition |
|---|---|
| Safe | Below 80%. |
| Warning | 80% to 89.99%. |
| Critical | 90% to 99.99%. |
| Exceeded | 100% or more. |
These thresholds also match the default alert thresholds — crossing into Warning or Critical is what creates the corresponding alert.
Usage History
Open Workspace > Quotas > History (or use the history endpoint) to retrieve time-series usage for a chosen resource type. The view accepts:
| Parameter | Accepted values | Default |
|---|---|---|
| Resource type | Projects, Apps, Deployments, Team members | Projects |
| From date | Any ISO-8601 date | 30 days ago |
| To date | Any ISO-8601 date on or after From date | now |
| Granularity | Daily, Weekly, Monthly, Yearly | Daily |
Pick a granularity that matches the scale of the window — daily for a week or month, monthly or yearly for a long-running audit.
Alerts
When usage crosses a configured threshold, Devpilot records a quota alert. Alerts have one of three levels:
| Alert level | Default threshold | When it fires |
|---|---|---|
| Warning | 80% of the quota | Usage approaching the limit. |
| Critical | 90% of the quota | Very close to the limit. |
| Exceeded | 100% of the quota | Quota limit breached. The Exceeded level is fixed at 100% and cannot be configured. |
Each alert captures:
- The resource type it applies to.
- The exact threshold percentage that was crossed (stored with 2-decimal precision).
- The current usage and quota limit at the moment it fired (snapshot values).
- When it was sent and, eventually, acknowledged.
- Any extra context the alert service attached.
When you view alerts, Devpilot re-reads live usage and overlays the fresh numbers on the stored alert so you see the current state, not just the value at the moment the alert was created.
Viewing Active Alerts
Open Workspace > Quotas > Alerts. For each alert you see:
- Resource type and alert level.
- Threshold percentage that was crossed.
- Current usage vs. current limit, with the live percentage-used recomputed against today's data.
- Sent, acknowledged, and created timestamps.
Alongside the alert list you get statistics — counts of how many warnings, criticals, and exceeded events have occurred recently.
Acknowledging Alerts
Workspace Owners and Admins can acknowledge alerts. Acknowledgement records that someone has seen and handled the alert; it does not change usage or quotas.
Open the Alert
Go to Workspace > Quotas > Alerts and find the alert you want to acknowledge.
Click "Acknowledge"
The alert is stamped with the acknowledgement time. Acknowledged alerts are hidden from the active list on future dashboard loads (as long as usage is still above the threshold — if it has already dropped, the alert was already being filtered out as resolved).
Alerts are workspace-scoped. Acknowledging an alert in one workspace does not touch alerts in another workspace, even if the resource type is the same.
Configuring Alert Thresholds
Owners and Admins can adjust alert behaviour per resource type. Configuration is stored per workspace so each workspace can tune its own sensitivity.
Open Alert Configuration
Go to Workspace > Quotas > Alerts > Configuration. You will see one configuration row per tracked resource type. If a row does not exist for a resource type yet, Devpilot will create one with the defaults the first time you open it.
Choose a Resource Type
Select the resource whose thresholds you want to edit — Projects, Apps, Deployments, or Team members.
Set Warning and Critical Thresholds
Provide percentages between 0 and 100:
- Warning threshold — usage level at which a warning alert fires (default 80).
- Critical threshold — usage level at which a critical alert fires (default 90).
The Exceeded alert always fires at 100%; it is not configurable.
Toggle Delivery Channels
| Toggle | Default | Effect |
|---|---|---|
| Enabled | On | Turn all alerting on or off for this resource type. |
| Email alerts | On | Send alert emails to the workspace's alert recipients. |
| In-app notifications | On | Show alerts in the in-app notification tray. |
Save
The new thresholds apply on the next quota evaluation. Existing alerts are not retroactively re-evaluated — they keep the threshold percentage they were created with.
Keep the Warning threshold below the Critical threshold. A warning set higher than the critical threshold will never fire because usage will trigger the critical alert first.
Upgrade Recommendations
Devpilot generates upgrade recommendations from your usage patterns — when you are consistently close to a limit, a recommendation suggests a plan that gives you more headroom. Open Workspace > Quotas > Recommendations to see the current suggestions.
Recommendations are informational — no change is made to your plan until you choose to upgrade. Any member who can view the workspace can see the recommendations.
Overage Tracking
When usage crosses a quota (the Exceeded indicator shows on the dashboard), Devpilot records the overage for the period. Open Workspace > Quotas > Overages to see:
- Which resource types have gone over.
- By how much, and for how long.
- The period the overage covers — defaults to the current period, with a custom date range available.
Overage information helps you decide whether to tighten usage, clean up unused resources, or upgrade the plan.
Who Can Do What
| Action | Required workspace role |
|---|---|
| View dashboard, history, alerts, recommendations, overages | Owner, Admin, Member |
| Get alert configuration | Owner, Admin, Member |
| Acknowledge alerts | Owner, Admin |
| Update alert configuration | Owner, Admin |
Members who cannot view the workspace at all do not see any quota data.
How Counts Are Computed
- Projects and Apps are live counts of resources in the workspace (excluding soft-deleted items).
- Deployments and Team members are aggregated over the current tracking window.
- Percentages are rounded to two decimals. A limit of
0shows the percentage as0and flags the resource as Unlimited. - The Exceeded flag appears the moment usage reaches or exceeds the non-zero limit.
Next steps
Team analytics
Correlate quota movement with team activity and deployment trends.
Creating workspaces
Understand how plans and quotas are attached when a workspace is created.
System settings
Review the broader workspace settings that shape how quotas are consumed.
Access audit trail
See who acknowledged which alerts and when, alongside other access-related activity.