Struct CuTracker 

pub struct CuTracker { /* private fields */ }

Per-provider CU consumption tracker.

Implementations

impl CuTracker

pub fn new( url: impl Into<String>, cost_table: CuCostTable, config: CuBudgetConfig, ) -> Self

Create a new tracker for the given provider.

pub fn record(&self, method: &str)

Record CU consumption for a method call.

pub fn cost_for(&self, method: &str) -> u32

Get the CU cost that would be charged for this method.

pub fn consumed(&self) -> u64

Total CU consumed in the current period.

pub fn remaining(&self) -> u64

Remaining CU budget. Returns u64::MAX if unlimited.

pub fn usage_fraction(&self) -> f64

Usage fraction (0.0-1.0). Returns 0.0 if unlimited.

pub fn is_alert(&self) -> bool

Whether the budget alert threshold has been exceeded.

pub fn is_exhausted(&self) -> bool

Whether the budget is exhausted.

pub fn should_throttle(&self) -> bool

Whether we should throttle (near limit + throttling enabled).

pub fn reset(&self)

Reset the consumed counter (e.g. at start of new billing period).

pub fn per_method_usage(&self) -> HashMap<String, u64>

Get per-method breakdown of CU consumption.

pub fn url(&self) -> &str

Provider URL.

pub fn snapshot(&self) -> CuSnapshot

Produce a snapshot for reporting.