ns::stats::SQLiteHistory method history allocator (public)
<instance of ns::stats::SQLiteHistory> history allocator \ -from from -to to [ -limit limit ] [ -cursor cursor ]
Read compact process-wide allocator history from the configured owner server using one bounded sample SELECT. New samples provide stored projections; old rows without a projection are decoded once in this read. No topology loading or full-window payload rescan is performed. Preserve missing gauges as absent dictionary keys. Timestamps are epoch microseconds; instance and intervalSeconds allow callers to preserve restart boundaries and gaps. Reading does not collect or write samples. Coverage complete and windowExamined remain false: this projection does not certify window boundaries or absence of eviction/write failures. Use history query when full-window coverage assessment is required. Timings distinguish checkout, sample SQL read, decoding and total time.
- Switches:
- -from (required, integer)
- Inclusive lower bound in epoch seconds; must be nonnegative.
- -to (required, integer)
- Exclusive upper bound in epoch seconds; after from, at most 24 hours later and no later than now.
- -limit (optional, integer, defaults to
"10000")- Maximum compact records per page, 1..10000; default 10000.
- -cursor (optional, integer, defaults to
"0")- Nonnegative timestamp cursor in microseconds, default 0; pass nextCursor unchanged for continuation.
- Returns:
- Dictionary containing compact records (timestamp, instance, sampling.intervalSeconds and memory), more, nextCursor, legacyDecoded, timings in milliseconds and conservative coverage metadata.
- Testcases:
- No testcase defined.
![[i]](/resources/acs-subsite/ZoomIn16.gif)