Skip to main content

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​

CounterWhat it counts
Discovered itemsEach new resource a discovery adds.
Raw scansEach scanner run on a version, per platform for multi-arch images.
Dwaar scansEach time results are processed, including vulnerability re-checks.
Query unitsWhat 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 queriesEach read of a query you ran on Query or with an API key, one per page of results. This counter takes no limit.
AI requestsEach Dwaar AI call: a summary, an explanation, a built query, a scanner's AI step.
AI tokensTokens 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.

  1. Open Settings › Usage and choose to edit the limits.
  2. Enter a whole number for the limit. Leave it empty for no limit.
  3. Enter Warn at, a percentage from 1 to 100. This is the share of the limit where the warning starts.
  4. Save.

What you should see​

Each limit shows one of three states.

StateMeaning
Within limitUsage is below the warning level.
WarningUsage has reached the warning level.
Over limitUsage 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.