Appearance
Usage
The Finance → Usage page is the query interface for usage aggregates. Use it to answer questions like "how much did Acme's PROD tenant consume last month?" without issuing an invoice.
Layout
Header, token-based search field with a collapsible date-range row, results table.
Token filters
The search field is token-aware. Use the syntax field:value to add filters. The field labels and option names are both searchable — typing customer:Acme and typing customer:abc123 (an ID) both work.
| Token | Cardinality | Notes |
|---|---|---|
customer:<name> | single | One customer scope. |
tenant:<name> | single | One tenant scope. |
env:<value> | multi | DEV / QA / UAT / STAGING / DEMO / PREPROD / PROD. |
meter:<name> | multi | Built-in and custom meters. |
granularity:<value> | single, required | hourly / daily / monthly. |
Negation is not supported in this field.
The result count is shown on the right.
Date range
Click Date range to expand a secondary row with From date and To date pickers. Clear by clicking Clear all in the toolbar.
Columns
| Column | Notes |
|---|---|
| Customer | Name (falls back to ID). |
| Tenant | Name (falls back to ID). |
| Meter | Display name. |
| Granularity | Hourly / Daily / Monthly badge. |
| Period | Date range, monospace. |
| Total Value | Raw aggregated usage in the period, formatted. |
| Billed Value | What the customer is charged for after plan limits, multipliers, and overrides are applied. Monospace, bold. |
| Peak | Maximum value in the period (per the meter's aggregation mode). |
| Computed | When the aggregation was computed. |
Total vs. Billed vs. Peak
- Total Value is the raw aggregate of measurements in the period.
- Billed Value is what would actually be invoiced. It applies the plan's included quantity, the customer's non-production multiplier, any per-tenant overrides, and credits. This is usually what you want.
- Peak is the maximum during the period — useful for snapshot-mode meters (e.g. peak concurrent users).
Notes
- Granularity is required. The query will not run until you pick one. Hourly is for spot checks; monthly is for invoice reconciliation; daily is the typical default.
- The page is a query tool. It does not modify anything — issuing an invoice happens on Customer Billing.
- For aggregates across many customers, Customer Finance exports a Usage Report CSV that may be a faster path.