Meters
A meter turns events into a billable quantity.
A meter turns events into a billable quantity.
POST /v1/meterswith{"key", "event_name", "aggregation", "field"}.GET /v1/meterslists your meters.
| Aggregation | Counts | Example |
|---|---|---|
count |
events | API calls |
sum |
a numeric field | GB stored (properties.gb) |
max |
the peak of a numeric field | peak concurrent seats |
unique |
distinct values of a field | monthly active users (properties.user_id) |
unique counts distinct values per customer per billing month. Late events
(arriving after the hour they belong to) are deduplicated by value; see the
count-distinct problem
for why exact distinct counts get expensive at scale.
Meter keys are lowercase with underscores and can’t be renamed. Changing a meter’s aggregation only affects events received afterwards.