stella-ops.org/git.stella-ops.org
1
0
Fork 0
Code Issues Pull Requests Actions 2 Releases Wiki Activity
Files
main
git.stella-ops.org/docs/modules/timeline/README.md

1.4 KiB
Raw Permalink Blame History

Timeline

Unified event timeline service with HLC-ordered queries, critical path analysis, and deterministic replay.

Purpose

Timeline is the query and presentation layer for cross-service event correlation and auditing. It provides Hybrid Logical Clock (HLC)-ordered event queries, critical path analysis for latency diagnosis, and deterministic replay capabilities. Timeline reads events that have been indexed by the separate TimelineIndexer module, serving as the read-side of the event timeline infrastructure.

Quick Links

Status

Attribute Value
Maturity Production
Source src/Timeline/

Key Features

  • HLC-based causal event ordering
  • Correlation ID queries
  • Critical path analysis (latency stages)
  • Service-filtered timeline views
  • Event export and deterministic replay

Dependencies

Upstream

  • Eventing infrastructure (StellaOps.Eventing) - event storage and indexing
  • HybridLogicalClock library - causal timestamp generation and comparison

Downstream

  • Platform - timeline views for operator dashboards
  • CLI - event query commands
  • Web - timeline UI components
  • Replay - deterministic replay of event sequences

Note: Timeline is the query/presentation service. TimelineIndexer (separate module) handles event ingestion and indexing. They are independently deployable services.