14.15. Track Endpoint, Storage, and License Usage for Consumption-Based MSP Billing

Navigate to Billing > Tracking & Reports > Usage Tracking. Usage tracking records measurable quantities for services that bill based on consumption — for example, monitored endpoints, gigabytes of backup storage, or active licensed seats. These records feed directly into invoice calculations for usage-based and bucket contract lines.

When to Use Usage Tracking

Use this page when a client has contract lines with Usage billing or bucket / included-allowance overlays. The usage records you enter here provide the quantity data that the billing engine uses to calculate consumption charges and overage.

Typical MSP examples:

• Number of monitored endpoints in a given month.
• Gigabytes of cloud backup storage consumed.
• Active user seats on a managed Microsoft 365 or security platform.
• Security events ingested or workloads protected.

For a service to be eligible for usage tracking, it must have a Unit of Measure defined in the Service Catalog (see 14.3. Service Catalog).

Viewing Usage Records

The Usage Tracking page displays a table of recorded usage with columns for:

• Client
• Service
• Quantity
• Usage Date
• Contract Line
• Actions

You can narrow the list with two filters at the top of the table:

• Client — select a single client, or All Clients.
• Service — select a single usage service, or All Services.

There is no date range filter on this page. Use the Reset button to clear both filters.

Recording a Usage Entry

1. Click Add Usage.
2. Fill in the dialog. Fields appear in this order:
   • Client — the client the usage belongs to.
   • Service — the usage-based service. Only services with a Unit of Measure appear in this list.
   • Quantity — the measured amount in the service's unit of measure (for example, 1,250 for 1,250 GB).
   • Usage Date — the date the usage occurred or was measured. Defaults to today.
   • Comments (optional) — a short free-text note about the record (for example, the source RMM report).
   • Contract Line — appears once a client and service have both been chosen.
3. Click Save.

How the Contract Line is chosen

The Contract Line field is intelligent so that operators rarely have to think about it:

• If exactly one eligible contract line exists for the client and service, Alga auto-selects it.
• If multiple eligible lines exist and exactly one of them has a bucket overlay, Alga prefers that bucket line. This matches the common MSP pattern of consuming the included allowance first before billing overage.
• If multiple eligible lines exist with no clear preference, an info banner prompts the operator to choose. Selecting the wrong line can route the charge to the wrong invoice, so a warning is shown.
• If no eligible lines exist for the client and service, the usage routes to the system-managed default contract.

For a primer on contract line types, see 14.7. Contract Lines, Presets, and Examples. For setting up the lines themselves, see 14.6. Creating Client Contracts.

Editing and Deleting Usage Records

Each row in the table has an actions menu:

• Edit — re-open the record to correct quantity, date, comments, or contract line.
• Delete — remove the record (with confirmation).

Clicking a row also opens the edit dialog. Changes affect invoice calculations for the associated billing period as long as the period has not yet been invoiced — see 14.11. Understanding Service Periods and 14.12. Generating Invoices.

Bucket Consumption Charts

When a single client is selected in the Client filter, the page displays Bucket Hours Overview charts at the top of the screen. There is one chart per contract line that has a bucket overlay, showing remaining units in the current period only.

These charts are designed for at-a-glance monitoring — they show current capacity, not a historical trend. Use them to spot clients approaching or exceeding their included allowance before the period closes.

If a selected client has no active bucket overlays, the charts area is hidden.

Example: GreenLeaf Dental Group, Backup Storage Overage

GreenLeaf Dental Group has a managed backup contract with two lines:

• Managed Backup Platform Base Fee — fixed, $300.00 per month.
• Cloud Backup Storage — usage with a bucket overlay of 1,000 GB included, then $0.20 per GB.

At the end of the period, the operator records the actual storage usage:

1. Click Add Usage.
2. Client: GreenLeaf Dental Group.
3. Service: Cloud Backup Storage (GB).
4. Quantity: 1,250.
5. Usage Date: last day of the billing period.
6. Comments: "Veeam monthly storage report."
7. Contract Line: auto-selected, because the bucket overlay on Cloud Backup Storage is the only eligible line.
8. Save.

When the invoice is generated, GreenLeaf is billed:

Filtering the Usage Tracking page to GreenLeaf will also display a bucket chart showing 0 GB remaining (1,000 of 1,000 consumed plus 250 GB overage).

How Usage Feeds Into Invoicing

When invoices are generated for a period that contains usage-based or bucket lines:

1. The billing engine queries usage records dated within the billing period.
2. Quantities are aggregated per service and contract line.
3. Tiered pricing rules are applied if configured on the service.
4. For bucket overlays, only consumption above the included allowance is billed as overage.
5. The resulting charges appear as line items on the generated invoice.

Best Practices

• Record usage at a consistent point in the cycle — many MSPs do it on the last business day of the period or the first business day after.
• Spot-check the Bucket Hours Overview charts mid-period for clients trending toward overage so you can have a renewal or upsell conversation before the invoice arrives.
• If usage data lives in another system (RMM, backup console, cloud billing portal, identity provider), automate it via the API rather than transcribing by hand.
• When in doubt about which contract line to choose, default to the bucket line — Alga will only route overage to the usage line if the bucket is exhausted.