The Statistics page provides real-time insights into your application's performance, user growth, and resource consumption. It is designed to help you monitor scaling needs and track engagement trends through a high-level dashboard.

1. Key Metrics (Overview Cards)

At the top of the Statistics modal, three primary indicators provide an instant snapshot of your app's health:

Total Users

1. Definition: The cumulative count of unique user accounts registered within your application.
2. Data Source: Live count from the User collection associated with your appId.
3. Update Frequency: Real-time upon opening the modal.

Average RPM / Minute

1. Definition: Requests Per Minute. This measures the intensity of traffic hitting your backend services today.
2. Calculation: Total API Calls Today ÷ Minutes Elapsed Since Midnight.
3. Why it matters: Unlike a flat daily total, RPM helps you understand the "velocity" of your app. A sudden spike in RPM may indicate a viral moment or a potential need to upgrade your hosting tier.

Storage Used

1. Definition: The total disk space occupied by your application's database records and uploaded assets.
2. Formatting: Automatically scales from MB to GB once usage exceeds 1,024 MB for easier readability.
3. Data Source: Aggregated from your app's dedicated storage volume.

2. API Call Activity Chart

The interactive line chart visualizes backend activity over time. It aggregates all system events, including authentication, database queries, and file operations.

Time Range Selection

You can filter the chart data using the dropdown menu to identify patterns over different periods:

Last 24 Hours - Hourly - Identifying peak usage times during the day.

Last 7 Days - Daily - Tracking weekly growth and weekend vs. weekday trends.

Last 30 Days - Daily - Monitoring monthly stability and retention.

Last 12 Months - Monthly - Analyzing long-term seasonal growth.

Lifetime - Monthly - Reviewing the entire history of the project.

Visual Indicators

1. The Line: Represents the total volume of API calls.
2. Tooltips: Hover over any point on the line to see the exact date/time and the total request count for that specific period.

3. Technical Details & Accuracy

1. Real-time Grouping: The backend dynamically re-aggregates data based on your selected range. For example, "Lifetime" views summarize by month to keep the chart clean, while "Daily" views summarize by hour for precision.
2. Elapsed Time Logic: To ensure accuracy, the Average RPM is calculated against the actual minutes passed in the current day (UTC), preventing skewed data in the early morning hours.
3. Theme Integration: The chart automatically adjusts its colors (gradients and grid lines) based on whether you are using Light Mode or Dark Mode in the CloudXLR Editor.

4. Troubleshooting

1. "No API call data available": This appears if the application is brand new or hasn't received traffic during the selected time period.
2. "Failed to load statistics": This typically indicates a temporary connection issue with the hosting server. Try closing and reopening the modal to refresh the bridge.