Skip to main content

Module finops_export

Module finops_export 

Source
Expand description

FinOps cost/savings export (GL #402): CloudZero CBF, Vantage, FOCUS CSV.

Turns the tamper-evident savings ledger into daily cost rows a FinOps platform can ingest for showback/chargeback. The ledger is the only source — every exported number is backed by a hash-chained event with the model price pinned at recording time (unit_price_per_m_usd), so a price change never rewrites history. No separate pricing table to maintain.

Savings representation (ADR, per platform):

  • CBF: lineitem/type=Discount rows with negative cost/cost — CBF’s documented mechanism for rate reductions.
  • FOCUS / Vantage: ChargeCategory=Credit rows with negative BilledCost — FOCUS’s category for granted reductions; keeps Usage spend clean for budgeting while savings stay drillable.

Modules§

aliases
Customer-side repo_hash -> readable project name mapping for FinOps showback (GL #668).
cbf
CloudZero Common Bill Format (CBF) serializer + AnyCost Stream uploader.
focus
FOCUS CSV serializer (FinOps Open Cost & Usage Specification).
vantage
Vantage Custom Provider serializer + uploader.

Structs§

DailyCostRow
One day × project × agent × model × tool aggregate from the ledger.
DateRange
Inclusive date-range filter, YYYY-MM-DD strings (lexicographic compare is correct for ISO dates).

Functions§

aggregate
Aggregate the ledger into daily rows. Events outside the range (or with a malformed timestamp) are skipped.