Skip to main content
Settings → Usage shows real-time consumption against your plan limits for the current billing period.

​
Metered resources

Each card shows current value, plan limit, and a progress bar. Clicking a card drills into a daily breakdown for the current period.

​
Plan limits

Current defaults (confirm against trulayer.ai/pricing for the latest):

​
Feature availability by plan

Rows marked — return HTTP 402 with code: "plan_upgrade_required" when called on an ineligible plan. The Starter eval-rules cap returns code: "eval_rules_quota_exceeded" instead.

​
Overage behaviour

  • Starter — hard block. Once you hit the monthly span cap, ingestion returns HTTP 429 with error.code = "plan_limit_exceeded" until reset or upgrade.
  • Pro / Team — metered overage. Ingestion continues; the overage is billed at the per-span rate shown at the top of the Usage page. A banner on the dashboard warns at 80% and 100% of the included allowance.
  • Enterprise — per-contract; speak to your account manager.
Evals overage follows the same pattern. Seat overage is always hard-blocked — inviting beyond the seat cap prompts an upgrade.

​
Data retention

Traces older than your plan’s retention window are permanently deleted nightly (rolling). Shortly before deletion:
  • Exports you need must be taken ahead of time — use the API /v1/exports.
  • Datasets created from old traces are preserved — only the raw trace storage is pruned.
Enterprise plans can request a retention override per project; see Team settings to contact your account manager.

​
Programmatic access

Returns the same data shown on the Usage page (current period, limits, overage). Handy for internal dashboards and alerts.