Documentation Index
Fetch the complete documentation index at: https://docs.metronome.com/llms.txt
Use this file to discover all available pages before exploring further.
Rated events turn raw usage into priced, atomic revenue units by applying each customer’s pricing, products, and credits to every event. They show exactly how much each event costs, powering precise billing, revenue and margin analysis, and customer-facing spend transparency from a single, unified dataset.
Rated events map each transaction to customers, contracts, invoices, products, and any corresponding credit or commit applied to the event. A single usage event can produce multiple rated events—for example, if it triggers multiple billable metrics, applies to multiple products, or spans a commit boundary where part is covered and part is overage.
What you can do with rated events
- Aggregate spend by any dimensions included in the event properties (region, model, cluster, workspace, user, etc.)
- Aggregate spend by any time dimension (minute, hour, day, week, month)
- Combine property dimensions with time dimensions for custom breakdowns
Use cases
Finance
- Revenue recognition: Support complex performance obligation calculations, nth-of-month billing, and more.
- SOX audit: Provide auditors with complete end-to-end auditability from usage event through to paid invoice.
Engineering
- Margin optimization: Aggregate spend by compute cluster, region, resource type, or any infrastructure dimension.
GTM
- Customer spend tracking: Provide your customers with a breakdown of their spend by user, product, time period, or any other dimension.
Product
- Customer-of-customer tracking: Enable your customers to track spend by any dimension to support their own customers.
Finalized vs. draft rated events
Rated events follow the same draft vs. finalized paradigm as invoices.
Finalized rated events are delivered once, after the associated invoice is finalized. They represent a stable, immutable record of event rating for that billing period. The exported rated events roll up to the finalized invoice totals for usage-based products.
Draft rated events are delivered daily and include all usage events sent month-to-date. Because they cover an open billing period, draft rated events may change as usage and pricing are updated. Use draft rated events for near-real-time analytics and customer billing questions during an active period.
Metronome processes all events delivered in the last 30 days to identify errored events, and delivers them via data export. This rolling lookback window ensures that events received after finalization and backdated usage are captured in error reporting.
