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=Discountrows with negativecost/cost— CBF’s documented mechanism for rate reductions. - FOCUS / Vantage:
ChargeCategory=Creditrows with negativeBilledCost— FOCUS’s category for granted reductions; keeps Usage spend clean for budgeting while savings stay drillable.
Modules§
- aliases
- Customer-side
repo_hash -> readable project namemapping 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§
- Daily
Cost Row - One day × project × agent × model × tool aggregate from the ledger.
- Date
Range - Inclusive date-range filter,
YYYY-MM-DDstrings (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.