Advanced Usage Analytics
The Usage Dashboard provides comprehensive analytics to help you monitor and optimize your resource consumption across your FluidGrids workspace.
Health Score System
Each quota displays a health score from 0-100 to help you quickly assess your resource consumption status.
Health Status Levels
| Status | Score | Indicator | Meaning | Action |
|---|---|---|---|---|
| HEALTHY | 0-74% | Green | Normal usage | No action needed |
| WARNING | 75-89% | Yellow | Approaching limit | Monitor closely |
| CRITICAL | 90-99% | Orange | Near exhaustion | Upgrade soon |
| EXHAUSTED | 100% | Red | Limit reached | Upgrade now |
The health score system provides instant visual feedback, allowing you to prioritize which quotas need attention and plan your resource allocation effectively.
Dashboard Overview
The main usage dashboard shows comprehensive metrics across all your workspace resources.
Summary Metrics
At the top of the dashboard, you'll see aggregate information:
- Total Usage: Aggregate consumption across all quota types
- Total Quotas: Number of different quota types assigned to your account
- Active Quotas: Quotas currently being consumed
- Health Distribution: Visual breakdown showing how many quotas are in each status level
These summary metrics provide a bird's-eye view of your overall resource health, making it easy to spot trends and potential issues at a glance.
Quota Cards
Each quota is displayed in an individual card showing:
- Progress Bar: Visual usage percentage with color coding based on health status
- Current / Limit: Clear display (e.g., "50 / 100 API Calls")
- Usage Percentage: Exact percentage used (e.g., "50% used")
- Health Indicator: Color-coded status badge
- Actions: Quick access buttons to:
- View detailed usage history
- Track new usage events
- Manage quota limits
- Purchase add-ons to increase capacity
Usage Analytics Charts
The analytics section provides powerful visualizations to help you understand usage patterns and plan for the future.
Daily Usage Trend
The 30-day line chart shows consumption patterns over time:
- Interactive Chart: Hover over any point to see exact usage for that day
- Pattern Recognition: Identify spikes, dips, and trends in your consumption
- Anomaly Detection: Quickly spot unusual usage patterns that may indicate issues
- Color-Coded Lines: Each quota type displayed in a distinct color for easy comparison
- Date Range: View the last 30 days of usage data by default
Use Cases:
- Identify weekly or monthly usage cycles
- Detect unexpected spikes that may indicate issues
- Plan for peak usage periods
- Validate optimization efforts
Resource Breakdown
The pie chart provides a visual breakdown of usage distribution:
- Percentage View: See what portion of total usage each resource type represents
- Interactive Legend: Click on any resource to filter the view
- Exact Numbers: Hover to see precise usage amounts, not just percentages
- Color Coordination: Consistent color scheme across all charts
Use Cases:
- Understand which resources consume the most
- Identify optimization opportunities
- Balance resource allocation
- Plan targeted upgrades
Growth Predictions
AI-powered forecasting helps you plan ahead:
- Smart Forecasting: Machine learning algorithms predict usage for the next billing period
- Historical Patterns: Based on your actual usage history and trends
- Average Daily Usage: Calculated from recent consumption data
- Growth Rate Percentage: Shows how quickly your usage is increasing
- Upgrade Recommendations: Suggests when to consider increasing quotas
How Predictions Work:
- Analyzes your last 30-90 days of usage data
- Identifies patterns and trends using time-series analysis
- Factors in growth rate and seasonality
- Generates forecast with confidence intervals
- Updates predictions as new data becomes available
Use Cases:
- Plan budget for upcoming periods
- Schedule upgrades before hitting limits
- Avoid service disruptions
- Optimize purchasing decisions
Advanced Filtering
The usage dashboard includes powerful filtering capabilities to help you find exactly what you're looking for.
Search
Full-text search across all usage records:
- Description Text: Search by usage event descriptions
- Resource Identifier: Find specific resources by ID or name
- User Email: Filter by who triggered the usage
- Tag Values: Search within custom tags
Examples:
- Search "API" to find all API-related usage
- Search user email to see one team member's consumption
- Search project name to track specific project costs
Date Range
Flexible date filtering options:
Preset Ranges
- Last 7 days: Quick view of recent usage
- Last 30 days: Monthly overview (default)
- Last 90 days: Quarterly trends
Custom Ranges
- Custom Date Picker: Select any start and end date
- Current Month: Automatic month-to-date view
- Last Month: Previous complete billing period
- Specific Date Range: Choose exact dates for detailed analysis
Tips:
- Use preset ranges for quick analysis
- Custom ranges for detailed investigations
- Month views for billing reconciliation
- Longer ranges for trend analysis
Resource Type
Filter by specific resource categories:
- API Calls: REST and GraphQL API usage
- Storage: File storage and database consumption
- Bandwidth: Data transfer and network usage
- Users: Active user seats and licenses
- Projects: Project quotas and limits
- Compute Hours: Processing time and execution
- Multiple Selection: Select multiple types simultaneously
Use Cases:
- Focus on specific resource types
- Compare usage across categories
- Isolate problem areas
- Generate category-specific reports
Amount Range
Filter by usage magnitude:
- Minimum Amount Slider: Set lower threshold
- Maximum Amount Slider: Set upper threshold
- Dynamic Range: Automatically adjusts based on your data
- Magnitude Filtering: Find small or large usage events
Examples:
- Find all usage events over 100 units
- Identify small, frequent calls under 10 units
- Focus on mid-range usage patterns
- Exclude outliers from analysis
Tags
Custom tag filtering for advanced organization:
- Tag-Based Filtering: Filter by any custom tags you've applied
- Multiple Tag Selection: Apply multiple tag filters simultaneously
- Dynamic Tag Discovery: System shows all available tags from your usage data
- Tag Combinations: Use AND/OR logic for complex filters
Common Tag Use Cases:
- Filter by department or team
- Track specific projects or campaigns
- Categorize by environment (dev/staging/prod)
- Organize by client or customer
Usage Details Modal
Click "View Details" on any quota card to access comprehensive usage information.
Features
Paginated Records
- Configurable Page Size: Show 10, 25, 50, or 100 records per page
- Fast Navigation: Jump to any page quickly
- Total Count: See total number of records
- Performance: Optimized for large datasets
Sortable Columns
- Date: Sort chronologically or reverse chronologically
- Amount: Order by usage magnitude
- Description: Alphabetical sorting
- Resource Type: Group by category
- Custom Fields: Sort by any visible column
Individual Details
For each usage record, view:
- Timestamp: Exact date and time of usage
- Amount Used: Precise quantity consumed
- Description: Detailed explanation of the usage event
- Resource Type: Category and subcategory
- User: Who triggered the usage
- Tags: All associated metadata
- Context: Additional information like API endpoint, project, etc.
Export Functionality
- CSV Export: Download complete usage history
- Date Range Selection: Export specific time periods
- All Fields Included: Complete data in export file
- Large Dataset Support: Handles thousands of records efficiently
In-Modal Filtering
- Time-Based Filters: Further narrow down the date range
- Quick Search: Find specific records within the modal
- Real-Time Updates: Filters apply instantly
- Preserved Context: Returns to your filtered view when modal closes
Using the Details Modal
- Open Modal: Click "View Details" on any quota card
- Review Records: Browse paginated usage events
- Sort & Filter: Use column headers and filters to find what you need
- Analyze Patterns: Look for trends in the detailed view
- Export: Download data for offline analysis
- Close: Return to main dashboard
Usage Export
Export your complete usage data for external analysis, accounting, or record-keeping.
Export Process
- Click Export Button: Located in the usage dashboard header
- Select Date Range: Choose the time period to export
- Use preset ranges (7/30/90 days)
- Or select custom start and end dates
- Choose Format: Currently supports CSV format
- Future formats: JSON, Excel, PDF reports
- Download: Click download to get your file
- Verify: Check that the file contains expected data
Export Contents
Your CSV export includes:
- Date/Time: Timestamp of each usage event
- Resource Type: Category of resource used
- Amount: Quantity consumed
- Description: Detailed event description
- User: Who triggered the usage
- Tags: All custom tags
- Resource ID: Unique identifier
- Quota Name: Associated quota
- Status: Success/failure status
- Metadata: Additional context fields
Use Cases for Exports
Accounting & Finance
- Reconcile billing with actual usage
- Allocate costs across departments
- Generate client invoices
- Track budget vs. actual
Analysis & Optimization
- Import into Excel or data analysis tools
- Create custom reports and dashboards
- Identify optimization opportunities
- Perform trend analysis
Compliance & Auditing
- Maintain usage records for compliance
- Audit resource consumption
- Track user activity
- Generate regulatory reports
Planning & Forecasting
- Build custom forecasting models
- Capacity planning
- Budget planning
- Resource allocation optimization
Export Best Practices
- Regular Exports: Schedule monthly exports for record-keeping
- Backup Data: Keep historical exports as backups
- Large Datasets: For very large exports, consider smaller date ranges
- Automation: Use API for automated export processes (coming soon)
- Data Privacy: Handle exports securely, as they contain usage details
Tips for Effective Usage Monitoring
Daily Monitoring
- Quick Check: Review dashboard summary metrics daily
- Health Status: Look for any red or orange status indicators
- Trend Awareness: Notice any sudden changes in usage patterns
- Set Reminders: Use calendar reminders for regular reviews
Weekly Analysis
- Review Charts: Check weekly trends in the usage charts
- Compare Periods: Compare current week to previous weeks
- Growth Tracking: Monitor your growth rate predictions
- Team Review: Discuss usage patterns with your team
Monthly Optimization
- Deep Dive: Use detailed records for comprehensive analysis
- Export & Analyze: Download monthly data for offline analysis
- Pattern Recognition: Identify monthly cycles and trends
- Plan Upgrades: Use insights to plan subscription changes
Proactive Management
- Set Alerts: Monitor warning and critical status quotas closely
- Plan Ahead: Use growth predictions to schedule upgrades before hitting limits
- Optimize Usage: Identify and optimize inefficient resource usage
- Budget Planning: Use historical data for accurate budget forecasting
Next Steps
Now that you understand advanced usage analytics:
- Explore Your Dashboard: Log in and review your current usage metrics
- Set Up Monitoring: Establish a routine for checking your usage
- Use Filters: Experiment with different filters to gain insights
- Export Data: Download your usage history for analysis
- Plan Upgrades: Use growth predictions to plan future capacity needs
Related Documentation
- Monitoring Usage & Quotas - Basic usage monitoring concepts
- Managing Subscriptions - Upgrade your plan
- Common Errors and Solutions - Troubleshoot usage issues
Advanced usage analytics helps you stay ahead of resource needs and optimize your FluidGrids workspace costs.