Skip to main content

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

  1. Navigate to your Site in the Dashboard.
  2. Click the Usage & Analytics tab.
  3. 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:

  1. Click the time period selector.
  2. 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

  1. Navigate to Usage Analytics.
  2. Select the desired time period.
  3. Click Export.
  4. Choose format (CSV or JSON).
  5. Download the usage report.

Configuration

Alert Thresholds

Configure alerts for usage limits:

MetricAlert Threshold
API Calls80% of limit
Storage90% of limit
Data Transfer80% of limit

Notification Settings

  1. Navigate to Site Settings.
  2. Click Notifications.
  3. Enable usage alert notifications.
  4. Configure email recipients.

Limits

Usage limits depend on your subscription plan:

ResourceFreeProEnterprise
API Calls/month10,000100,000Unlimited
Data Transfer1 GB50 GBCustom
Storage500 MB10 GBCustom
Function Executions1,00050,000Unlimited
info

Approaching your limits? Upgrade your plan or contact support.


Troubleshooting

Usage not updating

Problem: Usage metrics appear stale or not updating.

Solution:

  1. Refresh the page to load latest data.
  2. Note that metrics may have a 5-15 minute delay.
  3. Check the timestamp on the usage display.

Unexpected high usage

Problem: Usage is higher than expected.

Solution:

  1. Review the endpoint breakdown to identify heavy users.
  2. Check for runaway loops or misconfigured clients.
  3. Review function execution logs for errors causing retries.
  4. Consider implementing rate limiting.

Last Updated: January 2025