Meters
Meters are the foundation of usage-based billing. They define what you're measuring and how events are aggregated into billable usage.
What is a Meter?
A Meter defines a specific usage metric you want to track and bill for. Each meter has:
- Event Name — a unique identifier used when sending usage events (e.g.,
api_call,storage_gb) - Aggregation Type — how individual events are combined into a total
- Value Key — which field in the event payload contains the numeric value
You can create multiple meters to track different usage dimensions for the same customer.
Aggregation Types
| Type | Description | Example |
|---|---|---|
| SUM | Adds up all event values. | Total GB transferred |
| COUNT | Counts the number of events. | Number of API calls |
| MAX | Takes the highest value in the period. | Peak concurrent users |
| UNIQUE_COUNT | Counts unique values of a field. | Active seats/users |
Managing Meters
From the meter detail page you can:
- View real-time usage graphs
- See connected subscriptions using this meter
- Browse recent events and their payloads
- Edit meter settings (name, description)
- Archive meters that are no longer needed