Understanding Usage Tracking
What Gets Tracked
TrailSpark tracks five metered features against your plan limits:
| Feature | What counts | Where it appears |
|---|---|---|
| Signals | Each webhook event received this period | Settings > Usage |
| Models | Finalized scoring models created this period | ICP Wizard (remaining count), Settings > Usage |
| Active Leads | Leads tracked in your workspace | Settings > Usage |
| Evaluations | LLM scoring evaluations run this period | Settings > Usage |
| Refinements | Model refinement iterations this period | Training Models page (remaining count), Settings > Usage |
Usage Display
The Settings > Usage page shows all five meters for the current billing period. Each meter displays:
- Current consumption vs. plan limit (e.g., "1,250 / 5,000")
- A color-coded progress bar (green under 80%, amber at 80-99%, red at 100%)
- An "Overages on" badge when overages are enabled for your organization
- Per-unit overage cost and estimated charges when usage exceeds the plan limit
You can view historical usage by selecting a previous billing period from the dropdown. An overage summary banner appears at the top when any feature is currently in overage, showing the estimated total overage charges for the period.
Usage indicators for specific features also appear inline on relevant pages -- for example, the ICP Wizard shows remaining model count, and the Training Models page shows remaining refinement credits.
Billing Cycle and Resets
Usage counters reset at the start of each billing period (monthly or annual, depending on your plan). The reset date is shown in Settings > Billing.
When You Hit a Limit
When a feature reaches its plan limit and overages are not enabled:
- The feature becomes unavailable until the next billing cycle
- A warning message appears with options
- Admins and owners see an upgrade or enable-overages prompt
- Other roles see a message to contact their admin
Overages
If your plan supports overages, an admin can enable them in Settings > Billing. With overages enabled, you can continue using features beyond your base limits. Overage charges are billed per unit at the rate shown on the Usage page.
Overage charges are billed in addition to your subscription fee. The per-unit rates vary by feature and plan tier.
Next Steps
- Evaluation Feedback -- Provide corrections on lead scores
- Model Refinement -- How feedback improves your scoring model