Timeline Indexer
Timeline event indexing and query service.
Purpose
TimelineIndexer provides fast, indexed access to timeline events across all StellaOps services. It enables efficient querying of vulnerability history, scan timelines, and policy evaluation trails.
Quick Links
- Architecture - Technical design and implementation details
- Guides - Query and configuration guides
Status
| Attribute | Value |
|---|---|
| Maturity | Production |
| Last Reviewed | 2026-02-22 |
| Maintainer | Platform Guild |
Key Features
- Event Indexing: Index events from multiple StellaOps services
- Time-Range Queries: Efficient time-series queries with filtering
- Event Stream Integration: Consume from NATS/Valkey event streams
- PostgreSQL Storage: Time-series indexes for fast retrieval
- EF Core DAL: Database-first scaffolded model baseline with regeneration-safe partial overlays
- Compiled EF Model: Static compiled model module is used at runtime for context initialization
Dependencies
Upstream (this module depends on)
- PostgreSQL - Event storage with time-series indexes
- EF Core 10 + Npgsql provider - DAL and schema mapping
- NATS/Valkey - Event stream consumption
- Authority - Authentication
Downstream (modules that depend on this)
- Web Console - Timeline visualization
- CLI - Timeline queries
- ExportCenter - Timeline data exports
Configuration
timeline_indexer:
event_sources:
- nats://events.stellaops.local
retention_days: 365
Notes
TimelineIndexer indexes events; it does not generate them. Events are received from event streams published by other services.