Architecture overview

Constellation OS combines a telemetry API with a browser console for fleet visualization and analysis.

Telemetry and reads

Applications publish records through the fleet agent or POST /telemetry. Records identify an entity, timestamp, tags, and fields. The telemetry contract defines accepted types and transport limits.

GET /topology returns the latest sample for each entity within a freshness window, with labeled simulation geometry available when observed data is absent. GET /topology/series returns numeric channels over a bounded time range. See Topology.

Predictions

GET /predictions returns forecasts from the SNR and demand models with model and feature-schema identifiers. The request reads available predictions and attempts to compute missing results. Check entity_errors alongside the returned items. The Predictions API describes parameters, response metadata, and per-link errors.

Console

The console renders assets, links, and analytics against a simulation clock. The assistant invokes analysis tools and can capture results into reports. See Console rendering and Determinism for analysis details.

Access and isolation

Console sign-in identifies a user. API keys and scopes authorize integration requests. Guest, Free, and Pro use shared infrastructure; tenant isolation is an Enterprise feature. See Security.

Authentication lockout, traffic limits, and retry behavior are defined in Errors and limits.