Ignitify.dev
Watch usage and limits
Guides

Watch usage and limits

See what your plan allows with whoami and quota. See what you used with usage, and take the data out with usage:export.

1 · See who you are and what the plan allows

whoami prints the tenant, then the limits of its plan. The number after the plan name is its version: it starts at 1 and goes up each time the terms of the plan change.

terminal
$ ignitify whoamiTenant Profiletenant_id    019f2b10-3c55-7a01-b2e4-9d0c61f7a8b3resource_id  tnt_Xk29QmWr5LdAname         acmestatus       ACTIVEtier         starter v1bound_by     tier-entitlementEntitlements (tier policy)max_tasks                   15max_running_vms             3max_pinned_vms              0max_warm_vms                3max_secrets                 25max_webhooks                3

2 · See what you hold now

quota shows each live count against its limit, as used / max.

terminal
$ ignitify quotaUsage & Limitstasks                    7 / 15active_runs              0 / 3pinned_vms               0 / 0deployments              7disk_used                56.1 MiB / 1.0 GiBscratch_ceiling          512 MiBegress_out_this_month    0 Bdeployments_this_month   13api_requests_this_month  ~515 (approx)

3 · See what you used this month

usage prints one row per axis for the current month.

terminal
$ ignitify usageusage for 2026-10  AXIS        QUANTITY            LINES   RECONCILIATION  compute     10m 13s                 7   —  network     0 B                     0   agrees with the meter  network_in  934 B                   1   —  disk        1.4 GiB·h               8   —  scratch     5.0 MiB·h               7   —  runs        13                     13   agrees with the meter  pin         8m 51s                  7   —  build       3m 9s                   8   —  runs started 13   deployments created 13   API requests 515 (approx)

4 · Narrow it down

Pick a month with --period and an axis with --axis, filter by --vm or --run, and add --vms or --runs to list the lines behind the totals.

terminal
$ ignitify usage --period 2026-10 --axis compute --vmsusage for 2026-10  (filtered)  AXIS        QUANTITY            LINES   RECONCILIATION  compute     10m 13s                 7   —  AXIS        QUANTITY            VM / RUN                                DETAIL  compute     2m 28s              vm_019f3c2a-7d41-7b3e-9a10-4c5e8f21d0a6  running  compute     20 s                vm_019f3c31-0b88-7e52-8c47-1d6a9b3f5e02  running  compute     27 s                vm_019fdec7-3a10-7c52-9b84-6d2e1f0a8c47  running

5 · Export the lines

usage:export prints one row per ledger line, in the one format you name: --csv or --json.

terminal
$ ignitify usage:export --period 2026-10 --axis compute --csvaxis,vm_id,run_id,deployment_id,window_start,window_end,quantity,unit,detail"compute","vm_019f3c2a-7d41-7b3e-9a10-4c5e8f21d0a6","","019f3c24-1b05-7c9a-8e21-4d6f0b93a7e2","2026-10-12T23:49:38.882Z","2026-10-12T23:52:06.545Z","147663","ms","running"
terminal
$ ignitify usage:export --period 2026-10usage: ignitify usage:export [--period YYYY-MM] (--json|--csv)   (name exactly one format)