How andrealaforgia/kaleidoscope works
Kaleidoscope is an OpenTelemetry-compatible observability platform: applications send telemetry for durable storage, while operators manage platform configuration and users query and visualize signals. The README documents alerting, sampling, schema, anomaly detection, identity, cold storage, and profiles as platform capabilities, so these remain visible alongside the sampled ingest and read paths. Several feature implementations and their exact wiring were not sampled; those subsystems are shown without speculative call edges.
Main entry points: lib.rs Signal sinks · App.tsx Prism explorers · app.rs Ingest transport · main.rs OTLP gateway
Components 24
Ingest and processing
- OTLP gateway
crates/kaleidoscope-gateway/src/main.rs - Ingest transport
crates/aperture/src/app.rs - OTLP validation
crates/otlp-conformance-harness/src/lib.rs - Trace sampling
crates/sieve/src/lib.rs - Signal sinks
crates/aperture-storage-sink/src/lib.rs
Signal storage
- Log store
crates/lumen/src/lib.rs - Metric store
crates/pulse/src/lib.rs - Trace store
crates/ray/src/lib.rs - Profile store
crates/strata/src/lib.rs - Cold storage
crates/cinder/src/lib.rs
Query and visualization
- Metrics query API
crates/query-api/src/main.rs - Logs query API
crates/log-query-api/src/main.rs - Traces query API
crates/trace-query-api/src/main.rs - Prism explorers
apps/prism/src/app/App.tsx
Operations and alerts
- Alert evaluation
crates/beacon/src/lib.rs - Alert state
crates/beacon/src/state_store.rs - Rule change control
crates/loom/src/lib.rs
Platform capabilities
- Anomaly detection
crates/augur/src/lib.rs - Schema catalogue
crates/codex/src/catalogue.rs - Identity validation
crates/aegis/src/lib.rs - Resource identity
crates/spark/src/lib.rs
Other components
- Instrumented apps
- Analyst
- Platform operator
Connections 16
- Instrumented apps → OTLP gateway: send OTLP
- OTLP gateway → Ingest transport: starts ingest
- Ingest transport → OTLP validation: validates signals
- Ingest transport → Signal sinks: dispatches records
- Signal sinks → Log store: writes logs
- Signal sinks → Metric store: writes metrics
- Signal sinks → Trace store: writes traces
- Metrics query API → Metric store: reads metrics
- Logs query API → Log store: reads logs
- Traces query API → Trace store: reads traces
- Analyst → Prism explorers: explores signals
- Prism explorers → Metrics query API: queries metrics
- Prism explorers → Logs query API: queries logs
- Prism explorers → Traces query API: queries traces
- Platform operator → Rule change control: plans rule changes
- Alert evaluation → Alert state: persists rule state