Graphorin API reference v0.15.1
Graphorin API reference / @graphorin/observability / / CostTrackerOptions
Interface: CostTrackerOptions
Defined in: packages/observability/src/cost/types.ts:124
Stable
Configuration shape for createCostTracker.
Properties
| Property | Modifier | Type | Description | Defined in |
|---|---|---|---|---|
budgets? | readonly | CostBudgets | - | packages/observability/src/cost/types.ts:125 |
onEviction? | readonly | (event) => void | Observer for retention evictions (dashboards / warnings). | packages/observability/src/cost/types.ts:147 |
onExceed? | readonly | CostBudgetExceededCallback | - | packages/observability/src/cost/types.ts:126 |
retention? | readonly | | false | { maxScopeEntries?: number; maxSpanEntries?: number; } | Memory bound for the tracker's internal maps. The tracker aggregates for the LIFETIME of the process - exactly the long-running-assistant scenario - so unbounded per-span / per-scope maps are a leak. When an insertion pushes a map past its limit the OLDEST entries (insertion order, not LRU) are evicted and onEviction fires per dropped id; usage() / usageForSpan() for an evicted id then report zero figures, and a late rollup to an evicted ancestor re-creates it from zero. Defaults to { maxSpanEntries: 10_000, maxScopeEntries: 10_000 }; pass false to restore the previous unbounded behaviour. | packages/observability/src/cost/types.ts:139 |