Session Manager

Overview

The Session Manager is the platform's state coordination service — responsible for managing session lifecycles, tile-based data partitioning, and the distributed scaling system that governs how real-time data is assigned across processing pods. It operates on a continuous monitoring cycle, tracking the health and capacity of every spatial tile in the system and coordinating the distribution of work across the service fleet.

While the name suggests simple user session management, the Session Manager's scope extends far deeper into the platform's architecture. It implements the core scaling logic that determines how spatial hexagonal tiles are assigned to data processing pods, how data volumes are tracked and balanced, and how the platform dynamically rebalances data ownership as conditions change. This makes it the operational backbone for the platform's distributed spatial processing — the mechanism that ensures real-time data across thousands of spatial regions is evenly and reliably distributed.

The Session Manager works in concert with the Experiment Manager for GraphQL-based coordination and uses Redis as both its state store and its inter-service communication channel.

Related Services

• Experiment Manager — Central GraphQL coordination hub
• Data Fusion — Consumes spatial tiles distributed by Session Manager
• Metrics Service — Receives spatial tile assignments
• Baseline Manager — Triggered by session lifecycle events
• Data Recorder — Subscribes to session-driven archival cycles
• Data Archiver — Periodic archival triggered via session lifecycle