Struct UsageReport 

pub struct UsageReport {
    pub meter_event_name: String,
    pub customer_ref: String,
    pub value: u64,
    pub identifier: String,
    pub timestamp: OffsetDateTime,
}

A metered usage amount to report to the billing provider (Stripe Billing Meters). meter_event_name names a meter the venture configured; customer_ref is the provider customer id the meter maps the event to; value is the amount counted, in the meter’s own unit; identifier is the caller-chosen exactly-once key; timestamp is when the usage happened.

Fields

meter_event_name: String

customer_ref: String

value: u64

identifier: String

timestamp: OffsetDateTime

Implementations

impl UsageReport

pub fn hourly( subject: &str, meter_event_name: &str, customer_ref: &str, value: u64, at: OffsetDateTime, ) -> Self

A report for one UTC hour: timestamp is the start of the hour containing at, and identifier is {subject}:{meter_event_name}:{start unix seconds}. Every report for the same subject, meter and hour therefore carries the same identifier, so a retry, a re-delivery, or a concurrent drainer reports that window once. The identifier is only safe when the window’s value is final — report a window once it has closed (see docs/PAYMENTS.md); two reports for the same open hour with different values would collide, and the provider would count only the first. The next hour is a new window and a new identifier.

Trait Implementations

impl Clone for UsageReport

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for UsageReport

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Eq for UsageReport

impl PartialEq for UsageReport

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for UsageReport