Usage metrics
Contents
Customer Analytics is currently in beta and free to use. We're actively developing this feature and would love your feedback.
Usage metrics let you define global activity measurements and track them for each customer. Any event performed by your users – or data from your Data Warehouse tables – can be turned into usage metrics, so that you can understand their activity at a glance and identify expansion opportunities or churn risk.


Example usage metrics
Here are some examples of usage metrics for SaaS products:
| Metric | Events to match | Use case |
|---|---|---|
| API calls | api_request | Identify heavy API users for expansion |
| Feature adoption | feature_x_used | Track adoption of new features |
| Error rate | $exception | Spot customers hitting issues |
| Export usage | export_created | Find power users |
Data Warehouse metrics
You can also create usage metrics from Data Warehouse tables. This is useful when your usage or billing data lives outside of PostHog events – for example, in Stripe or your own database.
When creating a Data Warehouse metric, you specify:
- Table – The Data Warehouse table to query
- Timestamp column – The column used to filter rows by date range
- Group key column – The column used to match rows to customers
Each Data Warehouse metric is limited to a single table.
Data Warehouse usage metrics currently only render on group profiles, not person profiles.