Usage Analytics
Monitor your site's resource usage, API calls, and performance metrics.
Overview
Usage Analytics provides insights into how your site and applications are being used. Track API calls, data transfer, storage consumption, and function executions to understand your usage patterns and optimize performance.
Concepts
Usage Metrics
Quantitative measurements of resource consumption including API calls, data transfer, storage, and compute time.
Billing Period
The time period for which usage is aggregated, typically monthly. Usage resets at the start of each billing cycle.
Usage Limits
Maximum resource consumption allowed by your subscription plan. Exceeding limits may result in throttling or additional charges.
View Usage Analytics
- Navigate to your Site in the Dashboard.
- Click the Usage & Analytics tab.
- View usage metrics organized by category.
Usage Categories
API Calls
Track the number of API requests made to your site:
- Total Requests: Sum of all API calls
- Successful: Requests that returned 2xx status
- Failed: Requests that returned errors (4xx, 5xx)
- By Endpoint: Breakdown by API endpoint
Data Transfer
Monitor bandwidth consumption:
- Inbound: Data received by your applications
- Outbound: Data sent to clients
- Total: Combined transfer amount
Storage
Track file storage usage:
- Total Used: Current storage consumption
- By Bucket: Usage per storage bucket
- File Count: Number of stored files
Function Executions
Monitor serverless function activity:
- Total Executions: Number of function invocations
- Compute Time: Total execution duration
- By Function: Usage per function
Time Period Selection
Filter usage data by time period:
- Click the time period selector.
- Choose from:
- Today: Current day usage
- This Week: Last 7 days
- This Month: Current billing period
- Last Month: Previous billing period
- Custom: Select specific date range
Usage Charts
Request Volume
View API request trends over time:
- Line chart showing requests per hour/day
- Identify peak usage periods
- Detect anomalies or spikes
Response Times
Monitor API performance:
- Average response time
- 95th percentile latency
- Slowest endpoints
Error Rates
Track error frequency:
- Error percentage over time
- Error breakdown by type
- Problematic endpoints
Export Usage Data
- Navigate to Usage Analytics.
- Select the desired time period.
- Click Export.
- Choose format (CSV or JSON).
- Download the usage report.
Configuration
Alert Thresholds
Configure alerts for usage limits:
| Metric | Alert Threshold |
|---|---|
| API Calls | 80% of limit |
| Storage | 90% of limit |
| Data Transfer | 80% of limit |
Notification Settings
- Navigate to Site Settings.
- Click Notifications.
- Enable usage alert notifications.
- Configure email recipients.
Limits
Usage limits depend on your subscription plan:
| Resource | Free | Pro | Enterprise |
|---|---|---|---|
| API Calls/month | 10,000 | 100,000 | Unlimited |
| Data Transfer | 1 GB | 50 GB | Custom |
| Storage | 500 MB | 10 GB | Custom |
| Function Executions | 1,000 | 50,000 | Unlimited |
Approaching your limits? Upgrade your plan or contact support.
Troubleshooting
Usage not updating
Problem: Usage metrics appear stale or not updating.
Solution:
- Refresh the page to load latest data.
- Note that metrics may have a 5-15 minute delay.
- Check the timestamp on the usage display.
Unexpected high usage
Problem: Usage is higher than expected.
Solution:
- Review the endpoint breakdown to identify heavy users.
- Check for runaway loops or misconfigured clients.
- Review function execution logs for errors causing retries.
- Consider implementing rate limiting.
Related
Last Updated: January 2025