Skip to main content

Module manager

Module manager 

Source
Expand description

Segment Manager

Manages the lifecycle of unified segments: creation, sealing, consolidation, and archival. Coordinates writes to growing segments and queries across all segments.

§Responsibilities

  • Route writes to the active growing segment
  • Auto-seal segments when thresholds are met
  • Coordinate queries across multiple segments
  • Paced consolidation of sealed segments (ADR 0073 §5)
  • Archive old segments to cold storage

Structs§

ConsolidationStats
Consolidation counters for one collection (ADR 0073 §5).
ManagerConfig
Configuration for the segment manager
ManagerStats
Manager statistics
PagedEntityCursor
Frozen base/overlay cursor for a lazy query source. The source generation remains pinned through the owned page cursor, not a manager topology lock.
SegmentManager
Segment manager for a collection
SegmentScanStats

Enums§

LifecycleEvent
Lifecycle events for monitoring

Constants§

CONSOLIDATION_ENTITIES_PER_TICK
Entities copied into the merged segment per maintenance tick.
CONSOLIDATION_FRAGMENTATION_RATIO
Fraction of a collection’s sealed bytes that consolidation would return to the budget (dead entity payloads plus the tombstone sets that bury them) before consolidation is worth its cost. See CONSOLIDATION_TOMBSTONE_RATIO on tunability.
CONSOLIDATION_TOMBSTONE_RATIO
Fraction of a collection’s sealed entities that must be tombstoned before consolidation is worth its cost.