Define the unit label for display purposes in reports and billing.Examples: “calls”, “GB”, “hours”, “tokens”
3
Configure Event Filtering (Optional)
Set up criteria to control which events are included in the meter.
Event filtering allows you to create sophisticated rules that determine which events contribute to your usage calculations. This is useful for excluding test events, filtering by user tiers, or focusing on specific actions.
Enable Event FilteringToggle Enable Event Filtering to activate conditional event processing.Choose Filter LogicSelect how multiple conditions are evaluated:
All conditions must be true for an event to be counted. Use this when you need events to meet multiple strict criteria simultaneously.Example: Count API calls where user_tier = "premium" AND endpoint = "/api/v2/users"
Setting Up Filter Conditions
1
Add Condition
Click Add condition to create a new filter rule.
2
Configure Property Key
Specify the property name from your event metadata.
3
Select Comparator
Choose from available operators:
equals - Exact match
not equals - Exclusion filter
greater than - Numeric comparison
greater than or equals - Numeric comparison (inclusive)
less than - Numeric comparison
less than or equals - Numeric comparison (inclusive)
contains - String contains substring
does not contain - String exclusion filter
4
Set Comparison Value
Set the target value for comparison.
5
Add Groups
Use Add Group to create additional condition groups for complex logic.
Filtered properties must be included in your event metadata for the conditions to work properly. Events missing required properties will be excluded from counting.
4
Create Meter
Review your meter configuration and click on Create Meter.
Your meter is now ready to receive and aggregate usage events.
Once you have created your meter, you need to link it to a product to enable usage-based billing. This process connects your meter’s usage data to pricing rules for customer billing.Linking meters to products establishes the connection between usage tracking and billing:
Products define pricing rules and billing behavior
Meters provide usage data for billing calculations
Multiple meters can be linked to a single product for complex billing scenarios
Transform your usage data into billable charges by properly configuring your product settings:
1
Choose Usage-Based Billing Product Type
Navigate to your product creation or editing page and select Usage-Based as the product type.
2
Select Associated Meter
Click on Associated Meter to open the meter selection panel from the side.This panel allows you to configure which meters will track usage for this product.
3
Add Your Meter
In the meter selection panel:
Click Add Meters to view available meters
Select the meter you created from the dropdown list
The selected meter will appear in your product configuration
4
Configure Price Per Unit
Set the pricing for each unit of usage tracked by your meter.
Number of units customers can consume at no charge before paid usage calculation starts.How it works:
Free threshold: 100 units
Price per unit: $0.50
Customer usage: 250 units
Calculation: (250 - 100) × 0.50=∗∗75.00** charged
Free thresholds are ideal for freemium models, trial periods, or providing customers with a base allowance included in their plan.
The free threshold applies to each billing cycle, giving customers fresh allowances monthly or according to your billing schedule.
6
Save Configuration
Review your meter and pricing configuration, then click Save Changes to finalize the setup.
Your product is now configured for usage-based billing and will automatically charge customers based on their measured consumption.
What happens next:
Usage events sent to your meter will be tracked and aggregated
Billing calculations will apply your pricing rules automatically
Customers will be charged based on actual consumption during each billing cycle
Remember that you can add up to 10 meters per product, enabling sophisticated usage tracking across multiple dimensions like API calls, storage, compute time, and custom metrics.
Monitor and analyze your usage-based billing data with comprehensive analytics dashboard. Track customer consumption patterns, meter performance, and billing trends to optimize your pricing strategy and understand usage behaviors.
The meter quantities chart visualizes usage trends over time with the following features:
Time-series visualization: Track usage patterns across days, weeks, or months
Multiple meter support: View data from different meters simultaneously
Trend analysis: Identify usage spikes, patterns, and growth trajectories
The chart automatically scales based on your usage volume and selected time range, providing clear visibility into both small fluctuations and major usage changes.
The events table provides a clear view of individual usage events with the following columns:
Event Name: The specific action or trigger that generated the usage event
Event ID: Unique identifier for each event instance
Customer ID: The customer associated with the event
Timestamp: When the event occurred
This view allows you to track and monitor individual usage events across your customer base, providing transparency into billing calculations and usage patterns.