Usage Analytics

Monitor API calls, agent invocations, and quota utilization.

Overview#

The Usage page provides insights into your Bootspring usage:

  • Real-time usage tracking
  • Historical trends
  • Quota monitoring
  • Cost attribution

Usage Dashboard#

┌─────────────────────────────────────────────────────────────────────┐ │ Usage Period: January 2024 [▼] │ ├─────────────────────────────────────────────────────────────────────┤ │ │ │ Current Period Summary │ │ ┌────────────┐ ┌────────────┐ ┌────────────┐ ┌────────────┐ │ │ │ API Calls │ │ Agents │ │ Skills │ │ Context │ │ │ │ 5,420 │ │ 342 │ │ 89 │ │ 156 │ │ │ │ ████████░ │ │ ███░░░░░░ │ │ █░░░░░░░░ │ │ ███░░░░░░ │ │ │ │ 54.2% │ │ 34.2% │ │ 17.8% │ │ 31.2% │ │ │ └────────────┘ └────────────┘ └────────────┘ └────────────┘ │ │ │ │ Usage Trend │ │ ┌──────────────────────────────────────────────────────────────┐ │ │ │ ▃▅█▆▄▃▂▃▅▆▇█▆▅▄▃▄▅▆▇█▆▄▃▂ │ │ │ │ ▂▃▄▅██████████████████████████▇▆▅▄▃▂ │ │ │ │ ──────────────────────────────────────────────────────────── │ │ │ │ 1 5 10 15 20 25 30 │ │ │ └──────────────────────────────────────────────────────────────┘ │ │ │ │ Top Usage by Project │ │ ┌──────────────────────────────────────────────────────────────┐ │ │ │ My SaaS App ████████████████████░░░░ 3,200 (59%) │ │ │ │ Mobile App ████████░░░░░░░░░░░░░░░░ 1,800 (33%) │ │ │ │ Experiment ██░░░░░░░░░░░░░░░░░░░░░░ 420 (8%) │ │ │ └──────────────────────────────────────────────────────────────┘ │ │ │ └─────────────────────────────────────────────────────────────────────┘

Usage Metrics#

API Calls#

Total API requests made:

  • Endpoint calls
  • SDK requests
  • CLI operations

Agent Invocations#

AI agent usage:

  • Invocations per agent
  • Token consumption
  • Response times

Skill Applications#

Pattern applications:

  • Skills applied
  • Projects affected

Context Generations#

CLAUDE.md regenerations:

  • Full regenerations
  • Incremental updates

Viewing Usage#

Current Period#

The default view shows current billing period usage with:

  • Used vs. limit comparison
  • Percentage utilization
  • Days remaining in period

Historical Data#

Switch periods to view history:

  1. Click period selector
  2. Choose month/year
  3. View historical metrics

Breakdown Views#

By Project#

See which projects consume most resources:

ProjectAPI CallsAgents% of Total
My SaaS App3,20018059%
Mobile App1,80012033%
Experiment420428%

By Agent#

See which agents are used most:

AgentInvocationsAvg DurationTokens
frontend-expert1562.5s450K
backend-expert983.2s320K
database-expert522.1s180K

By Time#

See usage patterns:

  • Daily breakdown
  • Weekly trends
  • Peak usage times

Quota Management#

Quota Alerts#

Set alerts when approaching limits:

  1. Go to Settings > Alerts
  2. Enable usage alerts
  3. Set threshold (e.g., 80%)
  4. Choose notification method

Overage Handling#

When quota is exceeded:

PlanBehavior
FreeRequests blocked
ProOverage charges apply
TeamOverage charges apply
EnterpriseCustom agreement

Quota Reset#

Quotas reset on the 1st of each month at 00:00 UTC.

Usage Optimization#

Identify High Usage#

Review breakdown to find:

  • Projects consuming most resources
  • Agents being over-used
  • Unnecessary regenerations

Optimize Context#

Reduce context generation:

  • Use .bootspringignore
  • Configure include/exclude patterns
  • Enable incremental updates

Batch Operations#

Reduce API calls:

  • Use batch endpoints
  • Cache results locally
  • Avoid redundant requests

Exporting Data#

Download Report#

  1. Click Export
  2. Select format (CSV, JSON)
  3. Choose date range
  4. Download file

API Access#

1# Get current usage 2curl https://api.bootspring.dev/v1/usage \ 3 -H "Authorization: Bearer bs_xxx" 4 5# Get historical usage 6curl "https://api.bootspring.dev/v1/usage/history?period=daily" \ 7 -H "Authorization: Bearer bs_xxx"

Usage by Plan#

MetricFreeProTeamEnterprise
API Calls/mo1,00010,00050,000Custom
Agent Invocations/mo501,0005,000Custom
Skill Applications/mo205002,500Custom
Context Generations/mo205002,500Custom

CLI Commands#

1# View current usage 2bootspring usage 3 4# View usage breakdown 5bootspring usage --breakdown=project 6 7# Export usage data 8bootspring usage export --format=csv --output=usage.csv

Real-time Monitoring#

Dashboard Refresh#

Usage dashboard updates every 5 minutes.

Click Refresh for immediate update.

Webhook Alerts#

Subscribe to usage events:

1curl -X POST https://api.bootspring.dev/v1/webhooks \ 2 -H "Authorization: Bearer bs_xxx" \ 3 -d '{ 4 "url": "https://your-server.com/webhooks", 5 "events": ["usage.threshold_reached", "usage.limit_exceeded"] 6 }'