Reference Search docs

Metering

Metering turns replayable facts into usage evidence for showback, FinOps projections, dispute support, and ranking — not silent invoice invention.

Model

  1. Workloads and control plane emit usage-related facts (meter.UsageRecorded and related; also derived from run.*, deployment.*, resource.*, gen.*).
  2. A metering bus fans out to sinks (in-process, export, warehouse adapters).
  3. FinOps views (showback, anomalies, forecasts) are projections over facts.
  4. Humans and the FinOps Crew advise; breakers, tiers, and policy enforce.

Dimension matrix (required for M0 contracts)

DimensionWhy
TenantShowback isolation + support lookup
Workspace / ProjectCustomer grouping and policy reconciliation
EnvironmentProd vs preview vs test separation
Camp / BindleOperational and package grouping
Run / AgentRuntime + AI attribution and dispute lineage
TeamOrg-level reporting

Fact classes (examples)

ClassTypical familySensitive?
Control-plane operationdeployment.*No
Runtime computerun.*No
Storage / egressresource.*No
Generation rungen.*Often yes
Support adjustmentmeter.*Yes

Sensitive classes require redaction/retention rules before customer export.

  • Third-party price and free-tier facts are ranking input with source URL + human-checked date — never fabricated “vendor signed” attestations.
  • Free-tier headroom is never pooled across tenants.
  • Rotation is across providers, never across accounts within a provider to reset free tiers.
  • Metering/billing data stays tenant-scoped.

FinOps Crew

The FinOps operator agent reads metering projections, flags anomalies, and proposes commitment/move advice. It does not auto-spend or auto-destroy. See FinOps Crew.

Policy · FinOps role · Security