Usage & Consumption Metering
Usage & Consumption Metering
Usage & Consumption Metering in GAAPx provides a high-throughput event ingestion and rating engine designed for usage-based SaaS, AI token consumption, API request metering, and storage pricing.
:::info SCREENSHOT PLACEHOLDER: Usage Telemetry & Rating Graph
Location in App: App > Billing > Usage & Metering > [Customer ID]
Visual Description: Real-time event consumption telemetry graph showing daily volume, prepaid drawdown burn rate, and projected end-of-month overage.
Recommended Dimensions: 1200 x 675
:::
Ingesting Telemetry Events
Send raw usage events via REST API (POST /v1/usage/events) or streaming webhooks:
{
"customer_id": "cust_99214",
"metric_name": "ai_inference_tokens",
"value": 1450000,
"timestamp": "2026-10-02T16:00:00Z",
"idempotency_key": "evt_ai_tok_9928123"
}
- Deduplication & Idempotency: Guarantees zero duplicate billing on network retries.
- Rating & Aggregation: Computes sum, max, average, or last-value consumption per billing cycle.
- Prepaid Balance Drawdown: Automatically burns against prepaid annual commitments before triggering overage invoices.