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:
- Click period selector
- Choose month/year
- View historical metrics
Breakdown Views#
By Project#
See which projects consume most resources:
| Project | API Calls | Agents | % of Total |
|---|---|---|---|
| My SaaS App | 3,200 | 180 | 59% |
| Mobile App | 1,800 | 120 | 33% |
| Experiment | 420 | 42 | 8% |
By Agent#
See which agents are used most:
| Agent | Invocations | Avg Duration | Tokens |
|---|---|---|---|
| frontend-expert | 156 | 2.5s | 450K |
| backend-expert | 98 | 3.2s | 320K |
| database-expert | 52 | 2.1s | 180K |
By Time#
See usage patterns:
- Daily breakdown
- Weekly trends
- Peak usage times
Quota Management#
Quota Alerts#
Set alerts when approaching limits:
- Go to Settings > Alerts
- Enable usage alerts
- Set threshold (e.g., 80%)
- Choose notification method
Overage Handling#
When quota is exceeded:
| Plan | Behavior |
|---|---|
| Free | Requests blocked |
| Pro | Overage charges apply |
| Team | Overage charges apply |
| Enterprise | Custom 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#
- Click Export
- Select format (CSV, JSON)
- Choose date range
- 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#
| Metric | Free | Pro | Team | Enterprise |
|---|---|---|---|---|
| API Calls/mo | 1,000 | 10,000 | 50,000 | Custom |
| Agent Invocations/mo | 50 | 1,000 | 5,000 | Custom |
| Skill Applications/mo | 20 | 500 | 2,500 | Custom |
| Context Generations/mo | 20 | 500 | 2,500 | Custom |
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.csvReal-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 }'Related#
- Usage API - API reference
- Subscription - Plan management
- Rate Limiting - Rate limit details