Usage and limits
You connected three more GitHub organizations last week. What did that do to your scan volume? You should be able to answer without waiting for someone to ask.
Settings › Usage shows what your tenant consumed, per day and per month.
Limits warn. They do not stop anything.
Read this first, because it is the opposite of what many tools do. A usage limit never stops a scan, a discovery or a query. It shows a warning, and that is all. You will not lose coverage because a counter ran past a number, and a limit will not protect you from a surprise either.
What is counted
| Counter | What it counts |
|---|---|
| Discovered items | Each new resource a discovery adds. |
| Raw scans | Each scanner run on a version, per platform for multi-arch images. |
| Dwaar scans | Each time results are processed, including vulnerability re-checks. |
| Query units | What Query and API key calls to GraphQL read from the database. One unit is about 100 rows. Asking Dwaar AI to build a query counts as AI usage instead. |
| Custom queries | Each read of a query you ran on Query or with an API key, one per page of results. This counter takes no limit. |
| AI requests | Each Dwaar AI call: a summary, an explanation, a built query, a scanner's AI step. |
| AI tokens | Tokens sent to and received from the model. |
| AI spend (estimated) | The estimated cost in USD. It is not an invoice. |
Days and months are in UTC, and today resets at 00:00 UTC. A chart shows the last 30 days. If a number looks a day off from your local calendar, this is why.
You need billing:read to see this page. Auditor and Billing admin hold it.
Set a limit
You need billing:update. You can set limits on the three scan counters and on Query units, per day or per month. The AI counters do not take limits here.
- Open Settings › Usage and choose to edit the limits.
- Enter a whole number for the limit. Leave it empty for no limit.
- Enter Warn at, a percentage from 1 to 100. This is the share of the limit where the warning starts.
- Save.
What you should see
Each limit shows one of three states.
| State | Meaning |
|---|---|
| Within limit | Usage is below the warning level. |
| Warning | Usage has reached the warning level. |
| Over limit | Usage has reached the limit. Scans and queries keep running. |
The AI budget
The AI spend budget lives under Dwaar AI settings, not here. Spend tracking is not available yet, so AI budgets do not currently provide a spending cap.
Try this next
Look at your raw scans for the last 30 days and set a monthly limit a little above your busiest month, warning at 80 percent. You are not capping anything. You are asking to be told when a new connection changes your baseline.