Skip to content

🧭 Architecture

This section is organized by responsibility to keep related topics together and to centralize segment internals in one place.

Monitoring (high level)

Runtime monitoring data comes from the Segment API surface on SegmentIndex.metricsSnapshot(). The management agent reads snapshots for /api/v1/report, and runtime-safe config overrides are applied in-memory only for the running process. Monitoring and management APIs do not directly access index files.

Monitoring runtime flow

Sections

  • General — cross-cutting format, integrity, recovery, limits, package layout, and glossary.
  • Monitoring — runtime monitoring bridge and management API contracts.
  • SegmentIndex — top-level index orchestration: read/write paths, caching, performance, and index concurrency.
  • Segment — central place for segment internals: file layout, delta cache, Bloom filter, sparse/scarce index, and segment lifecycle.
  • Registry — segment registry state machine, cache-entry model, and concurrent loading/unloading flows.