Billing and Usage
Monitor workspace credit consumption, track pipeline execution metrics, and understand your billing period.
Overview
The Billing and Usage page shows your Supaflow resource consumption. Track credits used, activities executed, compute hours, and rows processed across different date ranges.
What you can view:
- Current subscription status and billing period
- Credits consumed with cost estimates
- Visual usage chart (daily or monthly)
- Detailed usage table with all metrics
- CSV export for reporting
To access: Navigate to Usage (or Billing) in the sidebar.
Usage data updates every ~2 hours and displays in UTC timezone.
Metrics Cards
The page displays up to 4 metric cards showing your usage summary:
Subscription Card
Shows your current subscription information:
- Status badge - Active, Trial, Past Due, Canceled
- Plan name - Free, Pro, Enterprise
- Billing period - Current billing cycle dates
- Days left - Countdown to period end
- Credit price - Cost per credit (e.g., "$3/credit")
Credits Used Card
Shows total credits consumed in selected date range:
- Total credits - Credits consumed
- Estimated cost - Dollar amount based on credit price
- Average daily credits - Average per day in range
Example:
Credits Used
12.45 credits
$37.35 estimated • 1.78 avg/day
Period Breakdown Card
Shows when: Viewing current billing period
Displays breakdown of credits:
- Included credits - Credits included in your plan
- Overage credits - Credits beyond plan limit
- Total cost - Total cost for the period
Example:
Period Breakdown
Included: 50.00
Overage: 10.25
Total: $180.75
Compute Hours Card
Shows when: NOT viewing current billing period
Displays compute metrics:
- Total hours - Compute hours used
- Activities run - Count of activities executed
Trial Status Card
Shows when: Active trial period exists
Displays trial information:
- Trial end date - When trial expires
- Credits remaining - Remaining trial credits (warning if < 10)
Date Range Filters
Preset ranges:
- Last 7 days (default) - Past 7 days of usage
- Current month - Month-to-date usage
- Last month - Full previous month
Granularity options:
- Daily - Usage per day (default for ranges ≤ 31 days)
- Monthly - Usage per month (auto-selected for ranges > 31 days)
Usage Chart
Visual bar chart showing credit consumption over time:
- X-axis - Dates (daily or monthly)
- Y-axis - Credits consumed
- Blue bars - Credit usage per period
- Hover tooltip - Shows date, credits, and cost
Empty state: "No usage in this period" if no data available
Usage Details Table
Comprehensive table showing all usage data:
| Column | Description |
|---|---|
| Date | Day or month |
| Credits | Credits consumed |
| Cost (USD) | Dollar amount |
| Activities | Activities executed |
| Rows | Rows processed |
| Compute Hours | Total hours |
Table footer shows totals for all columns across the selected period.
Downloading Usage Data
To export:
- Click Download CSV button in Usage Details section
- File downloads with format:
usage_YYYY-MM-DD_to_YYYY-MM-DD.csv - Contains all columns from the table
CSV format:
date,credits,cost_usd,activities,rows,compute_hours
2025-12-15,2.45,7.35,12,125340,3.25
2025-12-16,3.12,9.36,18,203450,4.10
Use cases:
- Financial reporting and budgeting
- Chargeback allocation across teams
- Compliance and audit trails
How Credits Are Calculated
Supaflow features run on Supaflow-managed compute, billed in Compute-Hours.
What's a Compute-Hour?
- One Compute-Hour equals the resources of running a Small Compute Node for one hour
- Larger or smaller nodes scale usage proportionally
How it's measured:
- Usage tracked per second
- 60-second minimum per activity
- After first 60 seconds, rounded up to nearest second
Billing:
- 1 Compute-Hour = 1 Supaflow Credit
- All charges appear as a single line item per feature
Credits Per Hour by Agent Node Size
| Agent Node Size | Credits Per Hour |
|---|---|
| S (Small) | 1 |
| M (Medium) | 2 |
| L (Large) | 4 |
| XL (Extra Large) | 8 |
| 2XL (2X Large) | 16 |
Example Credit Calculations
- Pipeline on L (Large) node for 30 minutes = 2 credits
- Pipeline on S (Small) node for 2 hours = 2 credits
- Pipeline on M (Medium) node for 15 minutes = 0.5 credits
Most pipelines run on S nodes. Scale up to L nodes only when needed for performance.
Billing period:
- Included credits used first
- Overage credits charged at credit price (e.g., $3/credit)
Subscription Statuses
| Status | Meaning |
|---|---|
| Active | Subscription is current and billing normally |
| Trial | In trial period with trial credits |
| Past Due | Payment failed, update payment method immediately |
| Canceled | Subscription canceled, access may be limited |
Troubleshooting
No Usage Data Displayed
Problem: Chart and table show no data.
Solution:
- Check date range includes days with activity
- Try broader range (Current month or Last month)
- Verify pipelines ran (check Activities page)
- Usage updates every ~2 hours - recent activities may not appear yet
- Refresh page to fetch latest data
Credits Don't Match Expectations
Problem: Displayed credits seem too high or too low.
Solution:
- Review activity history in Activities page
- Check compute hours (high hours = high credits)
- Review row counts (large syncs consume more credits)
- Verify date range matches expected period
Period Breakdown Card Not Showing
Problem: Expected to see included/overage breakdown.
Solution:
- Period Breakdown only shows when viewing current billing period
- Check subscription card for billing period dates
- Switch date range to "Current month" to see period breakdown
CSV Download Not Working
Problem: Download button doesn't produce file.
Solution:
- Check browser allows downloads from Supaflow domain
- Disable popup blockers temporarily
- Try different browser
- Refresh and retry
Related Pages
- Activities - View detailed activity execution history
- Ingestion Pipelines - Manage pipelines consuming credits
- Schedules - Control when pipelines run (affects usage timing)
- Settings - Billing - Manage subscription and payment methods
Support
Need help? Contact us at support@supa-flow.io
Ask Claude