Struct Ledger 

pub struct Ledger { /* private fields */ }

An append-only record of run costs.

Held in memory here; persisting it is the store crate’s job. Ordering is insertion order, which is also chronological as long as the Tower records a run when it finishes.

Implementations

impl Ledger

pub fn new() -> Self

Creates an empty ledger.

pub fn record(&mut self, cost: RunCost)

Records what a run cost.

pub fn entries(&self) -> impl Iterator<Item = &RunCost>

Every recorded run, oldest first.

pub fn len(&self) -> usize

Number of recorded runs.

pub fn is_empty(&self) -> bool

Returns true when nothing has been recorded.

pub fn total(&self) -> Summary

Totals over everything recorded.

pub fn summarise(&self, keep: impl Fn(&RunCost) -> bool) -> Summary

Totals over the runs matching keep.

pub fn for_itinerary(&self, itinerary: &ItineraryId) -> Summary

Totals for one chain.

pub fn since(&self, since: Timestamp) -> Summary

Totals for runs that finished at or after since.

pub fn by_agent(&self) -> BTreeMap<AgentName, Summary>

Totals per agent.

This is the breakdown that answers “what is expensive here”, which a single Fuel figure never could.

pub fn by_model(&self) -> BTreeMap<String, Summary>

Totals per model, skipping runs whose model was never reported.

pub fn by_pipeline(&self) -> BTreeMap<PipelineName, Summary>

Totals per workflow, skipping runs no pipeline began.

The breakdown a factory with several pipelines actually needs. Per-agent totals cannot answer “what does the nightly sweep cost” once an agent belongs to more than one workflow, and in a real factory most of them do.

pub fn top_agents(&self, limit: usize) -> Vec<(AgentName, Summary)>

The agents that cost the most, most expensive first.

pub fn prune(&mut self, before: Timestamp) -> usize

Drops entries older than before, returning how many were removed.

The ledger grows without bound otherwise, and an unattended factory runs for weeks.

Trait Implementations

impl Clone for Ledger

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 Ledger

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

Formats the value using the given formatter.

impl Default for Ledger

fn default() -> Self

Returns the “default value” for a type.