Observability

How Starform collects, stores, and serves customer telemetry — and how the platform watches itself. It is one ClickHouse store per region: logs and metrics land together, tagged by tenant, read behind a server-side filter.

Start here — v2 is the current design

• v2 — ClickHouse only — the current design, and what to build. One store, one OpenTelemetry Collector, a straight line: Collect → Store → Read & query → Bootstrap.
• v1 — VictoriaMetrics + ClickHouse — the superseded two-store design, kept as the reference and decision trail.
• Platform Self-Monitoring — shared by both: a Grafana Alloy agent ships Starform's own component health to Grafana Cloud.

Why the design changed, with verified sources: specs/2026-07-07-single-store-clickhouse-telemetry-design.md.