Skip to main content
Custom usage tracking lets you assign usage aggregators directly to one customer, a set of customers or segments, or all customers. The metrics appear on customer pages without requiring a product or subscription and without affecting billing. Use it for metrics your team wants to watch at the account level, such as monthly active users, API calls, storage growth, seats provisioned, data processed, feature adoption, or plan-limit consumption.
Directly assigning an aggregator to customers without a subscription is available with the Customer Intelligence module. Standard usage-based billing does not include this direct assignment workflow.

​
Direct assignment compared with subscription usage

​
How it works

  1. You send usage events to Hyperline or load them through a connector.
  2. An aggregator turns those events into a metric.
  3. The aggregator’s Visibility setting assigns the metric to all customers or to selected customers and segments.
  4. Assigned metrics appear on those customer records, on the customer overview and in the Usage tab.
  5. Thresholds can alert your team when a customer’s value crosses a configured limit.
Custom usage tracking uses the same aggregator system as usage-based billing. If you need to create the underlying usage events first, start with Send usage data or Usage data with connectors.

​
Assign an aggregator to customers

  1. Go to Usage > Aggregators.
  2. Create a new aggregator or open an existing one.
  3. Configure the metric:
    • Name
    • Event type
    • Operation: Count, Sum, or SQL formula
    • Unit name
    • Optional filters
  4. In Visibility, choose where the metric should appear:
    • All customers
    • Specific segments and customers
    • No customers
  5. Set the default aggregation interval used to calculate the metric when no subscription provides a metering period.
  6. Choose the Displayed value:
    • Total: shows the total over the selected period.
    • Last complete period: shows the value from the last fully completed aggregation interval.
  7. Add thresholds if you want to trigger alerts.
  8. Click Save changes.

​
Customer assignment options

When using Specific segments and customers, add one or more customer or segment conditions. The metric appears on every customer record that matches at least one configured assignment. Choosing a visibility option only controls where the metric is monitored. It does not add the aggregator to a subscription or make the usage billable.

​
Where usage appears

Directly assigned aggregators appear in two places:
  • Customer overview: top usage metric cards summarize the most relevant customer-visible metrics.
  • Usage tab: the full list of visible usage cards includes charts, filters, thresholds, and event drill-downs.
For the full customer usage workflow, see Customer usage. In the Usage tab, you can change the period and grouping: Click Explore on a usage card to inspect the underlying events for that customer and metric.

​
Use cases

​
Thresholds

Thresholds let you alert on customer-level usage changes. A threshold can trigger when a value is greater than or equal to a limit, or less than or equal to a limit. Hyperline evaluates the threshold separately for each assigned customer, using the aggregator’s default aggregation interval when there is no subscription. Crossing a threshold sends the configured alert; it does not create a charge, change a subscription, or update an invoice. Thresholds are useful for:
  • Usage spikes that may indicate overages
  • Usage drops that may indicate churn risk
  • Low adoption after onboarding
  • Customers approaching contractual limits
  • Customers reaching usage levels that may justify an upsell or add-on discussion

Example 💡

You track monthly active users with an aggregator assigned to all customers. You set the displayed value to Last complete period and add a threshold for fewer than 20 active users. When a customer’s active user count drops below that limit, your team can review the account before renewal.

Example 💡

You track storage usage in GB and set a threshold at 800. When the threshold is crossed, the customer owner can review whether the account is ready for a higher tier or an additional storage package.