Regions and Usage

Purpose 

 Explains how regions (stamps) are represented and how usage flows from collection to rating and billing, including offline scenarios. 

 Regions (stamps) 

 

 A Region represents a source of usage. 

 Each Region has the endpoints/credentials required for usage collection and health checks. 

 Multiple Regions can be operated concurrently; billing can aggregate across regions. 

 Offline and disconnected operations 

 The CMS is designed to support disconnected environments. 

 Usage and rating can proceed without continuous internet access when inputs are available. 

 

 Usage processing pipeline 

 

 Collection: Pull raw usage records for a Region and time range. 

 Mapping: Normalize and map records to Subscriptions and SKUs. 

 Aggregation: Group by resource/meter and billing period with quantity roll-ups. 

 Rating: Apply prices, thresholds, credits, and currency rules. 

 Output: Persist rated usage and expose summaries for invoicing, analytics, and commissions.